GDSX Manual

About This Manual

Extended General Device Support (GDSX) Manual–134303

What’s in This Manual

This manual is directed to all users who need information on how to design and code the

user-supplied part of a GDSX process, and to those who need to know how to compile,

bind, debug, and run GDSX. The manual includes the following:

What Is Included in This Manual?

This preface contains a guide to help you find material you need. It has headings for

system analysis, design and development, operations, and support functions. Under each

heading is a list of parts of the manual that are likely to be useful in doing the tasks

involved in that function. The sections are as follows:

•

Section 1 contains introductory material useful for a high-level understanding of

GDSX, including an explanation of the purpose for which GDSX is used, typical

applications, hardware and software requirements, a description of the component of

the GDSX code supplied by Tandem, and the interface of GDSX with Pathway/TS.

•

Section 2 contains suggestions and considerations on designing and developing

USCODE; steps for coding new applications and conversion; a description of

D-series features; instructions on how to compile USCODE and how to bind

USCODE and TSCODE object modules to form a complete GDSX front-end

process. Also included is information on basic internal control flow, memory pools,

space and calling restrictions, configuration parameters, fault tolerance, file system

errors, EMS (Event Management Service) filters, tracing, GDSX internals, and the

USAMPLE example program.

•

Section 3 includes material for operations and support functions, including

instructions on running a GDSX application at a high or low PIN, space usages and

limitations, GDSX configuration parameters, management with SCF (Subsystem

Control Facility), console and EMS messages, and procedures to follow if GDSX

abnormally ends (abends).

•

Sections 4 through 7 comprise a tutorial covering the compilation, binding, and

execution of an example application and the use of SCF to configure and manage the

example. A thorough description of the example’s design and functioning is

included in Sections 5 and 7.

In Sections 4 and 5 the example is run with a DEVICE^HANDLER and no

LINE^HANDLER, because approximately 80 percent of GDSX applications have

DEVICE^HANDLERs only.

Sections 1-3 Introductory material

Sections 4-7 Tutorial

Sections 8 and 9 Reference material

Appendixes A-E Appendixes and example program listings