Web services - WEBSERV

The WEBSERVICE (WEBSERV) views display information about the runtime environment for a CICS application programs deployed in a Web services setting, where the mapping between application data structure and SOAP messages has been generated using CICS-supplied tools.

Supplied views

To access from the main menu, click:

CICS operations views > TCP/IP service operations views > Web services

Table 1. Views in the supplied Web service (WEBSERV) view set
View Notes
Web service

EYUSTARTWEBSERV.DETAIL1

Detailed information about the resource signature.
Web service

EYUSTARTWEBSERV.DETAILED

Detailed information about a selected web service.
Web service

EYUSTARTWEBSERV.DISCARD

Discard a web service
Web service

EYUSTARTWEBSERV.SET

Set attributes according new values specified in input fields
Web service

EYUSTARTWEBSERV.TABULAR

Tabular information about web services.

Actions

Table 2. Actions available for WEBSERV views
Action Description
DISCARD Discard a web service
SET Set attributes according new values specified in input fields

Fields

Table 3. Fields in WEBSERV views
Field Attribute name Description
Fully-qualified archive file on zFS ARCHIVEFILE The archive file contains the wsdl document for this Web Service.
BAS resource definition version BASDEFINEVER The BAS version number of this definition.
The WSDL binding that this web service represents BINDING The WSDL binding represented by the Web service. This binding is one of (potentially) many that appear in the WSDL file.
Coded character set ID CCSID The name of the CCSID that is used to encode data between the application and the web service binding file at run time.
Last modification agent CHANGEAGENT The change agent identifier that made the last modification.
  • CSDAPI - The resource was last changed by a CEDA transaction, by the programmable interface to DFHEDAP or by an EXEC CICS CSD command.
  • CSDBATCH - The resource was last changed by a DFHCSDUP job.
  • DREPAPI - The resource was last changed by a CICSPlex SM BAS API command.
  • DREPBATCH - The resource was last changed by a CICSPlex SM utility.
  • DYNAMIC - The resource was last changed dynamically.
  • CREATESPI - The resource was last changed by an EXEC CICS CREATE command.
  • NOTAPPLIC - This is not applicable for this resource.
Last modification agent release CHANGEAGREL The CICS release level of the agent that made the last modification to the resource definition.
Last modification time CHANGETIME The local date and time when the definition was last changed.
Last modification user ID CHANGEUSRID The user ID that made the last modification to the resource definition.
Container used if the program input is CHANNEL CONTAINER The name of the container that holds the top level data when CICS passes data to the target application program in a channel.
Source of the resource definition DEFINESOURCE The source of the definition, depending on which agent made the last change.
Creation time DEFINETIME The local date and time when the resource definition record was created on DFHCSD or EYUDREP.
The endpoint URI of a remote web service ENDPOINT The URI specifying the location on the network (or endpoint) of the web service, as defined in the web service description.
Installation agent INSTALLAGENT The install agent identifier that made the installation.
  • CSDAPI - The resource was installed by a CEDA transaction, by the programmable interface to DFHEDAP or by an EXEC CICS CSD command.
  • CREATESPI - The resource was installed by an EXEC CICS CREATE command.
  • DYNAMIC - The resource was installed dynamically.
  • GRPLIST - The resource was installed by GRPLIST INSTALL.
  • BUNDLE - The resource was installed by a BUNDLE.
Installation time INSTALLTIME The local date and time when the definition was installed.
Installation user ID INSTALLUSRID The user ID that installed the resource definition.
Time the WSBind file on zFS was last updated LASTMODTIME The time, in milliseconds since 00:00 on January 1st 1900, that the deployed Web service binding file on zFS was last updated.
Mapping level used in WSBind file MAPPINGLEVEL The mapping level that was used when the WSBind file file was produced.
Mapping release number part of MAPLEVEL MAPPINGRNUM The release number for the mapping level that was used when the WSBind file was produced. The value of the release number is 0, 1, or 2.
Mapping version number part of MAPLEVEL MAPPINGVNUM The version number for the mapping level that was used when the WSBind file was produced. The value of the version number is 1, 2, 3 or 4.
Minimum runtime level required by WSBind file MINRUNLEVEL The minimum runtime level that is required to install the WEBSERVICE in CICS.
Minimum runtime release number part of MINRUNLVL MINRUNRNUM The release number for the minimum runtime level that is required to install the WEBSERVICE in CICS.
Minimum runtime version number part of MINRUNLVL MINRUNVNUM The version number for the minimum runtime level that is required to install the WEBSERVICE in CICS.
Name NAME The name of the web service.
Where the specified program expects input PGMINTERFACE For a service provider, indicates whether CICS passes data to the target application program in a COMMAREA or a channel.
Pipeline in which this web service is installed PIPELINE The name of the PIPELINE resource that contains this web service resource.
Name of the web service policy directory on zFS POLICYDIR This field is not available for use yet but is reserved for future development.
Application program to implement this web service PROGRAM The name of the target application program.
Web service status STATE The state of the web service. Values are:
  • Discarding
    • A Discard command has been issued for the web service. The web service is quiescing before being discarded. It is not accepting new work, but is allowing currently-executing work to complete.
  • Initing
    • The web service binding file, and the WSDL file, are being copied to the shelf.
  • Inservice
    • Resolution of the copy of the WSBind file on the shelf has succeeded, and the web service is usable.
  • Unusable
    • There is a problem with the web service binding file (WSBIND) for the resource.
  • Updating
    • An update request for a WEBSERVICE is pending.
  • Disabled
    • This state is only available for WEBSERVICE resources that are defined in a CICS bundle. The web service has completed quiescing and is not accepting new work.
  • Disabling
    • This state is only available for WEBSERVICE resources that are defined in a CICS bundle. The web service is quiescing. It is not accepting new work, but is allowing currently-executing work to complete.
Dynamically installed URI map for this web service URIMAP The name of a dynamically installed URIMAP resource definition, if there is one that is associated with this web service.
Perform validation of SOAP messages against WSDL VALIDATIONST Indicates whether full validation of SOAP messages against the corresponding schema in the web service description is specified.
  • VALIDATION - Full validation is enabled.
  • NOVALIDATION - Full validation is disabled.
Number of times web service used WEBUSECOUNT The number of times this web service was used to process a web service request.
Fully-qualified WSBind file on zFS WSBIND The file name of the web service binding file associated with the web service resource.
Fully-qualified WSDL file on zFS WSDLFILE The file name of the web service description (WSDL) file associated with the web service resource.
Current web service direct mode XOP status XOPDIRECTST Indicates whether the web service is currently able to handle XOP documents in direct mode. The values are:
  • NOXOPDIRECT - The web service cannot currently handle XOP documents and binary attachments directly. This is true when the web service implementation does not support the direct handling of XOP documents and binary attachments, or web service validation is switched on.
  • XOPDIRECT - The web service can currently handle XOP documents and binary attachments directly. This is true when the web service implementation supports the direct handling of XOP documents and web service validation is not switched.
Web service XOP capability XOPSUPPORTST Indicates whether the web service implementation is capable of handling XOP documents and binary attachments in direct mode. The values are:
  • NOXOPSUPPORT - The web service implementation does not support the direct handling of XOP documents and binary attachments.
  • XOPSUPPORT - The web service implementation supports the direct handling of XOP documents and binary attachments. This is true for any web services that are generated and deployed using the web services assistant.


eyua3w1.html | Timestamp icon Last updated: Sunday, 4 June 2017