GDSX Manual

Design and Development
Extended General Device Support (GDSX) Manual–134303
2-41
Compiling
•
The standard declarations for these structures can be sourced in from the templates
section of either DCCBDECS or USKELDEC, an installed subvolume file which
contains these two structures.
•
If you want to modify the DCB control structure, you can change the USKELDEC
file as desired and source in its modified templates section at compile time.
•
If you are using either the USKELEX example program or the USKELEXC
example program for your user code, you source in the templates section of the
ULHDECSE file (in the installed subvolume), which contains the standard LCB
template and a modified DCB template.
•
If you are using the USAMPLE example program for your user code, you source in
the templates section of the ULHDECS file (in the installed subvolume), which
contains the standard LCB template and a DCB template modified for USAMPLE.
Compiling
When you compile your user code, the PEXTGDS file, sections of the DCCBDECS file,
and—if you modified the templates section of DCCBDECS—the USKELDEC (or
ULHDECSE, or ULHDECS) files are sourced in, and the resulting object code is named
USCODE.
To facilitate the compiling and binding procedures, you can use UBUILD and UBIND
files. While in the subvolume where you wish to work, copy the UBUILD and UBIND
files from the installed subvolume.
Edit UBUILD to assign SSV1 to the installed subvolume, and assign SSV2 to
$SYSTEM.SYSTEM. If you have source files in the subvolume where you are working,
you can assign SSV0 to the subvolume.
For example, you could create the following UBUILD file:
COMMENT .. UBUILD Build user code
CLEAR ALL
COMMENT Assign SSV1 to GDSX volume and subvolume
COMMENT for ULHDECS, DCCBDECS, ZGDXTAL, PEXTGDS,
COMMENT and USAMPLE
ASSIGN SSV1, $BART.T6580D44
COMMENT Assign SSV2 to EXTDECS0 location
ASSIGN SSV2, $SYSTEM.SYSTEM
TAL /IN USKEL1, MEM 64, OUT $S.#USKEL1/ USCODE
CLEAR ALL
EXIT
In this example, the user code file is named USKEL1, and the object file is named
USCODE. An OUT file is used to capture the compile listing. If your program has
been converted to run at a high PIN, you can set the HIGHPIN object-file attribute with
the following statement:
> TAL /IN USKEL1, MEM 64, OUT $S.#USKEL1/ USCODE; HIGHPIN
After creating UBUILD, issue the command OBEY UBUILD to compile the source
code file and produce the object file.