GDSX Manual

Extended General Device Support (GDSX) Manual–134303
B-1
B
USKELEX and USKELEXC Listings
Included in this appendix are listings of the USKELEX and USKELEXC example
programs. USKELEX is the program used in the tutorial in Sections 4 through 7.
USKELEX is an unconverted program, not using any of the extended features of
D-series systems, and runs only at a low PIN.
The USKELEXC program shows the result of converting the USKELEX application to
take advantage of D-series enhancements. Wherever possible, C-series service routines
in USKELEX are replaced in USKELEXC by D-series service routines. When
compiling or binding this code, remember to set the HIGHPIN object-file attribute so
that you can run the resulting object file at a high PIN.
USKELEXC is intended to be run with d^plus^enabled of the CONTROLFLAGS
configuration parameter set to 1. See “Using D-Series Features” on page 2-2 for further
information on converted processes. This application is not used in the tutorial, but is
provided for guidance in application conversion.
USKELEX Listing
!
! GDSX USCODE Skeleton File
!
?NOMAP, NOLMAP, NOCODE, SYMBOLS, CPU TNS/II
NAME uscode;
BLOCK COMMON^TEMPLATES;
?NOLIST, SOURCE DCCBDECS (EVENTS)
?LIST
?NOLIST, SOURCE DCCBDECS (ERRORS)
?LIST
?LIST, SOURCE DCCBDECS (TCB^LAYOUT)
?LIST
?LIST, SOURCE DCCBDECS (IOCB^LAYOUT)
?LIST
?LIST, SOURCE DCCBDECS (FCB^LAYOUT)
?LIST
?LIST, SOURCE DCCBDECS (RCB^LAYOUT)
?LIST
!===========================================================================
!Comment Users may include their own file to modify DCB and LINE Templates.
!Comment See file ULHDECS that USAMPLE sources in here
?LIST, SOURCE ULHDECSE (TEMPLATES)
!===========================================================================
Caution. The USKELEX and USKELEXC example programs include very little error-handling
logic, because error-handling code depends on the application requirements, and extensive
error-handling code would detract from the overall design focus of the tutorial. Adequate error
handling, however, must be included in applications designed for actual production.