Passing Parameters to IKJCAF

The caller's attention routine must store the address of the CLIST attention facility parameter list (IKJCAFPL) in register 1. A caller executing below 16 MB in virtual storage must make sure the parameters it passes to IKJCAF are valid in a 31-bit environment. That is, the high-order byte of each address must be zero. If the high-order byte of each address is not zero, the CLIST attention facility returns to the caller with a return code of 28 (decimal).

You can use the IKJCAFPL DSECT, which is provided in SYS1.MACLIB, to map the fields of the parameter list. Table 1 shows the format of the CLIST attention facility parameter list.

Table 1. The CLIST attention facility parameter list (IKJCAFPL)
Offset dec(Hex)	Number of bytes	Field name	Contents or meaning
0(0)	4	CAFCAF	Parameter list identifier, which is the value C‘CAF’.
4(4)	1	CAFLEV	Version number.
5(5)	3		Reserved.
8(8)	4	CAFTAIE	Address of the terminal attention interruption element (TAIE).
12(C)	4	CAFIOPL	Address of the input/output (IOPL) parameter list. The calling program must fill in all fields of the IOPL except IOPLIOPB.
16(10)	4	CAFPGPB	Address of the PUTGET parameter block (PGPB). The calling program must provide the space for the PGPB, which is defined by the IKJPGPB DSECT.
20(14)	4	CAFSTPB	Address of the STACK parameter block (STPB). The calling program must provide the space for the stack parameter block, which is defined by the IKJSTPB DSECT. IKJCAF fills in the STPB.
24(18)	4	CAFABEND	Abend code. If no abend, this field will be blanks.
28(1C)	4	CAFRSNCD	Abend reason code. If no abend, this field will be zeros.
32(20)	8		Reserved.