When the exits are called, register 1 contains the address of the APIPP1X2 control
block, mapped by DSECT S2STG, shown in Figure 20.
Figure 20. Format of APIPP1X2 control block
Offset (Hex) Type Length Name Description
0 (0) Structure * S2STG Exit parameter area
0 (0) Character 5 S2EYEC Set to 'S2STG'
5 (5) 1 * Reserved
==========================================================================================
The following flags are input fields to all exits. The exits must not change these fields.
==========================================================================================
5 (5) Unsigned 1 S2FLAGS Flags for LU type and formatting option
...1 .... S2LU1 Set for LU1; not set for LU0 and LU3
.... ...1 S2FPCL Set when NetSpool converts to PCL
==========================================================================================
The following fields are input to APIPPTD1 and APIPPTD2. The exits must not change these fields.
==========================================================================================
Horizontal Page Format:
6 (6) Signed 2 S2COL Next column number in output
8 (8) Signed 2 S2LM Left margin column number
10 (0A) Signed 2 S2RM Right margin column number
12 (0C) Signed 2 S2MPP Maximum presentation position (line length)
Vertical Page Format:
14 (0E) Signed 2 S2LINE Next output line number
16 (10) Signed 2 S2TM Top margin line number (channel 1)
18 (12) Signed 22 S2C2T12 Channel 2-12 line numbers, 2 bytes per channel
40 (28) Signed 2 S2BM Bottom margin line number
42 (2A) Signed 2 S2MPL Maximum page length
==========================================================================================
The following fields are input to all exits. The exits must not change these fields.
==========================================================================================
44 (2C) Character 8 S2PLUNAM LU name of the application generating
the print request - primary LU (PLU)
52 (34) Character 8 S2LPTNAM Name of the printer LU - secondary LU (SLU)
60 (3C) Character 8 S2PRTCLS Classes of the printer LU.
Each bit represents a class, from 1 to 64:
Value Class
1... .... 1 Class 1
.1.. .... 1 Class 2
.... ...1 1 Class 8
This pattern repeats for 7 more bytes.
More than one bit can be set at a time.
==========================================================================================
The following field can be set by exit APIPPTD1.
==========================================================================================
68 (44) Character 1 S2DBCSM Number of bytes to allocate per DBCS character:
Value Meaning
0 Two positions per character (default)
1 One position per character
==========================================================================================
The following field can be set by exit APIUBF3.
==========================================================================================
69 (45) Unsigned 1 S2OUTFLG Flags for output
1... .... S2VLN255 Maximum 3270 variable line length
is 255 characters (default is 132)
==========================================================================================
The following fields can be set by exits APIPPTD1 and APIPPTD2.
==========================================================================================
70 (46) Signed 2 S2NLNUM New line number for output
72 (48) Signed 2 S2NCNUM New column number for output
==========================================================================================
The following field is input to exits APIPPTD2 and APIUGEX. The exits must not change this field.
==========================================================================================
76 (4C) Character 275 S2TPDATA APIPPTD2: Transparent data found in input data:
1 byte: X'35'
1 byte: Length of data
* bytes: Transparent data
APIUGEX: Graphic Escape character in EBCDIC:
1 byte: In EBCDIC
1 byte: In printer code page
351 (15F) 5 * Reserved
==========================================================================================
The following fields can be set by all exits.
==========================================================================================
356 (164) Signed 4 S2WRKLEN Length of data in S2WRKARA
360 (168) Character 275 S2WRKARA Data returned by exit to include in output
APIPPTD1: SCS controls or transparent data
APIPPTD2: Modified transparent data and SCS controls
APIUBF3: Line data or PCL data to add
APIUGEX: Line data or PCL data to replace the Graphic
Escape character sequence X'08XX'