GRINIT—graphics initialization

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 specify a panel name in your GRINIT request, which indicates that you intend to define a graphic area in the panel, you can choose one of these options:
1. To display the panel with the graphic area in the host emulator session
  Note: If you are in split screen mode, the graphic area panel cannot be displayed on the host.
2. To display the panel without the graphic area on your workstation.
If you issue a GRINIT request without specifying a panel name, you can choose from these options:
1. To continue running you application until a graphic panel is encountered, at which time you can choose one of the options provided for GRINIT calls that do specify a panel name
2. To terminate the GDDM initialization, which returns a code of 20.

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:

ASREAD  FSSHOR  ISFLD   MSPCRT  MSQMOD  PTNSEL  WSCRT
FSSHOW  ISQFLD  MSPQRY  MSQPOS  PTSCRT  WSDEL   WSIO
FSENAB  FSTERM  ISXCTL  MSPUT   MSREAD  PTSDEL  WSMOD
FSEXIT  GSREAD  MSCPOS  MSQADS  PTNCRT  PTSSEL  WSSEL
FSINIT  ISCTL   MSDFLD  MSQGRP  PTNDEL  PTSSPP  WSSWP
FSRNIT  ISESCA  MSGET   MSQMAP  PTNMOD  SPINIT

In addition, these GDDM calls, while permitted, can interfere with the ISPF/GDDM session:

DSCLS  DSDROP  DSOPEN  DSRNIT  DSUSE  DSCMF

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:

Terminals running in partition mode or terminals running with multiple screen widths, including the 3290 and the 3278 Mod 5, are not supported for graphics interface mode.
TSO Session Manager is disabled while graphics interface mode is active.