PL/I copy books
PL/I copy books are distributed in CICSTS54.CPSM.SEYUPL1.
- Distributed as:
- Based structures
- Copybook names:
- EYUPnnnn
- The variable EYUPTPTR must be explicitly declared as follows:
DCL EYUPTPTR POINTER; - The structure level 1 name is the resource table format name (such as, EMASSTRT).
- The attribute names are used as subordinate level names.
- For attributes that describe bit indicators, subordinate structure levels are used. Each bit indicator is assigned a unique name.
- All other indicator attributes result in constant declarations being generated at the end of the resource table. These constants can be used for assignment or evaluation of the attribute. The constant name is a concatenation of the resource table name, the attribute name, and the indicator name, connected by underscores (such as, EMASSTRT_DYNROUTE_ACTIVE).
- The table length field is a concatenation of the resource table format name and the constant TBL_LEN, connected by an underscore (such as, EMASSTRT_TBL_LEN).
BIT(8) ALIGNED - 1-byte binary numeric values
FIXED BIN(15) - 2-byte binary numeric values
FIXED BIN(31) - 4-byte binary numeric values
- 4-byte intervals
(2) FIXED BIN(31) - Time stamps and 8-byte intervals
- 8-byte binary numeric values
(an array of two fullwords)
FIXED DEC(n) - Packed decimal data
CHAR(nnnn) - Character data
- Binary values greater than 8 bytes
- Odd number binary values less than 8 bytes
Figure 1 is a representative extract of a PL/I resource table copy book: Figure 1. Sample PL/I copy book
/*----------------------------------------------------------------*/
/* Name = EYUP2400 */
/* Format Name = EMASSTRT */
/* Version = 0001 */
/* Status = CPSMREL(0310) */
/* Function = Base Table Structure generator */
/* Format definition for this element = EMASSTRT */
/* Valid Operations = None */
/* Valid Actions = None */
/*----------------------------------------------------------------*/
DCL 01 EMASSTRT BASED(EYUPTPTR), /* Notify CICS System Start Event*/
02 CMASNAME CHAR(0008),
/* CMAS Name */
02 PLEXNAME CHAR(0008),
/* CICSPlex Name */
02 CSYSNAME CHAR(0008),
/* CICS System Name */
02 MON_SPEC CHAR(0008),
/* Monitor Spec Name */
02 RTA_SPEC CHAR(0008),
/* Real Time Analysis Spec Name */
02 WLM_SPEC CHAR(0008),
/* Work Load Manager Spec Name */
02 STATUS,
/* Status */
03 LOCAL BIT(1) UNALIGNED,
/* Local MAS */
03 REMOTE BIT(1) UNALIGNED,
/* Remote MAS */
03 RSVD0003 BIT(1) UNALIGNED,
/* Reserved */
03 RSVD0004 BIT(1) UNALIGNED,
/* Reserved */
03 RSVD0005 BIT(1) UNALIGNED,
/* Reserved */
03 RSVD0006 BIT(1) UNALIGNED,
/* Reserved */
03 RSVD0007 BIT(1) UNALIGNED,
/* Reserved */
03 RSVD0008 BIT(1) UNALIGNED,
/* Reserved */
02 DYNROUTE BIT(8) ALIGNED,
/* Dynamic Routing Mode */
02 DYNTYPE CHAR(0003),
/* Dynamic Routing Type */
02 DESC CHAR(0030),
/* Description */
02 CSYSAPPL CHAR(0008),
/* CICS System VTAM APPLID */
02 EYU_RSV0015 CHAR(0005),
/* Alignment Padding */
02 MASSTART(2) FIXED BIN(31),
/* MAS Start STCK Value */
02 TMEZONEO BIT(8) ALIGNED,
/* Time Zone Offset */
02 TMEZONE CHAR(0001),
/* Time Zone */
02 EYU_RSV0019 CHAR(0002),
/* Alignment Padding */
02 DAYLGHTSV FIXED BIN(31),
/* DayLight saving in effect */
02 SYSID CHAR(0004),
/* MAS System Id */
02 OPSYSREL CHAR(0004),
/* MAS Op Sys Release */
02 MVSNAME CHAR(0004),
/* MVS System Name */
02 JOBNAME CHAR(0008),
/* MAS Job Name */
02 CECNAME CHAR(0008),
/* CEC Name */
02 SYSPLEX CHAR(0008),
/* SYSPlex Name */
02 EYU_RSV0257 CHAR(0004);
/* Alignment Padding */
Note: VTAM is now z/OS Communications Server.
/*----------------------------------------------------------------*/
/* */
/* EMASSTRT Constants for Table */
/* */
/*----------------------------------------------------------------*/
DCL EMASSTRT_DYNROUTE_ACTIVE BIT(8) ALIGNED STATIC INIT('01'BX);
/* Routing ACTIVE */
DCL EMASSTRT_DYNROUTE_SUSPEND BIT(8) ALIGNED STATIC INIT('02'BX);
/* Routing SUSPENDED */
DCL EMASSTRT_DYNTYPE_WLMTOR CHAR(3) STATIC INIT('TOR');
/* Routing TOR */
DCL EMASSTRT_DYNTYPE_WLMAOR CHAR(3) STATIC INIT('AOR');
/* Routing AOR */
DCL EMASSTRT_TBL_LEN FIXED BIN(15) STATIC INIT(152);