Atomservice definitions - ATOMDEF

The Atomservice definition (ATOMDEF) views display information about BAS resource definitions for Atom service. Atomservice resource definitions define an Atom service, feed, collection or category document, and identifies the Atom configuration file, CICS resource or application program, and Atom binding file that are used to supply the data for the feed. You also need URIMAP resource definitions to handle incoming client requests and point to appropriate Atomservice resource definitions.

Supplied views

To access from the main menu, click:

Administration views > CICS resource definitions > Atomservice definitions

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

EYUSTARTATOMDEF.ADDTOGRP

Add one or more ATOMSERV definitions to a resource group.
Atomservice definitions

EYUSTARTATOMDEF.CREATE

Create a ATOMSERV definition and add it to the data repository.
Atomservice definitions

EYUSTARTATOMDEF.DETAILED

Detailed information about a selected Atom Service definition.
Atomservice definitions

EYUSTARTATOMDEF.INSTALL

Install a ATOMSERV definition in an active system.
Atomservice definitions

EYUSTARTATOMDEF.REMOVE

Remove a ATOMSERV definition from the data repository.
Atomservice definitions

EYUSTARTATOMDEF.TABULAR

Tabular information about all Atom Service definitions for the current context.

Actions

Table 2. Actions available for ATOMDEF views
Action Description
ADDTOGRP Add one or more ATOMSERV definitions to a resource group.
CREATE Create a ATOMSERV definition and add it to the data repository.
CSDCOPY Copy a CICS CSD resource definition.
CSDINSTALL Install a CICS CSD resource definition into an active system.
INSTALL Install a ATOMSERV definition in an active system.
REMOVE Remove a ATOMSERV definition from the data repository.
UPDATE Update a ATOMSERV definition in the data repository.

Fields

Table 3. Fields in ATOMDEF views
Field Attribute name Description
Atomtype ATOMTYPE The type of Atom document to be returned. It can be Feed, Service, Collection or Category. Entry documents are always specified within Feed or Collection documents. Values are:
  • FEED
    • The ATOMSERV inquire request will return feed data.
  • SERVICE
    • The ATOMSERV inquire request will return service data.
  • COLLECTION
    • The ATOMSERV inquire request will return collection data.
  • CATEGORY
    • The ATOMSERV inquire request will return category data.
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.
  • DREPAPI - Resource was last changed by a SM API command.
Last modification agent release CHANGEAGREL The CICS release level of the agent that made the last modification.
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.
Configuration file name CONFIGFILE The name of a UNIX file that contains XML configuration data specifying the type of Atom document being returned.
Time created CREATETIME The local date and time when the definition was created.
CSD group CSDGROUP The name of the CSD group for this CICS resource definition. This field is ignored for BAS definitions.
Version DEFVER The version number of the BAS resource definition, from 1 to 15. This field is ignored for CICS CSD resource definitions.
Description code page DESCCODEPAGE The code page of the description field. This field is ignored for CICS CSD resource definitions.
Description DESCRIPTION A description of the Atom service definition.
Name NAME The 8-character name of the ATOMSERV resource.
Resource name RESOURCENAME The name of the CICS resource that provides the data for an Atom feed or collection. A mixed case name is acceptable if the RESOURCETYPE is TSQUEUE. If the RESOURCETYPE is FILE or PROGRAM then CICSPlex SM changes any lowercase characters to uppercase.
Resource type RESOURCETYPE Indicates the type of CICS resource that holds the data for an Atom feed or collection. Values are:
  • FILE
    • The named resource is a file.
  • PROGRAM
    • The named resource is a program.
  • TSQUEUE
    • The named resource is a TSQ.
  • NOTAPPLIC
    • This is not applicable for this resource.
Enabled status STATUS Indicates whether the ATOMSERV is enabled or not. Values are:
  • DISABLED
    • The ATOMSERV is not enabled.
  • ENABLED
    • The ATOMSERV is enabled.
User data area 1 USERDATA1 Optional string of up to 8 characters that allows you to provide additional site-specific data related to the BAS resource definition. This field is ignored for CICS CSD resource definitions.
User data area 2 USERDATA2 Optional string of up to 8 characters that allows you to provide additional site-specific data related to the BAS resource definition. This field is ignored for CICS CSD resource definitions.
User data area 3 USERDATA3 Optional string of up to 8 characters that allows you to provide additional site-specific data related to the BAS resource definition. This field is ignored for CICS CSD resource definitions.


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