C copy books

C copy books are distributed in CICSTS54.CPSM.CPSM.SEYUC370.

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


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