C copy books
C copy books are distributed in CICSTS54.CPSM.CPSM.SEYUC370.
- Distributed as:
- Structured data types
- Copybook names:
- EYUCnnnn
- Typedef statements are used to describe the resource table.
- The structure name is the resource table format name (such as, EMASSTRT).
- The attribute names are used as subordinate names.
- For attributes that describe bit indicators, #define statements are generated at the end of the resource table Each #define statement identifies a single indicator value. 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 copy books use trigraphs, which are multi-character combinations, to represent square brackets.
- Any variable-length data that you send to the API must be padded with blanks to the end of the field. The API does not insert the zero-byte ending delimiter.
- 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).
char - 1-byte binary numeric values
short int - 2-byte binary numeric values
long - 4-byte binary numeric values
- 4-byte intervals
long 2 - Time stamps and 8-byte intervals
8- byte binary numeric values
(an array of two fullwords)
char nnnn - 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 C resource table copy book:
Figure 1. Sample C
copy book
/*------------------------------------------------------------------*
* Name = EYUC2400 *
* 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 *
*------------------------------------------------------------------*/
typedef struct EMASSTRT {
char CMASNAME??(8??); /* CMAS Name */
char PLEXNAME??(8??); /* CICSPlex Name */
char CSYSNAME??(8??); /* CICS System Name */
char MON_SPEC??(8??); /* Monitor Spec Name */
char RTA_SPEC??(8??); /* Real Time Analysis Spec Name */
char WLM_SPEC??(8??); /* Work Load Manager Spec Name */
char STATUS; /* Status */
char DYNROUTE; /* Dynamic Routing Mode */
char DYNTYPE??(3??); /* Dynamic Routing Type */
char DESC??(30??); /* Description */
char CSYSAPPL??(8??); /* CICS System VTAM APPLID */
char EYU_RSV0015??(5??); /* Alignment Padding */
long MASSTART??(2??); /* MAS Start STCK Value */
char TMEZONEO; /* Time Zone Offset */
char TMEZONE; /* Time Zone */
char EYU_RSV0019??(2??); /* Alignment Padding */
long DAYLGHTSV; /* Daylight saving in effect */
char SYSID??(4??); /* MAS System Id */
char OPSYSREL??(4??); /* MAS Op Sys Release */
char MVSNAME??(4??); /* MVS System Name */
char JOBNAME??(8??); /* MAS Job Name */
char CECNAME??(8??); /* CEC Name */
char SYSPLEX??(8??); /* SYSPlex Name */
char EYU_RSV0257??(4??); /* Alignment Padding */
} EMASSTRT;
Note: VTAM is now z/OS Communications Server.
/*------------------------------------------------------------------*
* *
* EMASSTRT Defines for Table *
* *
*------------------------------------------------------------------*/
#define EMASSTRT_STATUS_LOCAL 128
#define EMASSTRT_STATUS_REMOTE 64
#define EMASSTRT_DYNROUTE_ACTIVE 1
#define EMASSTRT_DYNROUTE_SUSPEND 2
#define EMASSTRT_DYNTYPE_WLMTOR "TOR"
#define EMASSTRT_DYNTYPE_WLMAOR "AOR"
#define EMASSTRT_TBL_LEN 152