ATOMDEF Resource Table

A CICS® Definition that describes an Atom service, feed, collection, or category document served by CICS.

The First key field for this resource is NAME.

The Second key field for this resource is DEFVER.

The Third key field for this resource is CSDGROUP.

The following actions are supported:
ADDTOGRP
Add to resource group
The parameter data for the ADDTOGRP action is: 
   PARM('RESGROUP(resgroup).')

     where:

     resgroup = The name of a RESGROUP definition.
CSDCOPY
Copy the CICS CSD resource definition in a CSD group into an different CSD group.
The parameter data for the CSDCOPY action is described in Managing CICS definitions in the CSD.
CSDINSTALL
Install the CICS CSD resource definition in a CSD group into an active system.
The parameter data for the CSDINSTALL action is described in Managing CICS definitions in the CSD.
DISCARD
Discard an Atom service, feed, collection, or category document definition.
INSTALL
Install an Atom service, feed, collection, or category document definition.

The parameter data for the INSTALL action is described in Parameters for installing CICS definitions using BAS.

External resource name(CMCI)
CICSDefinitionAtomService
Object type
CICS Definition
Length
680
Usage
API, Batch Utility, WUI, CICS Management Client Interface(CMCI)
API view
No
CMAS context
No
SCOPE applies
No
Only query CMASs in workload
No
Copybook identifier
EYUt3838
CICS Commands subject to CICS Security
INQUIRE ATOMSERVICE
Unsupported CICS Releases
None
Table 1. Valid CPSM operations
Operations Actions Parameters Required
CREATE   CSD No
    RESGROUP(value) No
GET   CICSGRP(value) No
    CICSSYS(value) No
    CSDGROUP(value) No
    RESGROUP(value) No
REMOVE   CSD No
UPDATE   CSD No
PERFORM SET, PERFORM OBJECT ADDTOGRP RESGROUP(value) Yes
  CSDCOPY AS_RESOURCE(value) No
    DUPACTION(DUPERROR, DUPNOREPLACE, DUPREPLACE) No
    TO_CSDGROUP(value) No
  CSDINSTALL None N/A
  INSTALL FORCEINS(YES, NO) No
    MODE(value) No
    NOTIFY(NO, INACTIVE, RELEASE, FULL) No
    OVERRIDE No
    OVERTYPE(TARGET, RELATED, BOTH, NONE) No
    RELATED(value) No
    STATECHK(YES, NO) No
    TARGET(value) Yes
    USAGE(LOCAL) Yes
