z/OS JES2 Macros
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


$PRPUT – Create separator pages

z/OS JES2 Macros
SA32-0996-00

Use $PRPUT to create user-defined separator page(s). The created separator page can replace or add to the standard separator page. The separator page JES2 Exit 1 is in module HASPPRPU.

Format description

Read syntax diagramSkip visual syntax diagram
>>-+--------+--$PRPUT--DATA--=--+-addrx----+-------------------->
   '-symbol-'                   '-(--R1--)-'   

>--,--LEN--=--+-addrx----+--+-------------------------+--------->
              '-(--R0--)-'  |              .-1------. |   
                            '-,--COUNT--=--+-absval-+-'   

>--+---------------------+--+-------------+--------------------->
   |             .-NO--. |  '-,--CC--=--M-'   
   '-,--WAIT--=--+-YES-+-'                    

>--+----------------+------------------------------------------><
   '-,--OPTCD--=--J-'   

DATA=
Specifies the actual address of the data to be printed or punched. The address of this data must not be a 31-bit address. If you do specify a 31-bit address, unpredictable results may occur. The data pointed to by this register must be a fixed-data field because this data area is the I/O data area. Therefore, if $GETBUF is used to obtain this area, be certain to add FIX=YES to that macro statement.
LEN=
Specifies the actual length of the fixed-data field, including any carriage control and 3800 table reference characters (TRC) if present.
COUNT=
Specifies the number of times the data is to be produced. Default is no repetitions.
WAIT=
Specifies whether to wait until I/O has completed as follows:
YES
Wait for I/O completion.
NO (default)
Do not wait for I/O to complete.
CC=M
Specifies that an installation-specified machine carriage control is required. The carriage control characters are defined as hexadecimal values. For the device-dependent printer control commands, refer to the “Commands” section of the manual of the printer on which you are printing your output. If this keyword is omitted, no carriage control is assumed.
OPTCD=J
Specifies that the 3800 table reference character (TRC) is present in the data. If this parameter is omitted, 3800 TRC is not assumed to be present.

Return codes

The following return codes (in decimal) are returned in register 15:
Return Code
Meaning
0
Successful creation of the separator page
4
Creation of the separator page was suspended or terminated.

Environment

  • Main task.
  • $WAIT can occur if WAIT=YES is specified.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014