Atomservices - ATOMSERV

The ATOMSERVICE (ATOMSERV) views display information about Atom service documents. An Atom service document is an XML document that describes the workspaces, collections and categories that exist on a server.

Supplied views

To access from the main menu, click:

CICS operations views > TCP/IP service operations views > Atomservices

Table 1. Views in the supplied Atomservice (ATOMSERV) view set
View Notes
Atomservice

EYUSTARTATOMSERV.DETAIL1

 Resource signature information about a selected Atom Service.
Atomservice

EYUSTARTATOMSERV.DETAILED

 Detailed information about a selected Atom Service.
Atomservice

EYUSTARTATOMSERV.DISABLE

 The ATOMSERVICE definition cannot be accessed by applications. An ATOMSERVICE definition has to be disabled before it can be reinstalled or discarded. If you disable an ATOMSERVICE resource definition, CICS returns an HTTP response to the Web client with a 503 (Service Unavailable) status code.
Atomservice

EYUSTARTATOMSERV.DISCARD

 Removes this ATOMSERVICE. The ATOMSERVICE must be disabled before it can be discarded.
Atomservice

EYUSTARTATOMSERV.ENABLE

 The ATOMSERVICE definition can be accessed by applications.
Atomservice

EYUSTARTATOMSERV.SET

 Set attributes according to values specified in input fields
Atomservice

EYUSTARTATOMSERV.TABULAR

 Tabular information about Atom Services.

Actions

Table 2. Actions available for ATOMSERV views
Action Description
DISABLE The ATOMSERVICE definition cannot be accessed by applications. An ATOMSERVICE definition has to be disabled before it can be reinstalled or discarded. If you disable an ATOMSERVICE resource definition, CICS returns an HTTP response to the Web client with a 503 (Service Unavailable) status code.
DISCARD Removes this ATOMSERVICE. The ATOMSERVICE must be disabled before it can be discarded.
ENABLE The ATOMSERVICE definition can be accessed by applications.
SET Set attributes according to values specified in input fields

Fields

Table 3. Fields in ATOMSERV views
Field Attribute name Description
Number of DELETE requests to the entry URL ATMSRVDELENT The number of HTTP DELETE requests sent to the entry URL.
Number of GET requests to the entry URL ATMSRVGETENT The number of HTTP GET requests sent to the entry URL.
Number of GET requests to the feed URL ATMSRVGETFED The number of HTTP GET requests sent to the feed URL.
Number of POST requests to the feed URL ATMSRVPSTFED The number of HTTP POST requests sent to the feed URL.
Number of PUT requests to the entry URL ATMSRVPUTENT The number of HTTP PUT requests sent to the entry URL.
Atom Service reference count ATMSRVREFCT Atom Service reference count
Atom Service reference disabled count ATMSRVREFDIS Atom Service reference disabled count
Atomtype ATOMTYPE 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.
BAS resource definition version BASDEFINEVER The BAS version number of this definition.
Bind file name BINDFILE The name of a UNIX file that contains WSBIND data describing the record layouts within the CICS resource.
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.
  • CREATESPI - The resource was last changed by an EXEC CICS CREATE command.
  • NOTAPPLIC - This is not applicable for this resource.
  • OVERRIDE - Resource was last changed by resource overrides.
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.
Configuration file name CONFIGFILE The name of a UNIX file that contains XML configuration data specifying the type of Atom document being returned.
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.
Enabled status ENABLESTATUS Indicates whether the ATOMSERV is enabled or not. Values are:
  • DISABLED
    • The ATOMSERV is not enabled.
  • ENABLED
    • The ATOMSERV is enabled.
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.
  • GRPLIST - The resource was installed by GRPLIST INSTALL.
  • BUNDLE - The resource was installed by a bundle deployment.
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.
Name NAME Specifies the name of this ATOMSERV. The name can be up to eight characters in length.
Resource name RESOURCENAME Displays the name of the CICS resource that provides the data for this Atom feed or collection. This field does not apply to an Atom service or category document.
Resource type RESOURCETYPE Displays the type of CICS resource that provides the data for this Atom feed or collection. This field does not apply to 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
    • This is not applicable for this resource.
URIMAP name URIMAPNAME Displays the 8-character URIMAP name that indicates the URI associated with this ATOMSERVICE definition.
XMLTRANSFORM name XMLTRANSNAME Displays the 32-character name of the XMLTRANSFORM resource associated with the ATOMSERVICE definition.