All supported devices

You can issue the SETPRT macro in 24-bit mode or 31-bit mode, but the standard and list forms and all modules to which the parameter list points must reside below the line.

When BSAM is used, all write operations must be checked for completion before the SETPRT macro is issued. Otherwise, an incomplete write operation might be purged.

The standard form of the SETPRT macro is as follows (the list and execute forms are shown following the standard form):

dcbaddr—A-Type Address or (2-12)

specifies the address of the data control block for the data set to be printed. The data set must be opened for output before the SETPRT macro is issued.

BURST={N|Y}

specifies whether the paper output is to be burst. BURST=Y indicates that the printed output is to be burst into separate sheets and stacked. BURST=N indicates that the printed output is to go into the continuous forms stacker. If BURST is not specified, the SETPRT routine assumes BURST=N. If bursting is requested, the printed output is threaded into the burster-trimmer-stacker. Otherwise, the printed output is threaded into the continuous forms stacker. The parameter prints a message at the system console telling the operator to thread the paper again if needed.

Restriction: This parameter is effective for the IBM 3800 or 3900 printer only.

CHARS={name|A(address)|R(register)}

{({name|A(address)|R(register) },...)}

specifies 1- to 4- character arrangement tables to be used when printing a data set.

Restriction: This parameter is effective for the IBM 3800 or 3900 printer only.

name

specifies the last four characters of the 8-byte member name for a character arrangement table module.

A(address)

specifies an in-storage address of the user-provided character arrangement table module. See z/OS DFSMSdfp Utilities for information on the format of the module.

R(register)

specifies the register containing an in-storage address of the user-provided character arrangement table module. For information on the format of the module, see z/OS DFSMSdfp Utilities.

COPIES=number

specifies the total number of copies of each page of the data set that is to be printed (from 1 to 255) before going to the next page. If COPIES is omitted, one copy of each page is printed.

Restriction: This parameter is effective for the IBM 3800 or 3900 printer only.

COPYNR=number

specifies the starting copy number for this transmission. number is a value from 1 to 255. This parameter defaults to a value of 1 if not specified.

Restriction: This parameter is effective for a directly-allocated IBM 3800 or 3900 printer only.

COPYP={position|0}

activates or deactivates the horizontal copy feature of the 4248 printer. This overrides the horizontal copy offset in the specified FCB. (If no FCB is specified, the horizontal copy offset in the already loaded FCB is overridden.) COPYP also controls horizontal copy capabilities with 3211 FCBs that are loaded in a 4248 printer.

position

specifies a decimal number from 2 to 168 indicating the print position where the horizontal copy starts. If your 4248 printer has only 132 print positions installed, the maximum number you should specify here is 132. When horizontal copy is activated, the maximum amount of data that can be sent to the printer is equal to the size of the smaller of the two copy areas. If the two copy areas are equal, the maximum amount of data that can be sent is equal to half the number of print positions.

For example, if you specify COPYP=101 for a 4248 printer with 132 print positions, the maximum amount of data that can be sent to the printer is 32 bytes. (Thirty-two bytes is equal to the smaller copy area, from position 101 to position 132.) If you specify COPYP=67 for a 4248 printer with 132 print positions, the maximum amount of data that can be printed is 66 bytes. (Sixty-six bytes is equal to half the number of print positions.)

If COPYP=position is specified and a 3211 format FCB is being used, the 3211 format FCB is converted to 4248 format FCB and the specified offset value is inserted.

Restriction: COPYP=position is not available with the IBM 3262 Model 5 printer.

0

specifies that no horizontal copy is to be made. Any offset value in the specified or already loaded FCB is overridden.

Rule: Channel programs that are used when horizontal copy is activated must have the suppress length indication (SLI) bit set.

DISP={SCHEDULE|NOSCHEDULE|EXTERNAL}

DISP allows you to control how JES disposes of the data created before the SETPRT request. This parameter is valid only for SYSOUT data sets and is ignored for the direct user who issues SETPRT. You can abbreviate the parameters to S, N, and E, respectively. This parameter is effective for any SYSOUT data set.

SCHEDULE

specifies that JES is to schedule the previous data for printing immediately.

NOSCHEDULE

specifies that JES is to separate the data into a separate JES data set and to schedule the previous data set for printing after the job terminates.

EXTERNAL

specifies that the schedule of the data set for printing is determined by the JCL parameter FREE=CLOSE. FREE=CLOSE is the same as specifying DISP=SCHEDULE. The absence of FREE=CLOSE in the JCL is the same as coding DISP=NOSCHEDULE on the SETPRT macro. EXTERNAL is the default.

FCB={imageid|A(address)|R(register)}