Table 2. ATOMDEF FEEDBACK error codes
Value Code Description
1 ATOMDEF_INV_DATA Attribute data invalid
2 ATOMDEF_REC_NOT_FOUND Requested resource not found
4 ATOMDEF_REC_EXISTS Resource already exists
5 ATOMDEF_REC_CHANGED Resource definition already changed
6 ATOMDEF_INV_RESTYPE Invalid resource type
7 ATOMDEF_INV_VER Invalid resource version
11 ATOMDEF_NON_MP Maintenance point CMAS not available
12 ATOMDEF_INV_CONTEXT Context not found
13 ATOMDEF_INCONSISTENT_SET Inconsistent set condition
14 ATOMDEF_INV_RESGROUP Resource group not found
21 ATOMDEF_INV_ACTION Invalid action
22 ATOMDEF_INV_RECADDR Invalid record address
23 ATOMDEF_INV_RECLEN Invalid record length
24 ATOMDEF_DIFF_VERSION Different version
25 ATOMDEF_EARLY_NAMELIST_END Early name list end
26 ATOMDEF_INV_NAMELIST Invalid name list
27 ATOMDEF_INV_NAME Invalid name
28 ATOMDEF_INV_MINNAME Invalid minor name
29 ATOMDEF_NOTIFY Notify
30 ATOMDEF_PARTIAL_INSTALL Partial install
31 ATOMDEF_NOTHING_INSTALLED Nothing installed
32 ATOMDEF_NO_TARGETS No targets
33 ATOMDEF_NO_RELATED No related systems
34 ATOMDEF_INV_TSCOPE Invalid target scope
35 ATOMDEF_INV_RSCOPE Invalid related scope
36 ATOMDEF_INV_USAGE Invalid usage
37 ATOMDEF_INV_MODE Invalid mode
38 ATOMDEF_INV_STATECHK Invalid state check
39 ATOMDEF_INV_FORCEINS Invalid force install
40 ATOMDEF_INV_NOTIFY Invalid notify
41 ATOMDEF_INV_OVERTYPE Invalid over type
42 ATOMDEF_INV_OVRBLOCK Invalid override block
43 ATOMDEF_INV_ORSTRING Invalid override string
44 ATOMDEF_INV_STRNGTERM Invalid string term
45 ATOMDEF_INV_EMBEDTERM Invalid embedded terminator
46 ATOMDEF_INV_ATTRIBUTE Invalid attribute
47 ATOMDEF_INV_LITERAL Invalid literal
48 ATOMDEF_INV_ORSTGNA Invalid override string
49 ATOMDEF_SCOPE_REQUIRED Scope required
50 ATOMDEF_USAGE_CONFLICT Usage conflict
51 ATOMDEF_NODEFS_SELECTED No definitions selected
52 ATOMDEF_MORE_THAN_1_RELSYS More than one related system
53 ATOMDEF_MISSING_RELSYSID Missing related system identifier
54 ATOMDEF_SCOPE_CONFLICT Scope conflict
56 ATOMDEF_BAD_BINDCONFLICT Bindfile option conflicts with Atomtype option.
57 ATOMDEF_BAD_BINDSETCONFLICT Bindfile should not be set with this Atomtype option.
58 ATOMDEF_BAD_RTYPECONFLICT Resourcetype option conflicts with Atomtype option.
59 ATOMDEF_BAD_RTYPESETCONFLICT Resourcetype should not be with this Atomtype option.
60 ATOMDEF_BAD_RNAMECONFLICT Resourcename option conflicts with Atomtype option.
61 ATOMDEF_BAD_RNAMESETCONFLICT Resourcename should not be set with this Atomtype option.
62 ATOMDEF_INVALID_CONFIGFILE Configfile invalid.
63 ATOMDEF_INV_CSDGROUP Invalid CSD group
64 ATOMDEF_REC_NOT_REMOVED Record not removed
65 ATOMDEF_INV_RESOURCE Invalid resource
66 ATOMDEF_INV_CICS_RESTYPE Invalid CICS restype
67 ATOMDEF_PARTIAL_ACTION Partial action
68 ATOMDEF_NOTHING_ACTIONED Nothing actioned
69 ATOMDEF_INV_BOTHTOAS TO_CSDGROUP and AS_RESOURCE are mutually exclusive
70 ATOMDEF_INV_NOTTOAS Either TO_CSDGROUP or AS_RESOURCE is required
71 ATOMDEF_BAD_RESNAMELEN Resourcename is too long for the Resourcetype specified.
72 ATOMDEF_CSD_ERROR CSD access error
Table 3. ATOMDEF resource table attributes
Name Datatype Source Len Req Sum Description Default Value Range Offset
 NAME-1  CHAR CPSM 8 Yes DIFF Name     37
 DEFVER-2  BINARY CPSM 1 Yes AVG Version 0 0-15 36
 CSDGROUP-3  CHAR CPSM 8 Yes DIFF CSD group     672
ATOMTYPE CVDAS CPSM 4 Yes MIN Atomtype FEED   52
ATOMTYPE Input/output valid values
  • FEED
  • SERVICE
  • COLLECTION
  • CATEGORY
BINDFILE CHAR CPSM 255 No DIFF Bind file name     76
CHANGEAGENT CVDAS CPSM 4 No LIKE Last modification agent     8
CHANGEAGENT Input/output valid values
  • DREPAPI
  • CSDAPI
  • CSDBATCH
CHANGEAGREL CHAR CPSM 4 No DIFF Last modification agent release     32
CHANGETIME DATETIME CPSM 8 Yes MAX Last modification time     0
CHANGEUSRID CHAR CPSM 8 No DIFF Last modification user ID     24
CONFIGFILE CHAR CPSM 255 Yes DIFF Configuration file name     331
CREATETIME DATETIME CPSM 8 Yes MAX Time created     16
DESCCODEPAGE BINARY CPSM 4 No DIFF Description code page 37 0-99999999 668
DESCRIPTION CHAR CPSM 58 No DIFF Description     610
RESOURCENAME CHAR CPSM 16 No DIFF Resource name     60
RESOURCETYPE CVDAS CPSM 4 Yes LIKE Resource type NOTAPPLIC   56
RESOURCETYPE Input/output valid values
  • FILE
  • PROGRAM
  • TSQUEUE
  • NOTAPPLIC
STATUS CVDAS CPSM 4 Yes LIKE Enabled status ENABLED   48
STATUS Input/output valid values
  • ENABLED
  • DISABLED
USERDATA1 CHAR CPSM 8 No DIFF User data area 1     586
USERDATA2 CHAR CPSM 8 No DIFF User data area 2     594
USERDATA3 CHAR CPSM 8 No DIFF User data area 3     602