Resource signature field values
The resource signature fields capture when the resource is defined, installed, and last changed.
Resource signature fields lists the fields and the possible values for each one. Table 1 shows the combination of values that are returned, depending how the resource is defined.
Resource signature fields
- DEFINESOURCE
- The source of the resource definition. The DEFINESOURCE value depends on the CHANGEAGENT.
- DEFINETIME
- The time when the resource definition was created using the DEFINE, USERDEFINE, COPY, MOVE, or RENAME commands. When you alter an existing resource by using the ALTER command, the value specified by DEFINETIME does not change. On CEDA panels, the date is displayed in the format that you specified in the DATFORM system initialization parameter.
- CHANGEAGENT
- How the resource was defined or last modified:
- AUTOINSTALL
- From autoinstall
- CSDAPI
- From CEDA, the programmable interface to DFHEDAP, or EXEC CICS® CSD command
- CSDBATCH
- DFHCSDUP
- DREPAPI
- From CICSPlex® SM BAS API command
- DYNAMIC
-
- A PIPELINE scan (URIMAP or WEBSERVICE).
- CICS web template management, using DFHWBTL or DFHWBBMS (DOCTEMPLATE).
- The installation of a DB2ENTRY resource definition with transaction ID specified (DB2TRAN).
- The installation of an ATOMSERVICE resource definition with XSDBIND specified (XMLTRANSFORM).
- The installation of an MQCONN resource definition with INITQNAME specified (MQINI).
- OVERRIDE
- From a resource overrides file during installation. The CSD file or the CICSPlex SM EYUDREP data repository are unchanged.
- SYSTEM
- From CICS or CICSPlex SM system
- TABLE
- From a table definition
- CHANGEAGREL
- The level of the CICS system used for the definition of, or last modification to, the resource definition. This is a 4-digit identifier: for example, 0760 is the identifier for CICS TS for z/OS®, beta
- CHANGETIME
- The time when the resource definition was last modified. When the resource is first defined, the CHANGETIME value is identical to the DEFINETIME value. On CEDA panels, the date is displayed in the format that you specified in the DATFORM system initialization parameter.
- CHANGEUSRID
- The ID of the user who defined or last modified the resource definition. For the CICSPlex SM BAS resource definitions in the EYUDREP data repository, when CICS security is active the CHANGEUSRID field contains the user ID that made the last modification to the resource definition. When CICS security is not active, the CHANGEUSRID field contains blanks.
- INSTALLAGENT
- How the resource was installed:
- AUTOINSTALL
- From autoinstall
- BUNDLE
- From bundle deployment
- CREATESPI
- From EXEC CICS CREATE command
- CSDAPI
- From CEDA, the programmable interface to DFHEDAP, or EXEC CICS CSD command
- DYNAMIC
-
- A PIPELINE scan (URIMAP or WEBSERVICE).
- CICS web template management, using DFHWBTL or DFHWBBMS (DOCTEMPLATE).
- The installation of a DB2ENTRY resource definition with transaction ID specified (DB2TRAN).
- The installation of an ATOMSERVICE resource definition with XSDBIND specified (XMLTRANSFORM).
- The installation of an MQCONN resource definition with INITQNAME specified (MQINI).
- GRPLIST
- From a GRPLIST INSTALL
- SYSTEM
- From CICS or CICSPlex SM system
- TABLE
- From a table definition
- INSTALLTIME
- The time when the resource was installed.
- INSTALLUSRID
- The ID of the user who installed the resource.
| How the resource is defined | DEFINESOURCE | DEFINETIME | CHANGEAGENT | CHANGEAGREL | CHANGETIME | CHANGEUSRID | INSTALLAGENT | INSTALLTIME | INSTALLUSRID |
|---|---|---|---|---|---|---|---|---|---|
| GRPLIST INSTALL | CSD GROUP | Time stamp of CSD record creation | CSDAPI, CSDBATCH, or OVERRIDE | CICS release of CHANGEAGENT system | Time stamp of CSD record change | User ID that ran the CHANGEAGENT | GRPLIST | Time of the last cold start | Jobstep user ID |
| CEDA INSTALL or EXEC CICS CSD INSTALL | CSD GROUP | Time stamp of CSD record creation | CSDAPI, CSDBATCH, or OVERRIDE | CICS release of CHANGEAGENT system | Time stamp of CSD record change | User ID that ran the CHANGEAGENT | CSDAPI | Time of the installation | User ID that ran the installation |
| EXEC CICS CREATE | Name of the program issuing the CREATE command | Time that the resource is created | CREATESPI or OVERRIDE | CICS release of CHANGEAGENT system | Time that the resource is created | User ID that ran the EXEC CICS CREATE command | CREATESPI | Time that the resource is created (from earlier run if warm-started) | User ID that ran the EXEC CICS CREATE command |
| Autoinstall | Autoinstall user program name | Time of the autoinstall | AUTOINSTALL or OVERRIDE | CICS release of CHANGEAGENT system | Time of the autoinstall | User ID that ran the autoinstall | AUTOINSTALL | Time of the autoinstall (from earlier run if warm-started) | User ID that ran the autoinstall |
| Table definition | Table name | Time of the last cold start | TABLE | CICS release of CHANGEAGENT system | Time of the last cold start | Jobstep user ID | TABLE | Time of the last cold start | Jobstep user ID |
| System defined | SYSTEM | Time of CICS startup | SYSTEM | CICS release of CHANGEAGENT system | Time of CICS startup | Jobstep user ID | SYSTEM | Time of CICS startup | Jobstep user ID |
| Dynamically created | Table 2 | Time that the resource is generated | DYNAMIC | CICS release of CHANGEAGENT system | Time that the resource is generated | User ID that generated the resource | DYNAMIC | Time that the installed resource is generated | User ID that generated the installed resource |
| Created by BUNDLE | BUNDLE name | Inherited from BUNDLE | Inherited from BUNDLE or OVERRIDE 2 | Inherited from BUNDLE | Inherited from BUNDLE | Inherited from BUNDLE | BUNDLE | Inherited from BUNDLE | Inherited from BUNDLE |
| CICSPlex SM (EXEC CICS CREATE) | CPSMVnn where nn is the version of the CICSPlex SM BAS resource definition (the VER attribute) | CREATETIME from EYUDREP | DREPAPI, OVERRIDE or SYSTEM | CICS release of CHANGEAGENT system | CHANGETIME from EYUDREP | CHANGEUSRID from EYUDREP | CREATESPI | Time that the resource is created (from earlier run if warm-started) | User ID that ran the create or passed from CICSPlex SM |
| Created by CICSPlex SM for platform | Management part name | Time that the resource is created | CREATESPI or OVERRIDE | CICS release of CHANGEAGENT system | Time that the resource is created | User ID that ran the create or passed from CICSPlex SM | CLOUD | Time that the resource is created | User ID that ran the create or passed from CICSPlex SM |
| CICSPlex SM SYSLINK | SYSLINK | Time that the resource is installed | DREPAPI or OVERRIDE | CICS release of CHANGEAGENT system | Time that the resource is installed | User ID that requested the SYSLINK installation 1 | CREATESPI | Time that the resource is installed | User ID that requested the SYSLINK installation |
Note:
- For the CICSPlex SM BAS resource definitions in the EYUDREP data repository, when CICS security is active the CHANGEUSRID field contains the user ID that made the last modification to the resource definition. When CICS security is not active, the CHANGEUSRID field contains blanks.
- If the BUNDLE resource definition is overridden then the CHANGEAGENT for any resource created by the BUNDLE is not inherited but will be set to what it would have been had the BUNDLE not been overridden, e.g. CSDAPI, CSDBATCH e.t.c.
| Dynamic resource | Generated by | CHANGEUSRID | DEFINESOURCE | INSTALLUSRID |
|---|---|---|---|---|
| DB2TRAN | The installation of a DB2ENTRY resource definition with TRANSID specified | User ID that installed the DB2ENTRY | DB2ENTRY name | User ID that installed the DB2ENTRY |
| DOCTEMPLATE | CICS Web template management, using DFHWBTL or DFHWBBMS | User ID that ran DFHWBBMS or DFHWBTL | DFHWBBMS or DFHWBTL | User ID that ran DFHWBBMS or DFHWBTL |
| DUMPCODE | The installation of a DUMPCODE resource definition by a SET SYSDUMPCODE ADD command or a SET TRANDUMPCODE ADD command | User ID that issued the SET SYSDUMPCODE ADD or SET TRANDUMPCODE ADD command | Name of the program that issued the SET SYSDUMPCODE ADD or SET TRANDUMPCODE ADD command | User ID that issued the SET SYSDUMPCODE ADD or SET TRANDUMPCODE ADD command |
| MQINI | The installation of an MQCONN resource definition with INITQNAME specified | User ID that installed the MQCONN | MQCONN name | User ID that installed the MQCONN |
| PROGRAM | The installation of a Liberty application containing an @CICSProgram annotation | User ID that installed the Link to Liberty application | BUNDLE name or $WLPAPP if the application is not installed in a CICS bundle | User ID that installed the Link to Liberty application |
| URIMAP | A PIPELINE scan | User ID that ran the PIPELINE scan | PIPELINE name | User ID that ran the PIPELINE scan |
| WEBSERVICE | A PIPELINE scan | User ID that ran the PIPELINE scan | PIPELINE name | User ID that ran the PIPELINE scan |
| XMLTRANSFORM | The installation of an ATOMSERVICE resource definition with XSDBIND specified | User ID that installed the ATOMSERVICE | ATOMSERVICE name | User ID that installed the ATOMSERVICE |