CICSPlex SM resource tables

Each CICSPlex® SM managed object is represented externally by a resource table.

A resource table defines all the attributes of an object. The attributes represent the collection of data that is available for that object.

The formal object name is used as the name of the resource table that describes the object's attributes. You identify an object in your API program by specifying its resource table name. For example, to find out about the programs in one or more CICS® systems, you could access the PROGRAM object. PROGRAM is the name of the CICSPlex SM resource table that describes CICS programs.

Each instance of an object is formatted as a resource table record that describes an actual resource in the CICSPlex SM environment. The object attributes are presented in the individual fields of a resource table record. It is important to note that a resource table is not itself an object. A resource table record is merely the format in which information about a managed object is returned by CICSPlex SM. This information includes the current attribute values, the actions that the object supports, and the releases of CICS for which the object is valid.

There is a resource table type for each type of CICSPlex SM managed object:
Resource table type
Object type
CICS Definition
CICS resource definitions
CICS Resource
CICS resources
CICS Monitored
Monitored CICS resources
CPSM Definition
CICSPlex SM definitions
CPSM Manager
CICSPlex SM manager resources
CPSM Notification
CICSPlex SM notifications
CPSM MetaData
CICSPlex SM metadata
CPSM Configuration
CICSPlex SM configuration definitions
For a summary of the CICSPlex SM resource tables by type and complete descriptions of specific resource tables see CICSPlex SM resource tables.

Restricted Resource Table Attributes

Certain attributes in the CICSPlex SM resource tables are for internal use only; they cannot be modified or manipulated by an API program.

In CICS Resource and CICS Monitored tables, CICSPlex SM uses the following attributes to identify uniquely which CICS system contains the resource:
  • EYU_CICSNAME
  • EYU_CICSREL.
These attributes are included in every CICS Resource and CICS Monitored resource table record. You can specify these attributes in a GROUP command to summarize the records in a result set. However, you should not specify these attributes in an ORDER, SPECIFY FILTER, or SPECIFY VIEW command.

CPSM Definition and CICS Definition tables include a CHANGETIME attribute, that reflects the date and time at which the definition was last modified. CICS Definition tables also include a CREATETIME attribute, that is the date and time at which the definition was created. CICS TS 4.1 introduced new attribute fields ( CHANGEAGENT, CHANGEAGREL and CHANGEUSRID ) for BAS resource definitions. These attributes display details as to how the resource was defined or last modified, the level of CICS system running when the resource was defined or last modified and the ID of the user who created or modified the resource definition CICSPlex SM is solely responsible for maintaining the CHANGEAGENT, CHANGEAGREL, CHANGETIME, CREATETIME and CHANGEUSRID attributes; do not attempt to modify these attribute values.



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