TDUE - Transient data EXEC Parameter List

      CONTROL BLOCK NAME = DFHTDUEC
      DESCRIPTIVE NAME = CICS TS EXEC argument list for Transient
                                  Data user exits.
           Licensed Materials - Property of IBM
            Restricted Materials of IBM 
           5655-Y04
           (C) Copyright IBM Corp. 1992, 1993 
         Although provided in a general library, DFHTDUED is not
         to be used as a general programming interface. Refer to
         product documentation to determine intended usage.
         The following fields are part of the Product-sensitive
         Programming Interface.
                     TD_ADDR0
                     TD_ADDR1
                     TD_ADDR2
                     TD_ADDR3
                     TD_ADDR4
                     TD_ADDR5
                     TD_ADDR6
                     TD_ADDR7
                     TD_GROUP
                     TD_FUNCT
                     TD_BITS1
                     TD_EIDOPT5
                     TD_EIDOPT6
                     TD_EIDOPT7
                     TD_QUEUE
                     TD_WRITEQ_QUEUE
                     TD_READQ_QUEUE
                     TD_DELETEQ_QUEUE
                     TD_READQ_SET
                     TD_READQ_INTO
                     TD_WRITEQ_FROM
                     TD_LENGTH
                     TD_WRITEQ_LENGTH
                     TD_READQ_LENGTH
                     TD_SYSID
                     TD_WRITEQ_SYSID
                     TD_READQ_SYSID
                     TD_DELETEQ_SYSID
         All equates for values of EIBRCODE, EIBRESP and EIBRESP2
         form part of the General-purpose Programming Interface.
         All remaining fields used in defining the Exec Parameter
         List are product sensitive and may vary between CICS
         releases.
      FUNCTION =
           To define the EXEC parameter list for Transient Data
           requests, for use by global user exit programs at exit
           points XTDEREQ and XTDEREQC.
           On entry to the XTDEREQ and XTDEREQC User Exits, the EXEC
           parameter list is pointed to by UEPCLPS.
           The EXEC parameter list for Transient Data consists of
           eight addresses.
           The eight addresses are defined by TD_ADDR0 to TD_ADDR7.
           This DSECT defines these addresses and the areas that
           they point to.
           On entry to the XTDEREQ and XTDEREQC User Exits, the copy
           of EIBRCODE is pointed to by UEPRCODE, the copy of EIBRESP
           is pointed to by UEPRESP and the copy of EIBRESP2 is
           pointed to by UEPRESP2.
           This DSECT also contains equates for values of EIBRCODE,
           EIBRESP and EIBRESP2 used by Transient Data.
      LIFETIME = Lifetime of the TD command request
      STORAGE CLASS = As the storage being mapped is the translated
                   source in the user's application program, the
                   storage may be either above or below the line.
      LOCATION = (1) EXEC Parameter List is addressed by UEPCLPS.
                   (2) Fields copied from the EIB are addressed by
                       UEPRCODE, UEPRESP and UEPRESP2.
                   (3) The token for use in communicating between
                       XTDEREQ and XTDEREQC is addressed by UEPTDTOK.
      INNER CONTROL BLOCKS =
           TD_ADDR_LIST declares the EXEC addresses.
           TD_EID defines the EID pointed to by TD_ADDR0.
      NOTES :
       DEPENDENCIES = S/370 ESA
       RESTRICTIONS = None
       MODULE TYPE = Control Block definition
     -----------------------------------------------------------------
      EXTERNAL REFERENCES =
            None.
        DATA AREAS =
            None.
        CONTROL BLOCKS =
            None.
        GLOBAL VARIABLES (Macro pass) =
            None.
     -----------------------------------------------------------------
      The command parameter list is a list of addresses
      which reference the argument values for this this EXEC CICS
      command. The addresses are only valid if the argument is
      applicable to this command.
      For example, address 1 is of the TD QUEUE name for all TD
      commands, whereas the address 2 is of the FROM data area on
      WRITEQ commands, the SET address or INTO data area for READQ
      commands, and is not valid for DELETEQ commands.
      The existance bits in the EID component (TD_BITS1) specify
      those addresses that are valid, and the flagword bits
      (TD_EIDOPT5 - TD_EIDOPT7) specify the keywords that were given
      in the EXEC CICS TD command.
      Therefore, you can deduce the useage of each address by testing
      these bits in conjunction with the command function(TD_FUNCT).

                                         INTO data area (READQ)
                                         SET address (READQ)

      TD_EID (addressed by TD_ADDR0) gives the command function, and
      contains the existence and flagword bits.
      Note: Equates for TD_GROUP, TD_FUNCT, EIBRCODE, EIBRESP and
      EIBRESP2 values are defined at the end of this data structure.

                                         '04'X for READQ
                                         '06'X for DELETEQ
   -----------------------------------------------------------------
    The existence bits (TD_BITS1) specify the parameters that are
    valid for this command.
    For example, TD_EXIST7 set on indicates that TD_ADDR7 is valid,
    meaning that it addresses a SYSID value.
    TD_ADDR0 is always valid and has no existence bit.
    TD_EXIST3 may be modified by a user exit program invoked for
    a READQ command with the SET option.
    TD_EXIST7 may be modified by a user exit program invoked for
    any TD request.
    None of the other bits may be modified.
   -----------------------------------------------------------------

   -----------------------------------------------------------------
    The next 3 bytes (TD_EIDOPT5 - TD_EIDOPT7) are the flagword
    bits.
    A user exit program at XTDEREQ can set the TD_READQ_NOSUSPEND_X
    bit for all READQ requests, and may test (but may NOT modify)
    the TD_READQ_SET_X bit for all READQ requests.
    These bits have no meaning for WRITEQ or DELETEQ commands.
   -----------------------------------------------------------------

      The following definitions are for the rest of the arguments in
      the EXEC parameter list, addressed by TD_ADDR1 - TD_ADDR7 in
      TD_ADDR_LIST.

    Equate for TD_GROUP.
    All Transient Data requests have group code '08'

    Equates for TD_FUNCT values.

       Start of General Use Programming Interface.
       Equates for EIBRCODE values used by Transient Data.

       Equates for EIBRESP values used by Transient Data.

       Equates for EIBRESP2 values used by Transient Data.