PL/I copy books

PL/I copy books are distributed in CICSTS54.CPSM.SEYUPL1.

Distributed as:
Based structures
Copybook names:
EYUPnnnn
Note the following as you use the PL/I copy books:
  • 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).
The resource table data types are mapped into the valid set of PL/I data types. However, exact mapping is not always possible. The resource table data types are mapped as follows:
      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);


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