The system programmer interface

GDDM V3R2 Base Application Programming Reference

The system programmer interface

GDDM V3R2 Base Application Programming Reference
SC33-0868-02

The system programmer interface 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, 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 parameters are the parameters for the function specified in the request control parameter.

The request control parameter (RCP) is a 4-byte, fullword-aligned function code defining the GDDM function to be called. For a definition of the format of the RCP address table, call description table, and parameter description table for GDDM calls, see "Special-purpose programming in GDDM" in topic 22.0. The GDDM request control parameter code is given, in both hexadecimal and decimal format, for each GDDM call listed and described in "The GDDM calls" in topic 3.0.

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 application anchor block is as described for the reentrant interface. Calls to the system programmer and reentrant interfaces may be mixed, if the same application anchor block is passed on each call.

In the simplest case, the system programmer interface merely provides a means of accessing a GDDM function by a function code (the RCP) rather than by selecting an entry point. Assembler-language macros defining mnemonics for these function codes are provided.

This interface provides an alternative initialization function (SPINIT) that allows control of environmental aspects. For more information on the system programmer interface, see "Special-purpose programming in GDDM" in topic 22.0. A summary list of RCP codes for GDDM (and GDDM-PGF) is given in the GDDM Diagnosis book.

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