CMASLIST Resource Table

A CPSM Communications Manager object that describes a CMAS instance and its connection characteristics as viewed by the current context CMAS. Each object instance reports on a particular CMAS. The object instance for the CMAS in which the GET was requested is identified by the ACCESSTYPE(LOCAL) attribute. The CMASLIST resource table and its actions may be accessed on behalf of any CMAS with a direct or indirect connection to the CMAS to which the API program is connected.

Once a CMAS instance is discovered by CICSPlex® SM communications, it retains knowledge of the instance until the network is terminated. Network termination occurs when all CMAS instances are shutdown.

The Primary key field for this resource class is  CMASNAME .

The following actions are supported:

Start of changeRESETTIME End of change
Start of changeReset the internal CICS clockEnd of change
SHUTDOWN
Shutdown the CMAS
PURGE
Purge incore ESM security profiles
SECREBUILD
Rebuild the ESM Security profiles

These actions require no unique parameter data.

Length
40
Usage
API
API view
No
CMAS context
Yes
SCOPE applies
No
Only query CMASs in workload
No
Object type
CPSM Manager
Copybook identifier
EYUt2450 or CMASLIST
Valid API operations
GET and PERFORM

API Actions

Start of changeRESETTIME End of change
Start of changeReset the internal CICS clockEnd of change
SHUTDOWN
Shutdown

Parameters: None

PURGE
Purge security profiles

Parameters: None

SECREBUILD
Rebuild security profiles

Parameters: None

Table 30. CMASLIST FEEDBACK error codes
Code Description Code Description
REC_NOT_FOUND Requested resource not found SECURITY_NOT_ACTIVE Security not active
Table 31. CMASLIST resource table attributes
Name Datatype Source Len Sum Description Attr ID
 CMASNAME-1  CHAR CPSM 8 DIF CMAS name 4
TRANSITCMAS CHAR CPSM 8 DIF First transit CMAS name 5
SYSID CHAR CPSM 4 DIF CMAS CICS system ID 6
CPSMVER CHAR CPSM 4 DIF CPSM version of CMAS 7
STATUS EYUDA CPSM 4 LIKE Status of CMAS as known to local CMAS 8
STATUS Output Valid Values N_A INACTIVE ACTIVE LOSTCON CREATING
ACCESSTYPE EYUDA CPSM 4 LIKE Type of access that CMAS has to local CMAS 9
ACCESSTYPE Output Valid Values N_A LOCAL ADJACENT INDIRECT
TRANSITCNT BINARY CPSM 2 AVG For indirect access CMAS, number of transit CMASs 10
[[ Contents Previous Page | Next Page Index ]]