The Parameter List

The GNRLFAIL/VSAMFAIL routine returns a single parameter that contains the requested diagnostic information. You can use the IKJEFFGF macro, which is provided in SYS1.MACLIB, to map this diagnostic information. Specify the GFDSECT=YES option to map the GFDSECTD DSECT instead of obtaining storage; GFDSECT=NO is the default.

The IKJEFFGF macro generates the following diagnostic information:

Table 1. Diagnostic information returned by GNRLFAIL/VSAMFAIL (GFDSECTD DSECT)
Offset dec(Hex)	Field name	Contents or meaning
0(0)	GFCBPTR	Pointer to VSAM ACB if GFOPEN or GFCLOSE callerid. Pointer to VSAM RPL for other VSAM macro failures. Pointer to SSOB if GFSSREQ caller id.
4(4)	GFRCODE	Error return code from register 15 or ABEND code if GFCALLID is GFABEND.
8(8)	GF02PTR	Zero, or address of TSO/E message issuer routine (IKJEFF02) if already loaded.
12(C)	GFCALLID	ID for caller's failing VSAM macro, or other failure. This field can have the following values: Value Meaning GFCHECK (X'0001') VSAM CHECK macro error GFCLOSE (X'0002') VSAM CLOSE macro error GFENDREQ (X'0003') VSAM ENDREQ macro error GFERASE (X'0004') VSAM ERASE macro error GFGET (X'0005') VSAM GET macro error GFOPEN (X'0006') VSAM OPEN macro error GFPOINT (X'0007') VSAM POINT macro error GFPUT (X'0008') VSAM PUT macro error GFPARSE (X'0015') parse service routine error, other than a return code of 4 or 20. GFPUTL (X'0016') PUTLINE service routine error GFABEND (X'001F') Issue ABEND message GFSSREQ (X'0020') Subsystem interface request (SSREQ) error
14(E)	GFBITS	Special processing switches. This field can have the following values: Value Meaning GFKEYN08 (X'80') Caller not in key 0 or 8. GFSUBSYS (X'40') Caller used VS2 VSAM/job entry subsystem interface. GFWTPSW (X'20') Issue error message as write-to-programmer instead of PUTLINE.
16(10)	GFCPPLP	Pointer to TMP's CPPL control block (needed if PUTLINE is issued, or to have command name inserted in the failure message).
20(14)	GFECBP	Pointer to ECB for PUTLINE (optional).
24(18)	GFDSNLEN	Length of data set name.
26(1A)	GFPGMNL	Length of program name.
28(1C)	GFDSNP	Pointer to data set name to insert in VSAMFAIL error messages (optional; default is ddname).
32(20)	GFPGMNP	Pointer to program name for insertion in all error messages (optional; default is ddname).