CEMT INQUIRE WEBSERVICE
Retrieve information about an installed WEBSERVICE resource.
In the CICS Explorer, the Web services operations view provides a functional equivalent to this command.
Description
Use the CEMT INQUIRE WEBSERVICE command to retrieve information about an installed WEBSERVICE resource.
The resource signature
You can use this command to display the resource signature fields. You can use these fields to manage resources by capturing details of when the resource was defined, installed, and last changed. For more information, see Auditing resources. The resource signature fields are CHANGEAGENT, CHANGEAGREL, CHANGETIME, CHANGEUSRID, DEFINESOURCE, DEFINETIME, INSTALLAGENT, INSTALLTIME, and INSTALLUSRID. See Summary of the resource signature field values for detailed information about the content of the resource signature fields.
Input
- Type
CEMT INQUIRE WEBSERVICE
. You get a screen that lists the current status. - Type
CEMT INQUIRE WEBSERVICE
followed by a series of other attributes to limit the range of information that you require. So, for example, if you enterCEMT I WEBSERVICE EN
, the resulting display shows you the details of only those resource types that are enabled.
- Overtype your changes on the INQUIRE screen after tabbing to the appropriate field.
- Use the CEMT SET WEBSERVICE command.
- ALL
- Is the default. Information about all WEBSERVICE resources is displayed, unless you specify a selection of web services to be queried.
- (value)
- Is the 1 - 32 character name of an installed WEBSERVICE definition. The resource is up to 8 characters if installed using RDO and up to 32 characters if installed dynamically.
If you place the cursor against a specific entry in the list and press Enter, CICS® displays an expanded format of all the attributes for the specified WEBSERVICE resource.
Displayed fields
- ARCHIVEFILE(value)
- Displays the name and location (1-255 characters) of the archive that is associated with the web service. The archive contains one or more WSDL files. The name can be up to 255 characters long.
- BINDING(value)
- Displays the WSDL binding represented by the WEBSERVICE resource. This binding is one of (potentially) many that appear in the WEBSERVICE configuration file associated with the WEBSERVICE resource. The name can be up to 255 characters long.
- CCSID(value)
- Displays the CCSID that is used to encode data between the application program and the web service binding file at run time. This value is set using the optional CCSID parameter in the web services assistant when the web service binding file was generated. If the value is 0, the default CCSID for the CICS region that is specified by the LOCALCCSID system initialization parameter is used.
- CHANGEAGENT(value)
- Displays a value that identifies the agent that made the last change to the resource definition.
You cannot use CEMT to filter on some of these values because they are duplicated. The possible
values are as follows:
- CREATESPI
- The resource definition was last changed by an EXEC CICS CREATE command.
- CSDAPI
- The resource definition was last changed by a CEDA transaction or the programmable interface to DFHEDAP.
- CSDBATCH
- The resource definition was last changed by a DFHCSDUP job.
- DREPAPI
- The resource definition was last changed by a CICSPlex SM BAS API command.
- DYNAMIC
- The resource definition was last changed by a PIPELINE scan.
- CHANGEAGREL(value)
- Displays the 4-digit number of the CICS release that was running when the resource definition was last changed.
- CHANGETIME(date time)
- Displays the date and time when the resource definition was last changed. The format of the date depends on the value that you selected for the DATFORM system initialization parameter for your CICS region. The format of the time is hh:mm:ss.
- CHANGEUSRID(value)
- Displays the 8-character user ID that ran the change agent.
- CONTAINER(value)
- Displays the name of the container used if PGMINTERFACE returns a value of CHANNEL. The name can be up to 16 characters long.
- DEFINESOURCE(value)
- Displays the source of the resource definition. The DEFINESOURCE value depends on the CHANGEAGENT option. For details, see Summary of the resource signature field values.
- DEFINETIME(date time)
- Displays the date and time when the resource was created. The format of the date depends on the value that you selected for the DATFORM system initialization parameter for your CICS region. The format of the time is hh:mm:ss.
- ENDPOINT(value)
- Displays the endpoint URI of a remote WEBSERVICE resource. This endpoint URI is specified in the WSDL file for a remote web service. If a CICS application program is the service provider, the ENDPOINT is empty. The URI can be up to 255 characters long.
- INSTALLAGENT(value)
- Displays a value that identifies the agent that installed the resource. You cannot use CEMT to
filter on some of these values because they are duplicated. The possible values are as follows:
- BUNDLE
- The resource was installed by a bundle deployment.
- CREATESPI
- The resource was installed by an EXEC CICS CREATE command.
- CSDAPI
- The resource was installed by a CEDA transaction or the programmable interface to DFHEDAP.
- DYNAMIC
- The resource was installed by using a PIPELINE scan.
- GRPLIST
- The resource was installed by GRPLIST INSTALL.
- INSTALLTIME(date time)
- Displays the date and time when the resource was installed. The format of the date depends on the value that you selected for the DATFORM system initialization parameter for your CICS region. The format of the time is hh:mm:ss.
- INSTALLUSRID(value)
- Displays the 8-character user ID that installed the resource.
- LASTMODTIME(value)
- Displays
the time when the deployed WSBind file on z/OS® UNIX was
last updated. The last-modified-time can be used to determine whether CICS has
refreshed itself after an update is made to a WSBind file in the pickup
directory.
For dynamically installed web services (those installed by the CICS scanning mechanism), the value of LASTMODTIME is the timestamp of the z/OS UNIX file pointed to by the WSBind definition, at the time the web service definition was last installed or updated. For statically-installed web services (those installed from a CSD or by CREATE WEBSERVICE), the value of LASTMODTIME is the timestamp of the WSBind z/OS UNIX file pointed to by the WEBSERVICE definition, at the time the WEBSERVICE resource was installed.
If you issue an INQUIRE WEBSERVICE command before a newly-installed or updated web service has fully initialized, the returned LASTMODTIME value is zero.
- MAPPINGLEVEL(value)
- Displays the mapping level that is used to convert data between language structures and web service description (WSDL) documents. The value of the mapping level is 1.0, 1.1, 1.2, 2.0, or 2.1. The default is to use a mapping level of 1.0.
- MINRUNLEVEL(value)
- Displays the minimum runtime level that is required to run the web service in CICS. The value of the runtime level is 1.0, 1.1, 1.2, 2.0, or 2.1.
- PGMINTERFACE
- Displays
an indication of whether the CICS program that implements the
web service expects input in a channel or in a commarea:
- CHANNEL
- The program expects input in a channel.
- COMMAREA
- The program expects input in a commarea.
- PIPELINE(value)
- Displays the name of the PIPELINE in which the web service is installed; that is, the name of the PIPELINE resource that contains this web service resource. The name can be up to 8 characters long.
- PROGRAM(value)
- Displays the name of a CICS program that implements the web service. If this WEBSERVICE resource represents a remote web service (that is, CICS is not the service provider), PROGRAM is empty. The name can be up to 8 characters long.
- STATE(value)
- Displays the state of the WEBSERVICE resource:
- 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. When the web service is no longer in use, the state of the WEBSERVICE resource changes to DISABLED.
- DISCARDING
- A DISCARD command has been issued for the WEBSERVICE resource. The web service is quiescing. It is not accepting new work, but is allowing currently-executing work to complete. When the web service is no longer in use, discarding is complete for the WEBSERVICE resource.
- 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, and the web service is unusable.
- UPDATING
- An update request for a WEBSERVICE is pending.
- URIMAP(value)
- Displays the name of a dynamically installed URIMAP definition, if one is associated with this WEBSERVICE resource. If the WEBSERVICE resource was not installed by performing the SCAN function on a PIPELINE resource, or if the WEBSERVICE resource represents a remote web service, the URIMAP definition is empty. The name can be up to 8 characters long.
- VALIDATIONST(value)
- Indicates
whether full validation of SOAP messages is currently enabled for
this WEBSERVICE resource:
- VALIDATION
- Full validation is enabled.
- DISABLED
- Full validation is disabled.
- WSBIND(value)
- Displays the name of the web service binding file. The name can be up to 255 characters long.
- WSDLFILE(value)
- Displays the name of the web service description file associated with the WEBSERVICE resource. The name can be up to 255 characters long.
- XOPDIRECTST(value)
- Indicates
whether the web service can handle XOP documents and binary attachments
in direct mode:
- NOXOPDIRECT
- The web service cannot handle XOP documents and binary attachments in direct mode, either because validation is switched on for the web service or because the web service implementation does not support the handling of XOP documents and binary attachments. Compatibility mode is used instead.
- XOPDIRECT
- The web service can handle XOP documents and binary attachments in direct mode.
- XOPSUPPORTST(value)
- Indicates
whether the web service implementation can handle XOP documents and
binary attachments.
- NOXOPSUPPORT
- The web service implementation cannot handle XOP documents and binary attachments.
- XOPSUPPORT
- The web service implementation can handle XOP documents and binary attachments. This case is true for any CICS-generated web service created by a level of CICS that supports MTOM/XOP.