({imageid|A(address)|R(register )}[,{V|A}[,N])

specifies that the forms control buffer (FCB) is selected from the image library. The possible specifications are:

imageid

specifies the forms control image to be loaded. A forms control image is identified by a 1- to 4-character name. IBM-supplied 3211 format images are identified by imageid value of STD1 and STD2. User-designed forms control images are defined by the installation.Note that the 4248 accepts both 3211 and 4248 format FCBs. For descriptions of the standard forms control images for the 3203 and 3211, 3262 Model 5 or 4245, see z/OS DFSMSdfp Advanced Services. For a description of the 4248 FCB, see z/OS DFSMSdfp Utilities. For more information about 3800 or 3900 FCB modules, see z/OS DFSMSdfp Utilities.

A(address)

specifies an in-storage address of the user-supplied forms control buffer module to be used. (For information on the format of the module, see z/OS DFSMSdfp Utilities.)

Restriction: This subparameter is effective for directly-allocated IBM 3800 or 3900 Model 1 printers.

R(register)

specifies the register that contains an in-storage address of the user-provided forms control buffer module to be used when printing a data set. (For information on the format of the module, see z/OS DFSMSdfp Utilities.)

Restriction: This subparameter is effective for directly-allocated IBM 3800 or 3900 Model 1 printers.

V or VERIFY

requests that the forms control image be displayed on the printer for visual verification. This subparameter allows forms verification and alignment using the WTOR macro.

A or ALIGN

allows forms alignment using the WTOR macro. This subparameter is ignored if specified for the IBM 3800 or 3900 printer.

N

bypasses automatic forms positioning. This subparameter is ignored if specified for the IBM 3800 or 3900 printer. N is not available via JCL and, thus, cannot be used when opening a directly-allocated printer because OPEN obtains printer setup parameters from the JCL.

FLASH={NONE|name|}

([name],count)}

identifies the forms overlay frame to be used. Unless REXMIT=Y is coded and the forms overlay frame is still in use from the previous SETPRT macro issuance, a message tells the operator to insert this forms overlay frame into the printer. This parameter also lets you specify the number of copies on which the overlay is to be printed (flashed). If you omit this parameter for a directly attached printer, flashing stops. If you omit this parameter when doing a SETPRT while generating SYSOUT data, the FLASH parameters previously in effect for this data set are used.

Restriction: This parameter is effective for the IBM 3800 or 3900 printer only.

NONE

is valid only when using SETPRT while generating SYSOUT data, and causes zero copies to be flashed. If flashing is resumed in a later SETPRT, a message is generated by JES regarding the insertion of the forms overlay frame, even if no change in the forms overlay frame is necessary.

name

specifies the 1- to 4-character name of the forms overlay frame.

count

specifies the total number (0 to 255) of copies of each page of the data set on which the overlay is to be printed, beginning with the first copy. The number of copies printed is not greater than the number of copies specified by COPIES.

For a directly attached printer: No copies are flashed if you specify a flash count of zero. If you specify a nonzero flash count and omit the name of the forms overlay frame, the operator is not requested to insert a frame. Whatever frame is inserted is used.

During the generation of SYSOUT data: If you specify a flash count of zero, the flash count previously in effect for the data set is used. If you specify a nonzero flash count and omit the name of the forms overlay frame, the operator is not requested to insert a frame except when flashing has stopped. If flashing stops, a message from JES requests the operator to insert a new frame. Then, the flashing of the forms resumes using the count specified in the flash count parameter.

INIT={N|Y}

When INIT=Y is specified for a directly-allocated IBM 3800 printer, it initializes the control information in the printer with a folded character arrangement table: the 10-pitch Gothic character set (12 pitch for the IBM 3800 or 3900 Models 3, 6, and 8), and a 6 lines per inch FCB corresponding to the forms size in the printer. COPIES and COPYNR are initialized to 1, FLASH and MODIFY are cleared, and BURST is initialized to N (continuous forms).

When INIT=Y is specified for a SYSOUT data set, other parameters not specified on the same invocation are reset, meaning the JES default is used. ("JES default" refers to what was specified when JES was set up.) For INIT=N, all control information for the IBM 3800 or 3900 printer remains unchanged. Any parameters included on the same macro statement as INIT are processed after printer initialization completes.

Restriction: This parameter is effective for the IBM 3800 or 3900 printer only.

LIBDCB=dcb address—A-Type Address or (2-12)

dcb address is the address of an authorized user library DCB that has been opened, and that you want to use instead of SYS1.IMAGELIB. If LIBDCB is not specified, SYS1.IMAGELIB is used.

Restriction: This parameter is effective for directly-allocated IBM 3800 or 3900 printers only.

MODIFY={name|A(address)|R(register)}

{({name|A(address)| R(register)},trc)}

identifies the copy modification module and an associated character arrangement table module used when modifying the data to be printed.

Restriction: This parameter is effective for IBM 3800 or 3900 printers or SYSOUT.

name

specifies the 1- to 4-character name of the copy modification module stored in SYS1.IMAGELIB. These one to four characters are the fifth to eighth characters of the 8-byte member name of a copy modification module in SYS1.IMAGELIB.

A(address)

specifies an in-storage address of the user-supplied copy modification module. For information on the format of the module, see z/OS DFSMSdfp Utilities.

