The system programmer interface

GDDM-GKS V1R1 Programming Guide and Reference

The system programmer interface

GDDM-GKS V1R1 Programming Guide and Reference
SC33-0334-00

The system programmer interface (SPI) is a special interface available to "system programming" types of applications. It is available only in reentrant form, and shares many features with the reentrant interface.

Each call takes the form:


        CALL ADMASP (AAB, RCP, component parameters, ... )

where ADMASP is the defined system programmer interface entry point, AAB is as defined for the reentrant interface, RCP is the request control parameter (defined below), and component parameters are the parameters for the function specified in the RCP.

The RCP is a 4-byte, fullword-aligned function code defining the GDDM Base or GDDM-GKS function to be called. The RCP code for each GDDM-GKS function call is given, in both hexadecimal and decimal format, with the description of the call, later in this topic. Also, all the RCP codes are listed in Appendix F, "GDDM-GKS RCP codes" in topic F.0. For the RCP codes for all GDDM Base and GDDM-PGF functions, refer to the GDDM Diagnosis book.

ADMASP is a single entry point resolved by the GDDM interface modules that are link-edited or loaded with the application. The use of the AAB is as described for the reentrant interface. Calls to the system programmer and reentrant interfaces may be mixed, if the same AAB is passed on each call.

In the simplest case, the system programmer interface merely provides a means of accessing a GDDM-GKS function by a function code (the RCP) rather than by selecting an entry point.

This interface provides an alternative initialization function (SPINIT) that allows control of environmental aspects. The SPINIT function is described in the GDDM-PGF Programming Reference book.

Notices | Terms of use | Support | Contact z/OS