Parameter list contents

The macro EZAPPFCD GRE=DSECT generates a DSECT of the parameter list for the general routing exit. EZAPPFCD GRE=INLINE generates an inline copy.

See Using the EZAPPFCD macro to generate the DSECTS you need.

GRCALLID

Address of a four-byte character field with the identity of the caller:

Value: Meaning
'JES ': The caller is a JES external writer.
'VTAM': The caller is the VTAM® application module.

GRCALLPM

The address of the JES or VTAM-specific parameter area. For JES, it is the address of a list of parameters that consists of:

A pointer to the GETDS function-dependent area in the IAZFSIP DSECT. (To generate this DSECT, code the IAZFSIP macro with LIST=YES in your exit.)
A pointer to the values of the PARM parameters passed by the NPF FSS writer start procedure.
A fullword binary number specifying the length of the PARM parameters passed by the NPF FSS writer start procedure.
A fullword of binary zeros
A fullword of binary zeros (reserved)
A fullword of binary zeros (reserved)
A fullword of binary zeros (reserved)
The EOF flag

For VTAM, it consists of the address of the 35-byte BIND image received from VTAM.

GRRTNAME

Address of an area containing two 8-byte name fields. The names passed to the exit are the major and minor names of the routing record that NPF will use unless otherwise directed. To use the NPF-selected routing record, return with GPR 15 set to 0000. To specify a different routing record, return with GPR 15 set to 0001 and supply the new major and minor names in this area.

GRRTDATA

The address of the fullword where the exit will store the address of the new routing data area. This field must be supplied by the exit when the return code is 0002.

Because NPF will FREEMAIN the new routing area allocated by the EZAPPGPR exit, make sure the size of the RDA corresponds to the following formula:

length=346+(RTDADEST*516)