APSURLST parameter area (resource list)
APSURLST is a control block that PSF builds when it needs to provide
information to the exit about a specific resource. Typically, PSF
builds one RLST entry for each resource associated with the current
call to the exit. If multiple RLST entries are required to describe
all the resources to the exit, the RLST entries are linked to form
a single-headed, double-threaded chain. The first, or only, RLST entry
is pointed to by XTP7LSTP in the XTP7 control block area.
Note:
Exit 7 must never modify the pointers RLSTPRVS, RLSTNEXT,
and RLSTEXTP as defined in APSURLST.
All the fields in APSURLST are read by the exit; however, some
fields contain information that is valid only for certain exit calls
and certain resource types. Also, most fields in APSURLST are not
intended to be written to by the exit. PSF looks for changes to specific
fields after certain calls to the exit. For more details, see APSURLST fields.
Figure 98 shows the format of APSURLST.
Figure 98. APSURLST parameter area format
Offsets Type Length Name Description
0 (0) CHARACTER * APSURLST
0 (0) CHARACTER 4 RLSTCID CONTROL BLOCK ID = RLST
4 (4) SIGNED 4 RLSTLENG LENGTH OF RLST CONTROL BLOCK
8 (8) CHARACTER 16 RLSTPTRS RESOURCE LIST POINTERS
8 (8) ADDRESS 4 RLSTPRVS POINTER TO PREVIOUS ENTRY
12 (C) ADDRESS 4 RLSTNEXT POINTER TO NEXT ENTRY
16 (10) ADDRESS 4 RLSTEXTP POINTER TO FONT EXTENSION AREA
20 (14) ADDRESS 4 RLSTMSGP POINTER TO 64 BYTE MESSAGE
INSERT TEXT
24 (18) CHARACTER 16 RLSTRID RESOURCE IDENTIFICATION
24 (18) CHARACTER 8 RLSTNAME RESOURCE NAME
24 (18) BITSTRING 2 RLSTGCID GRAPHIC CHARACTER SET
GLOBAL IDENTIFIER GCSGID
26 (1A) BITSTRING 2 RLSTCPID CODE PAGE GLOBAL IDENTIFIER
28 (1C) BITSTRING 2 RLSTFGID FONT GLOBAL IDENTIFIER
30 (1E) BITSTRING 2 RLSTFW FONT WIDTH
32 (20) UNSIGNED 1 RLSTPDS PDS NUMBER FOR RESOURCE
IDENTIFIED IN RLSTNAME FIELD
33 (21) UNSIGNED 1 * RESERVED
34 (22) BITSTRING 2 RLSTATTR RESOURCE ATTRIBUTES
1... .... RLSTDFT DEFAULT PAGEDEF/FORMDEF
.1.. .... * RESERVED
..1. .... RLSTINL INLINE RESOURCE
...1 .... RLSTSPS SOFT PAGE SEGMENT
.... 1... RLSTMEF MULTIPLE ENTRY FONT
.... .1.. RLSTSEC SECURITY RESOURCE
.... ..1. RLSTUSER USERLIB RESOURCE
.... ...1 RLSTSOFT SOFT RESOURCE - CAN BE PSEG
OR DOR (OBJECT CONTAINER OR
IOCA); NOT VALID ON ACCESS
CALL
1111 1111 * RESERVED
36 (24) BITSTRING 2 RLSTSTAT RESOURCE STATUS FLAGS
1... .... RLSTAUX AUXILIARY RESOURCE
.1.. .... RLSTDEP HAS DEPENDENCIES
..1. .... RLSTNEST NESTED RESOURCE
...1 .... RLSTPLR PRIORITY LEVEL RES.
.... 1111 * RESERVED
1111 1111 * RESERVED
38 (26) CHARACTER 2 * RESERVED
40 (28) SIGNED 2 RLSTRESC RESOURCE COUNT-THE 5TH
RESOURCE IN THE RLST CHAIN
WILL BE #5
42 (2A) UNSIGNED 1 RLSTMSGL LENGTH OF USER'S MESSAGE
INSERT POINTED AT BY RLSTMSGP
43 (2B) CHARACTER 1 * RESERVED
44 (2C) CHARACTER 4 RLSTFLGS FLAGS
44 (2C) BITSTRING 1 RLSTMISC MISCELLANEOUS FLAGS
1... .... RLSTOFNT PRINTER SUPPORTS
OUTLINE FONTS
.1.. .... RLSTGRID RESOURCE NAME IS A GRID
..1. .... RLSTOIDR REFERENCED BY OID
...1 .... RLSTNAMR REFERENCED BY NAME
.... 1111 * RESERVED
45 (2D) BITSTRING 1 RLSTAFLG FLAGS USED ONLY AT ACCESS TIME
1... .... RLSTLOAD FORCE LOAD (RELOAD)
.1.. .... RLSTSMSG ISSUE SUB MESSAGE
..1. .... RLSTRRI RELOAD REQ. IGNORED (SET BY
PSF)
...1 .... RLSTEMSG ISSUE SUBSTITUTION ERROR
MESSAGE
.... 1111 * RESERVED
46 (2E) BITSTRING 1 RLSTLFLG FLAGS USED ONLY AT LOAD TIME
1... .... RLSTLCF LOADING A CODED FONT
.1.. .... RLSTLCP LOADING A CODE PAGE
..1. .... RLSTLFN LOADING A FONT CHARACTER SET
...1 1111 * RESERVED
47 (2F) BITSTRING 1 RLSTDFLG FLAGS USED ONLY AT DELETE TIME
1... .... RLSTKEEP KEEP THIS RESOURCE
.111 1111 * RESERVED
48 (30) UNSIGNED 2 RLSTVFS VERTICAL FONT SIZE
50 (32) UNSIGNED 2 RLSTHFS HORIZONTAL FONT SIZE
52 (34) UNSIGNED 2 RLSTHSCF HORIZONTAL SCALE FACTOR
SPECIFIED IN 1440THS OF AN
INCH
54 (36) UNSIGNED 1 RLSTOIDL LENGTH OF OID
55 (37) UNSIGNED 129 RLSTOID THE OID DOR THIS RESOURCE
184 (B8) CHARACTER 24 * RESERVED
|