Previous topic |
Next topic |
Contents |
Contact z/OS |
Library |
PDF
GRINIT—graphics initialization z/OS ISPF Services Guide SC19-3626-00 |
|
This service is available only with CALL ISPLINK or CALL ISPLNK calls. The GRINIT service initializes the ISPF/GDDM interface and optionally requests that ISPF define a panel's GRAPHIC area as a GDDM® graphics field. This service also replaces the FSINIT or SPINIT GDDM calls. Graphic areas are not supported in GUI mode. However, you have some options if you request that an ISPF/GDDM interface be initialized:
If you have specified GUISCRD or GUISCRW values on the ISPSTART invocation that are different than the actual host screen size, GDDM cannot be initialized and the GRINIT service will end with a return code of 20. GDDM or PGF functions are accessed by the dialog through the GDDM reentrant or system programmer interfaces. These interfaces are described in the GDDM Base Application Programming Reference. The dialog must provide an 8-byte area, called an application anchor
block (AAB), which is on a fullword boundary, to the GRINIT call.
This AAB identifies the ISPF/GDDM instance and must be used in all GDDM calls made by the dialog.
Within the ISPF/GDDM instance, the dialog cannot perform any of these GDDM calls:
In addition, these GDDM calls,
while permitted, can interfere with the ISPF/GDDM session:
If a dialog uses GDDM calls to put alphanumeric fields on a display, these fields are displayed only if there are no fields in the body of the ISPF panel definition. Other fields are not displayed. This means that alphanumeric fields can be displayed by either ISPF or the dialog through the use of GDDM, but not by both. In addition, when using GDDM to put alphanumeric fields on a display, it is the dialog's responsibility to ensure that split-screen mode is not active before the display of the panel and that split-screen mode is disabled during the display of the panel. Note:
Command invocation format
Call invocation formatParameters
Return codesThese return codes are possible:
ExampleInitialize
the ISPF/GDDM interface and request that the graphic area in panel
OURLOGO be defined as a GDDM graphics
field.
|
Copyright IBM Corporation 1990, 2014
|