GDSX (Extended General Device Support) Manual

Design and Development
Extended General Device Support (GDSX) Manual—529931-001
2-5
Coding and Testing Considerations
•
D-series service routines, which are procedures that are new in the D44 RVU, as
well as C-series service routines, which are C-series compatible procedures that
can be called on either a D-series system or a C-series system. See Section 8,
Service Routines for descriptions of all these procedures.
°
Of the service routines, most of the utility procedures are available to any
GDSX application, except for a few procedures that are reserved for converted
applications. See Section 8, Service Routines for descriptions of all these
procedures.
°
In general, if GDSX is run converted, only the GDSX pseudo procedures that
correspond to the D-series Guardian, Pathway/iTS and TMF procedures are
available to USCODE (except for ^OPEN, ^CLOSE, ^FILEINFO, and
^FNAMEEXPAND). If other calls are attempted, TSCODE returns file-system
error 29 or 560. See Section 8, Service Routines for descriptions of all these
procedures.
°
In general, if GDSX is run unconverted, only the GDSX pseudo Guardian,
Pathway/iTS and TMF procedures that correspond to the C-series procedures
are available to USCODE (except for ^FILE_OPEN_, ^FILE_CLOSE_, and
^FILE_GETINFO_). If other calls are attempted, TSCODE returns file-system
error 29 or 560. See Section 8, Service Routines8 for descriptions of all these
procedures.
GDSX D44 supports both C-series and D-series file name structures and C-series and
D-series-format system messages. If GDSX is run as a converted process, system
messages passed to USCODE by TSCODE are in D-series format. If GDSX is run as
an unconverted process, system messages passed to USCODE by TSCODE are in
C-series format.
GDSX D44 supports the ability of a GDSX process to create high PIN processes.
GDSX D44 supports the ability of a GDSX process to access the file of size greater
than 4 GB using pseudo procedure call ^FILE_OPEN/ ^XFILE_OPEN.
Coding and Testing Considerations
The following considerations and suggestions may be helpful when coding, compiling,
binding, and testing a GDSX application. Guidelines for running GDSX and managing
it with SCF are provided in Section 3, Operations and Support
•
Before coding your application, install GDSX and run the example
DEVICE^HANDLER—see Section 4, “DEVICE^HANDLER Example, Running and
Managing,”and Section 5, DEVICE^HANDLER Example, Design
•
Read about the GDSX application generation process in Section 4,
DEVICE^HANDLER Example, Running and Managing and later in this section.
•
See Steps for Coding New Applications and Conversion on page 2-15 for the tasks
necessary to code a new GDSX application and to convert an existing application
to use the extended D-series features.