Restriction: This subparameter is effective for the IBM 3800 or 3900 Model 1 printer.

R(register)

specifies the register containing an in-storage address of the user-provided copy modification module. For information on the format of the module, see z/OS DFSMSdfp Utilities. This subparameter is effective for the IBM 3800 or 3900 Model 1 printer.

trc

specifies the table reference character used to select one of the character arrangement table modules to be used for the copy modification text. The values of 0, 1, 2, and 3 correspond to the order in which the module names are specified in CHARS. If trc is not included, the first character arrangement table module (0) is assumed.

MSGAREA=address—A-Type Address or (2-12)

address is the address of the message feedback area. This area is used to transfer message text between the SETPRT macro and the caller. You must allow at least 80 bytes for the message text plus 10 bytes for prefix information or a total length of at least 95 bytes. The message is truncated if it does not fit into the area. This area resides below the 16MB line.

Restriction: This parameter is effective for the IBM 3800 or 3900 printer only.

The following shows the layout of the message area:

bytes 0-1:

total length

bytes 2-5:

reserved

bytes 6-7:

text length

bytes 8-9:

reserved

bytes 10-variable:

message text

OPTCD={B|U}

    {({B|U},{F|U})}

specifies whether printer data checks are blocked or unblocked and if the printer is to operate in fold or normal mode. You can specify:

B

specifies that printer data checks are blocked (this means to suppress them). This option updates the DCBOPTCD field of the data control block.

U

specifies that printer data checks are unblocked. This option updates the DCBOPTCD field of the data control block.

FOLD or F

specifies that printing is in fold mode. This subparameter is ignored if specified for the IBM 1403 or IBM 3800 or 3900 printer. For 1403 fold mode, use FOLD option under the UCS parameter.

UNFOLD or U

specifies that printing is in normal mode. This subparameter causes fold mode to revert to normal mode. This subparameter is ignored if specified for the IBM 1403 or IBM 3800 or 3900 printer. Because UCS processing occurs after OPTCD processing, if FOLD is specified in the UCS parameter, fold mode is set. If FOLD is not coded, unfold is set.

PRTMSG={N|Y}

allows printing of printer error messages for the programmer on the IBM 3800 or 3900. This parameter is effective for the 3800 only.

N

specifies not to print error messages on the IBM 3800 or 3900.

Y

specifies to print error messages on the IBM 3800 or 3900. Y is the default.

PSPEED={L|M|H|N}

specifies the printer's speed, which affects print quality. This parameter is effective for the 4248 printer only, and is ignored for all other printers. LOW speed produces the best quality. PSPEED is used to set the printer's speed or override that set in the FCB. If no FCB is specified, the PSPEED parameter, if any, in the already loaded FCB is used.

L or LOW

sets the printer speed to 2200 lines per minute.

M or MEDIUM

sets the printer speed to 3000 lines per minute.

H or HIGH

sets the printer speed to 3600 lines per minute.

N or NOCHANGE

indicates that the speed at which the printer is currently running is to remain the same no matter what is specified in the requested FCB, or if none is specified, in the already loaded FCB.

Actual printer speed can vary.

REXMIT={N|Y}

specify REXMIT=Y to modify the starting copy number (COPYNR), the number of copies of the pages in a data set to be printed (COPIES), the forms overlay frame to be used (FLASH), and the number of copies to be printed (FLASH) without changing the other control information already set up in the printer. The SETPRT SVC ignores all other parameters in the parameter list.

UCS={csc}

   {(csc,{F|F,V|V})}

specifies that the character set image that is to be used. This parameter is ignored if specified for the IBM 3800 or 3900 printer. You can specify:

csc (character set code)

specifies the character set selected. A character set is identified by a 1- to 4-character code. Codes for standard IBM character sets are as follows:

1403 or 3203 Printer: AN, HN, PCAN, PCHN, PN, QN, QNC, RN, SN, TN, XN, and YN

3211 Printer: A11, H11, G11, P11, and T11

4245 Printer: AN21, AN31, HN21, HN31, PL21, PL31, GN21, RN21, RN31, TN21, SN21, FC21, KA21, and KA22

4248 Printer: 40E1, 40E2, 4101, 4102, 4121, 4122, 41C1, 41C2, 4181, 4201, 4061, 40C1, 4161, 4041, and 4042

Note: There are no standard IBM character sets supplied for the IBM 3262 Model 5 printer.

The 4245 and 4248 printers load their own images on recognition of the mounted band. The image table provides a correspondence between the band identification and the character set code.

See z/OS DFSMSdfp Advanced Services for a description of the 4245 and 4248 UCS image tables and information on adding user-defined entries to an image table.

FOLD or F

specifies that the character set image that is selected be in fold mode. The fold mode converts the EBCDIC code for lowercase characters to the EBCDIC code for the corresponding uppercase characters. Unless FOLD is specified, UNFOLD mode is set.

V or VERIFY

requests that the character set image be displayed on the printer for visual verification.