CEMT INQUIRE ATOMSERVICE

Retrieve information about ATOMSERVICE resource definitions.

In the CICS Explorer, the Atom services operations view provides a functional equivalent to this command.

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. You can start this transaction in two ways:
  • Type CEMT INQUIRE ATOMSERVICE. You obtain a display that lists the current status.
  • Type CEMT INQUIRE ATOMSERVICE followed by the attributes that are necessary to limit the range of information that you require. So, for example, if you enter CEMT INQUIRE ATOM FEED, the resulting display shows you the details of only those ATOMSERVICE resource definitions that are for Atom feed documents.
To enable or disable the ATOMSERVICE resource definition:
  • Enable or disable the BUNDLE resource if the Atom feed is deployed in a bundle. The resource signature of the ATOMSERVICE resource indicates how it was created.
  • Overtype your changes on the INQUIRE screen after tabbing to the appropriate field.
  • Use the CEMT SET ATOMSERVICE command.
ALL
Is the default. Information about all ATOMSERVICE definitions is displayed, unless you specify a selection of definitions to be queried.
(value)
Is the name (1 - 8 characters) of an installed ATOMSERVICE definition.

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 ATOMSERVICE definition.

CEMT INQUIRE ATOMSERVICE

Read syntax diagramSkip visual syntax diagramCEMT INQUIRE ATOMSERVICE ALL( value)CATEGORYCOLLECTIONFEEDSERVICEENABLEDDISABLEDFILEPROGRAMTSQUEUENOTAPPLICRESOURCENAME( value)CONFIGFILE( value)BINDFILE( value)INSTALLTIME( date time)INSTALLUSRID( value)BUNDLECREATESPICSDAPIGRPLISTDEFINESOURCE( value)DEFINETIME( date time)CHANGETIME( date time)CHANGEUSRID( value)CREATESPICSDAPICSDBATCHDREPAPICHANGEAGREL( value)URIMAP( value)XMLTRANSFORM( value)

Displayed fields

ATOMTYPE(value)
Displays the type of Atom document that is produced by this ATOMSERVICE definition. The possible values are as follows:
CATEGORY
An Atom category document, which lists the categories of documents in a collection.
COLLECTION
An Atom collection document, which contains a group of entry documents that can be edited.
FEED
An Atom feed document, which describes the metadata for a feed, and contains entry documents that provide data for the feed.
SERVICE
An Atom service document, which provides information about the collections of entry documents that are available on the server and can be added to or edited.
BINDFILE(value)
Displays the name and file path of the XML binding specified in this ATOMSERVICE resource definition. The XML binding is stored in z/OS® UNIX System Services, and it specifies the data structures used by the CICS resource that supplies the data for the Atom document that is returned for this resource definition. Service and category documents do not use an XML binding; if the value of ATOMTYPE is SERVICE or CATEGORY, this field is blank.
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.
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.
CONFIGFILE(value)
Displays the name and file path of the Atom configuration file specified in this ATOMSERVICE resource definition. The Atom configuration file is stored in z/OS UNIX System Services, and it contains XML that specifies metadata and content for the Atom document.
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.
ENABLESTATUS(value)
Displays the overall status of the ATOMSERVICE resource definition. The possible values are as follows:
ENABLED
The ATOMSERVICE resource definition is enabled.
DISABLED
The ATOMSERVICE resource definition is disabled. An ATOMSERVICE definition with this status can be discarded.
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.
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.
RESOURCENAME(value)
Displays the name of the CICS resource that provides the data for this Atom feed or collection. This field does not apply for an Atom service or category document.
RESOURCETYPE(value)
Displays the type of CICS resource that provides the data for this Atom feed or collection. This field does not apply for an Atom service or category document. The possible values are as follows:
FILE
A CICS file.
PROGRAM
A service routine, which is a CICS application program written to supply content for Atom entries.
TSQUEUE
A temporary storage queue.
NOTAPPLIC
If the value of ATOMTYPE is SERVICE or CATEGORY, the resource type is not applicable.
URIMAP
Displays the 8-character URIMAP name that indicates the URI associated with this ATOMSERVICE definition. If there is no dynamically generated URIMAP associated with this ATOMSERVICE definition, this field is empty.
XMLTRANSFORM
Displays the 32-character name of the XMLTRANSFORM resource associated with the ATOMSERVICE definition. If the value of ATOMTYPE is SERVICE or CATEGORY, this field is empty.