GDSX Manual

Design and Development
Extended General Device Support (GDSX) Manual–134303
2-6
Coding the LINE^HANDLER
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-19.
•
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 Sections 6 and 7.
•
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 Sections 6 and 7 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-94.
•
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
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.
•
Any USCODE fault number must be greater than 100. Use only fault numbers from
301–500 for a LINE^HANDLER.
Debugging Your GDSX Application
•
You can use a filter to display EMS messages. See "EMS Filters and GDSX" on
page 2-75.
•
You can use a trace in troubleshooting. See "Tracing GDSX" on page 2-76.
•
You can use INSPECT. The INSPECT labs in Sections 5 and 7 may be useful as
examples.
•
You can look up warning and error messages in "Interpreting Console and EMS
Messages" on page 3-16. A listing of “File-System Errors” appears later in this
section.
•
You can refer to "GDSX Internals" on page 2-85.