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

Press the Clear key to clear the screen. Start this transaction in one of two ways:
  • 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 enter CEMT I WEBSERVICE EN, the resulting display shows you the details of only those resource types that are enabled.
To change various attributes:
  • 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.

CEMT INQUIRE WEBSERVICE

Read syntax diagramSkip visual syntax diagramCEMT INQUIRE WEBSERVICE ALL( value) PIPELINE( value)VALIDATIONDISABLEDDISABLEDDISABLINGDISCARDINGINITINGINSERVICEUNUSABLEUPDATINGCCSID( value)URIMAP( value)PROGRAM( value)CHANNELCOMMAREANOXOPSUPPORTXOPSUPPORTNOXOPDIRECTXOPDIRECTMAPPINGLEVEL( value)MINRUNLEVEL( value)CONTAINER( value)WSDLFILE( value)ARCHIVEFILE( value)WSBIND( value)ENDPOINT( value)BINDING( value)LASTMODTIME( value)MAPPINGRNUM( value)MAPPINGVNUM( value)MINRUNRNUM( value)MINRUNVNUM( value)INSTALLTIME( date time)INSTALLUSRID( value)BUNDLECREATESPICSDAPIDYNAMICGRPLISTDEFINESOURCE( value)DEFINETIME( date time)CHANGETIME( date time)CHANGEUSRID( value)CREATESPICSDAPICSDBATCHDREPAPIDYNAMICCHANGEAGREL( value)

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:
Start of changeDISABLEDEnd of change
Start of changeThis 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.End of change
Start of changeDISABLINGEnd of change
Start of changeThis 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.End of change
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.
Start of changeUPDATINGEnd of change
Start of changeAn update request for a WEBSERVICE is pending.End of change
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.