GDSX Manual

Design and Development
Extended General Device Support (GDSX) Manual–134303
2-17
User Code Declarations
used. For globals to be updated, semaphore control may be necessary (see "Semaphore
Control" on page 2-38).
Global Declarations
Typically user code has global data blocks, such as common^data and user^private—see
the example listings in Appendix B. (The names common^data and user^private are
used throughout this manual, although you can use other names for these data blocks.)
Global data within the common^data block can be referenced and updated by both
TSCODE and USCODE, while global data within the user^private data block can be
referenced and updated only by USCODE tasks.
In all GDSX applications, user code must source in the three sections of the
DCCBDECS file listed on the first line of Table 2-1. These sections define the IOCB,
TCB, and FCB control structures shared by TSCODE and USCODE. A listing of
DCCBDECS is contained in Appendix C.
Depending on application requirements, user code may source in the section of the
DCCBDECS file listed on the second line of the table. This section defines the RCB
control structure.
Depending on application requirements, user code may source in the
getreceiveinfo^template section of the ULHDECS, ULHDECSE, or USKELDEC
installed subvolume files. This structure may be useful if you are calling
^FILE_GETRECEIVEINFO_.
User code must source in the DCB and LCB control structures. The standard
declarations for these structures can be sourced in from the templates section of either
Table 2-1. Global Declarations Sourced in by User Code
Description of Contents File Name Sections of File
Control block template definitions DCCBDECS IOCB^LAYOUT, TCB^LAYOUT,
FCB^LAYOUT
Control block template definitions DCCBDECS RCB^LAYOUT
Standard or user-modified Device
and Line control block template
definitions
DCCBDECS,
USKELDEC, or
ULHDECS
TEMPLATES
Structure used for calling
^FILE_GETRECEIVEINFO_
USKELDEC,
ULHDECS, or
ULHDECSE
GETRECEIVEINFO^TEMPLATE
Configuration template definition DCCBDECS CONFIG^TEMPLATES
Configuration template allocation DCCBDECS CONFIG^DATA
DEFINEs; literals; various globals
allocated
DCCBDECS COMMON^DATA, ERRORS
External procedure declarations EXTDECS0 DEBUG, NUMOUT, NUMIN
External procedure declarations for
TSCODE routines
PEXTGDS (Entire file used)