GDSX (Extended General Device Support) Manual

Design and Development
Extended General Device Support (GDSX) Manual—529931-001
2-6
Coding the DEVICE^HANDLER
•
See Section 9, User Exit Descriptions for details on customizing other user exits
and providing stubs for the remaining user exits.
•
If possible, test DEVICE^HANDLER tasks by themselves, or with dummy
LINE^HANDLERs.
Coding the DEVICE^HANDLER
•
See Section 4, DEVICE^HANDLER Example, Running and Managing and
Section 5, DEVICE^HANDLER Example, Design of the tutorial and the USAMPLE
example program for examples. USAMPLE design is described in USAMPLE
Example Program on page 2-98.
•
See Section 9, User Exit Descriptions for a description of the DEVICE^HANDLER
user exit.
•
See Section 8, Service Routines for syntax of the utilities and pseudo procedures.
Use pseudo Guardian procedures instead of the Guardian counterparts. TSCODE
supports a set of pseudo Guardian procedures that correspond to the D-series
Guardian procedures and a set of pseudo Guardian procedures that map to the C-
series Guardian procedures.
•
Control block manipulation should not be necessary, but if it is, see Inspecting the
DEVICE^HANDLER Example on page 5-14 and Inspecting the LINE^HANDLER
Example on page 7-20.
•
Most DEVICE^HANDLER procedures are single-threaded. If your
DEVICE^HANDLER must be multithreaded, see the tutorial on the
LINE^HANDLER (which is multithreaded) in Section 6, LINE^HANDLER Example,
Running and Managing and Section 7, LINE^HANDLER Example, Design.
•
If you need to manage resources to be shared among tasks, use the INIT^SEM,
PSEM, VSEM procedures to be consistent with TSCODE—see Section 8, Service
Routines for procedure descriptions.
•
Any USCODE fault number must be greater than 100. Use only fault numbers
from 101–300 for a DEVICE^HANDLER.
Coding the LINE^HANDLER
•
See Section 6, LINE^HANDLER Example, Running and Managing and Section 7,
LINE^HANDLER Example, Design of the tutorial and the USAMPLE example
program for examples. You may wish to modify example programs or use them for
ideas. USAMPLE design is described in USAMPLE Example Program on
page 2-98.
•
See Section 9, User Exit Descriptions for a description of the LINE^HANDLER user
exit.
•
See Section 8, Service Routines for syntax of the utilities and pseudo procedures.
Use pseudo Guardian procedures instead of the Guardian counterparts. TSCODE