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 theCMAS 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:

SHUTDOWN: Shutdown the CMAS
PURGE: Purge incore ESM security profiles
SECREBUILD: Rebuild the ESM Security profiles

These actions require no unique parameter data.

External resource name: CICSCICSManagingAddressSpaceList
Length: 56
Usage: API or WUI or CICS Management Client Interface
API view: No
CMAS context: Yes
SCOPE applies: No
Only query CMASs in workload: No
Object type: CICSPlex SM Manager
Copybook identifier: EYUt2450

Table 1. Valid CPSM operations
Operations	Actions	Parameters	Required
GET		None	N/A
PERFORM SET	SHUTDOWN	None	N/A
	PURGE	None	N/A
	SECREBUILD	None	N/A
	RESET	USERID(value)	Yes
	RESETTIME	None	N/A
	CPSMDUMP	ASID(value)	No
		BAS	No
		CHE	No
		COM	No
		DAT	No
		KNL	No
		MAS	No
		MON	No
		MSG	No
		QUE	No
		RTA	No
		SIM	No
		SLM	No
		SRV	No
		TOP	No
		TRC	No
		WLM	No

Table 2. CMASLIST FEEDBACK error codes
Value	Code	Description
1	CMASLIST_INV_DATA	Invalid attribute data
2	CMASLIST_REC_NOT_FOUND	Requested resource not found
22	CMASLIST_SECURITY_NOT_ACTIVE	Security not active
23	CMASLIST_INV_USERID	User ID missing or invalid

Table 3. CMASLIST resource table attributes
Name	Datatype	Source	Len	Sum	Set	Description	Attr ID
ACCESSTYPE	EYUDA	CPSM	4	LIKE	No	Type of access	9
ACCESSTYPE Output valid values	N_A, LOCAL, ADJACENT, INDIRECT
CMASNAME-1	CHAR	CPSM	8	DIFF	Yes	CMAS	4
CPSMVER	CHAR	CPSM	4	DIFF	No	CPSM version of CMAS	7
JOBID	CHAR	CPSM	8	DIFF	No	MVS job ID	12
JOBNAME	CHAR	CPSM	8	DIFF	No	MVS job name	11
STATUS	EYUDA	CPSM	4	LIKE	No	Status of CMAS	8
STATUS Output valid values	N_A, INACTIVE, ACTIVE, LOSTCON, CREATING
SYSID	CHAR	CPSM	4	DIFF	No	CICS system ID	6
TRANSITCMAS	CHAR	CPSM	8	DIFF	No	First transit CMAS	5
TRANSITCNT	BINARY	CPSM	2	AVG	No	Number of transit CMASs	10