OUTDES command operands

output_descriptor_name

specifies the name of the output descriptor to be created or reused. This operand is required. Specify 1 to 8 alphanumeric characters for the name. The first character must be alphabetic or one of the special characters #, $, or @.

The OUTDES operand of the ALLOCATE, PRINTDS, and FREE commands refers to the output_descriptor_name specified.

NEW | REUSE

NEW: specifies that a new output descriptor is to be created. If an output descriptor with the same name exists, the system ends your request unsuccessfully. NEW is the default.
REUSE: specifies that if an output descriptor with the same name is found, the new definition replaces the old one. If an output descriptor with the same name does not exist, OUTDES creates a new output descriptor name.

ADDRESS(delivery_address)

specifies the delivery address for system output (SYSOUT). This address prints on the separator pages. You can specify from 1 to 4 delivery addresses. For each delivery address, you can specify from 1 to 60 EBCDIC characters. See Coding rules for the valid characters allowed with and without quotation marks.

AFPPARMS(DataSetName)

Specifies the data set name the AFP Print Distributor uses to locate the parameter file.

AFPSTATS ({YES | NO}) )

Produce an AFP Statistics report while printing this sysout data set.

BUILDING(building_identification)

specifies the building location associated with the SYSOUT. The building location prints on the separator pages. You can specify from 1 to 60 EBCDIC characters. Refer to Coding rules for the valid characters allowed with and without quotation marks.

BURST | NOBURST

BURST: specifies that 3800 output is to be burst into separate sheets.
NOBURST: specifies that the printed 3800 output is to be in continuous fanfold pages. NOBURST is the default.
The following parameters are passed on to the scheduler facility, for more information about these parameters see the OUTDES command in z/OS MVS JCL Reference.

CHARS(charname{,…})

specifies one or more font (character arrangement) tables for printing the SYSOUT data set on a 3800 or 3900 printer. You can specify up to four table names. Specify 1 to 4 alphabetic, numeric, or the special characters #, $, or @ for the character name.

For more information about font (character arrangement) tables, see IBM 3800 Printing Subsystem Programmer's Guide.

CKPTLINE(nnnnn)

specifies the maximum number of lines contained in a logical page. Specify a value from 0 to 32767. The system uses this value either for JES checkpointing of printed output or for SNA transmission checkpoints. Use CKPTLINE in combination with the CKPTPAGE operand.

If you do not specify CKPTLINE, JES uses an installation default specified at initialization.

CKPTPAGE(nnnnn)

specifies the maximum number of pages to be printed or transmitted before the next SYSOUT data set checkpoint occurs. Specify a value from 1 to 32767. This value represents the number of pages to be transmitted as a single SNA chain when data is transmitted to a SNA workstation. Use CKPTPAGE in combination with the CKPTLINE operand.

If you do not specify CKPTPAGE, JES uses the installation default specified at initialization. The default may also indicate whether checkpoints are to be based on page count or time.

CKPTSEC(nnnnn)

specifies the number of seconds that are to elapse between checkpoints of the SYSOUT data set that is printing. Specify a value from 1 to 32767.

If you do not specify CKPTSEC, JES uses the installation default specified at initialization. The default may also indicate whether checkpoints are to be based on page count or time.

CLASS(output_class)

assigns the SYSOUT data set to an output class.

output class: A-Z, 0-9, or *, which indicates same output class as MSGCLASS.

COLORMAP(AFP Resource Member Name)

specifies the AFP Resource (object) for the data set that contains color translation information.

object: 1-8 characters, the first must be either alphabetic or $, #, @; the remaining may be alphanumeric or $, $, @.

COMPACT(compaction_table_name)

specifies the name of the compaction table to be used when the data set is transmitted to a workstation. Specify a 1 to 8 alphanumeric character symbolic name. If you do not specify COMPACT, compaction is suppressed for the data set.

COMSETUP(AFP Resource Member Name)

Specifies the AFP Resource (object) for the data set that contains setup information.

object: 1-8 characters, the first must be either alphabetic or $, #, @; the remaining may be alphanumeric or $, #, @.

CONTROL({PROGRAM | SINGLE | DOUBLE | TRIPLE})

specifies the type of forms control to be used.

PROGRAM: indicates that the carriage control character of each data record is to control line spacing on the form. PROGRAM is the default. The carriage control characters are given in DFSMS/MVS Macro Instructions for Data Sets.
SINGLE: indicates forced single spacing.
DOUBLE: indicates forced double spacing.
TRIPLE: indicates forced triple spacing.

COPIES(nnn[,(group_value)])

specifies the number of copies to be printed for the data set. The number of copies, nnn, can range from 1 to 255, subject to an installation limit. The default is 1.

If you use COPIES in a referenced FORMDEF memeber (described later), the system ignores the COPIES value.

If you specify group values, the system ignores the individual value, nnn, for the 3800 printer. The group values describe how the printed copies are to be grouped (3800 printer only). Each group value specifies the number of copies of each page that are to be grouped together. You can specify up to 8 group values. For example, a group value of 3 causes the first page of a data set to be printed three times before printing is started for the second page, which might also be printed three times, and so forth.

COPYCNT(nnnnnnnnnn)

specifies number of copies to be printed.

nnnnnnnnnn: 0-2147483647 (JES2 or JES3)

DATACK({BLKCHAR | BLKPOS | BLOCK | UNBLOCK})

specifies whether "print positioning" and "invalid character" data check errors are to be blocked or unblocked for printers accessing through the functional subsystem Print Services Facility™ (PSF).

BLKCHAR: specifies character errors that are not valid are to be blocked. The errors are not reported to PSF. Print positioning errors are reported normally.
BLKPOS: specifies print positioning errors are to be blocked, and not reported to PSF.
BLOCK: specifies neither print positioning errors nor character errors that are not valid are reported to PSF.
UNBLOCK: specifies both print positioning errors and character errors that are not valid are reported to PSF.

If you do not specify DATACK, the DATACK specification from the PSF PRINTDEV statement is used. If it is not specified in the PRINTDEV statement, the default is BLOCK.

DEFAULT | NODEFAULT

DEFAULT: specifies that the output descriptor defined by this OUTDES command is the default output descriptor. SYSOUT data sets that do not explicitly refer to an output descriptor use the output characteristics specified in this OUTDES command.
NODEFAULT: specifies that an ALLOCATE or PRINTDS command must explicitly reference the output descriptor to use the defined output characteristics specified in this OUTDES command.

Note: When a default output descriptor is defined with a CLASS value, TSO/E commands such as ALLOCATE, PRINTDS, and SMCOPY may use their own default output class instead.

DEPT(department_identification)

specifies the department identification associated with the SYSOUT. This department identification prints on the separator pages. You can specify from 1 to 60 EBCDIC characters. See Coding rules for the valid characters allowed with and without quotation marks.

DEST(destination | destination.user_id)

specifies the destination of a remote workstation, a user at a specific remote workstation, or an ip-network-address to which the output is routed for processing. You can specify from 1 to 8 characters for either destination or user_id.

For information about what you can specify for destination or destination.user_id, see z/OS MVS JCL Reference.

DPAGELBL | NODPAGELBL

specify whether the system is to print a security-related character string on each page of output.

DPAGELBL: specifies that the system is to print the character string. The character string is associated with a security label (typically the security label of the user's current session). Your installation determines the character string used.
NODPAGELBL: specifies that the character string is to be suppressed. You must have the appropriate RACF® access authority to override page labeling. If you need to override DPAGELBL but are unable to, check your installation security procedures or see your RACF security administrator.

DUPLEX({N | NO | NORMAL | TUMBLE})

specifies whether or not printing is to be done on both sides of the sheet. The DUPLEX keyword overrides the duplex option from the forms definition, if any, specified by the FORMDEF keyword.

N or NO: specifies to print on one side only.
NORMAL: specifies that the physical page is rotated about the Y axis. For most page orientations (including the default orientation), the Y axis is the long edge of the sheet. This allows for binding on the long side of the sheet.
TUMBLE: specifies that the physical page is rotated about the X axis. For most page orientations (including the default orientation), the X axis is the short edge of the sheet. This allows for binding on the short side of the sheet.

If you do not specify DATACK, the DATACK specification from the PSF PRINTDEV statement is used. If it is not specified in the PRINTDEV statement, the default is BLOCK.

FCB(fcb_name)

specifies the name of the forms control buffer (FCB) or image to be used for the 3211, 3203-5, or 3800 printers. The name of the FCB is a 1 to 4 alphanumeric character string consisting of the last 1 to 4 characters of the following:

FCB2xxxx member for the 3211 or 3203-5 printer or printers supported by System Network Architecture (SNA)
FCB3xxxx member for the 3800 printer.

For more information about the forms control buffer, see:

z/OS DFSMSdfp Advanced Services
IBM 3800 Printing Subsystem Programmer's Guide

FLASH(overlay_name[,copies])

specifies the name of a forms overlay, which can be used by the 3800 Printing Subsystem. The overlay is "flashed" on a form or other printed information over each page of output. The forms overlay_name must be 1 to 4 alphabetic, numeric, or special characters #, $, or @. Optionally, you can specify the number of copies on which the overlay is to be printed. The count can range from 0 to 255. To flash no copies, specify a count of zero.

FORMDEF(member_name)

specifies the member name of a partitioned data set containing information that the Advanced Function Printer (AFP 3800-3 or 3800-8) uses to print a data set. The member can contain the following information:

The overlays that are to be invoked during output processing
The location on the page where the overlays are to be placed
The suppressions that can be activated for specified page formats.

The member name contains a maximum of 6 characters, of which the first 2 are predefined by your installation. For the last 4 characters, specify alphabetic, numeric, or the special characters #, $, or @.

FORMLEN(physical page length)

specifies the numerical length and unit type that PSF will use to change the physical paper length without reconfiguring the printer.

FORMLEN (nn.nnnUU)

size: nn.nnn, where n is a digit 0-9. A maximum of two digits to the left of the decimal point and three digits to the right are allowed. The decimal point and the three digits to the right of the decimal point are optional. If a number less than 1 is desired, a 0 must appear to the left of the decimal point (for example, 0.5IN).
units: UU, where UU is either IN for inches or CM for centimeters.

FORMS(forms_name)

specifies the name of the form on which the output is to be printed. Specify 1 to 8 alphabetic, numeric, or the special characters #, $, or @ for the forms name.

If you do not specify FORMS, JES uses the installation default specified at initialization.

FSSDATA(value)

allows arbitrary values to be passed from a spooling product to an FSA or other despooler.

value: 1-127 EBCDIC text characters.

GROUPID(output_group_name)

specifies the name to be used by JES to identify which of a job's SYSOUT data sets are to form an output group. The output group name consists of 1 to 8 alphanumeric characters and is selected by the system programmer to define an output group for the job.

INDEX(nn)

specifies a value indicating the data set indexing print offset (to the right) for the 3211 printer with the indexing feature. The width of the print line is reduced by the value of INDEX. Specify a value from 1 to 31. The value 1 indicates flush left. The values 2 to 31 indent the print line by nn-1 positions.

The default is 1, which indicates flush left.

INTRAY(nnn)

Specifies the paper source.

nnn: 1-255.

LINDEX(nn)

specifies a value indicating the data set indexing print offset (to the left) for the 3211 printer with the indexing feature. The width of the print line is reduced by the value of LINDEX. Specify a value from 1 to 31. The value 1 indicates flush right. The values 2 to 31 move the right margin over by nn-1 positions.

The default is 1, which indicates flush right. LINDEX is ignored on printers other than the 3211 printer.

LINECT(nnn)

specifies the number of lines that are to be printed before overflow processing. Specify a value from 0 to 255. If you specify zero, no overflow processing is done.

If you do not specify LINECT, JES obtains the value from one of the following:

The LINECT field of the accounting information parameter on the JCL JOB statement.
The installation default specified at JES initialization.

MAILBCC(username,...)

specifies one or more e-mail addresses of the blind secondary e-mail recipients.

1-32 addresses can be specified, each address can be up to 60 characters.

MAILCC(username,...)

specifies one or more e-mail addresses of the secondary e-mail recipients.

1 to 32 addresses can be specified, each address can be up to 60 characters.

MAILFILE(name of attachment)

specifies the name to use for the attached file when an attachment is included in an e-mail.

The name can be up to 60 characters.

MAILFROM(sender name)

specifies a name or other information that identifies who the e-mail is from.

The information can be up to 60 characters.

MAILTO(username,...)

specifies one or more e-mail addresses of the primary e-mail recipients.

1 to 32 addresses can be specified, each address can be up to 60 characters.

MODIFY(module_name[,trc])

specifies the name of a copy modification module, which is loaded into the 3800 or 3900 Printing Subsystem. This module contains predefined data such as legends, column headings, or blanks. The module specifies where and on which copies the data is to be printed. USE IEBIMAGE to define and store the module in the SYS1.IMAGELIB system data set. Specify 1 to 4 alphabetic, numeric, or the special characters #, $, or @ for the module_name.

The table reference character (TRC) corresponds to the character set(s) specified on the CHARS operand. Values are 0 for the first table-name, 1 for the second, 2 for the third, or 3 for the fourth.

NAME(preferred_name)

specifies the preferred name to be associated with the SYSOUT. The name prints on the separator pages to identify the owner of the SYSOUT. You can specify from 1 to 60 EBCDIC characters. See Coding rules for the valid characters allowed with and without quotation marks.

NOTIFY({user_id | node.user_id} ...)

specifies the user ID that is to receive a print completion message. The message identifies the output that has completed printing and indicates whether the printing was successful. You can specify 1 to 4 user IDs to which to send the print completion message.

A JES2 system issues the print complete message when all the SYSOUT data sets for an output group have printed. An output group consists of the SYSOUT data sets printed between the output header page and the output trailer page of a job. A JES3 system issues the print complete message when the SYSOUT data sets for the same printer and the same job have printed.

If you do not specify node, NOTIFY defaults to the node where the job was submitted.

OFFSETXB(x offset on back side of page)

specifies the offset in the x direction from the page origin (or partition origin for N_UP) for the back side of each page of output.

offset

mmmm(.nnn)UU where:

mmmm, nnn

decimal digits.

UU

the units either:

IN for inches, CM for centimeters.
MM for millimeters, PELS or POINTS.
If units are PELS or POINTS, a whole number must be specified. (example: 12.345MM or 678PELS)

OFFSETXF(x offset on front side of page)

specifies the offset in the x direction from the page origin (or partition origin for N_UP) for the front side of each page of output.

offset

mmmm(.nnn)UU where:

mmmm, nnn

decimal digits.

UU

the units either:

IN for inches, CM for centimeters.
MM for millimeters, PELS or POINTS.
If units are PELS or POINTS, a whole number must be specified. (example: 12.345MM or 678PELS)

OFFSETYB(y offset on back side of page)

specifies the offset in the y direction from the page origin (or partition origin for N_UP) for the back side of each page of output.

offset

mmmm(.nnn)UU where:

mmmm, nnn

decimal digits.

UU

the units either:

IN for inches, CM for centimeters.
MM for millimeters, PELS or POINTS.
If units are PELS or POINTS, a whole number must be specified. (example: 12.345MM or 678PELS)

OFFSETYF(y offset on front side of page)

specifies the offset in the y direction from the page origin (or partition origin for N_UP) for the front side of each page of output.

offset

mmmm(.nnn)UU where:

mmmm, nnn

decimal digits.

UU

the units either:

IN for inches, CM for centimeters.
MM for millimeters, PELS or POINTS.
If units are PELS or POINTS, a whole number must be specified. (example: 12.345MM or 678PELS)

OUTBIN(output_bin_id) ¹

specifies the media destination for the SYSOUT data set to be processed by JES2 or by JES3. output_bin_id specifies the identifier of the printer output bin on the IBM® family of Advanced Function Printers supporting multiple output bins.

The valid range for output_bin_id is 1 to 65,535. No default value is provided.

If no OUTBIN operand is given, the Print Services Facility (PSF) will stack the output in the default output bin.

If no output_bin_id value is provided with the OUTBIN operand (for example, OUTDES OUT1 OUTBIN is entered), the system will prompt you for the required value by issuing the following message:

ENTER PRINTER OUTPUT BIN ID

If a value for output_bin_id is specified that is not one of the supported ones, PSF will stack the output in the printer's default output bin and issue a message indicating that the requested bin is not available.

For more information about multiple media destinations and OUTBIN processing see PSF/MVS Application Programming Guide.

OUTDISP(normal_output_disp, abnormal_output_disp)

specifies the disposition(s) for the output data set for normal and abnormal program terminations.

normal_output_disp: is the disposition for the output data set when the job completes normally. The default for this parameter is WRITE, unless the installation has chosen a different default disposition.
abnormal_output_disp: is the disposition for the output data set when the job completes abnormally. This parameter defaults to the disposition specified in normal-output-disposition, if one was specified. Otherwise, it defaults to the installation default (WRITE).

You can specify one of the following for either or both of the positional parameters:

WRITE: specifies that the output file is to be deleted immediately after processing.
HOLD: specifies that the output data is to be held until released by the TSO/E user or operator. Releasing the output changes its disposition to WRITE.
KEEP: specifies that the output file is to be processed. After processing, the data set disposition changes to LEAVE.
LEAVE: specifies that the output data is to be held until released by the TSO/E user or operator. Releasing the output changes its disposition to KEEP.
PURGE: specifies that the output data set should be deleted before processing.

OVERLAYB(overlay name for back page side)

specifies that the named medium overlay is to be placed on the back side of each sheet to be printed.

overlay: 1-8 characters, the first must be either alphabetic or $, #, @; the remaining may be alphanumeric or $, #, @.

OVERLAYF(overlay name for front page side)

specifies that the named medium overlay is to be placed on the front side of each sheet to be printed.

overlay: 1-8 characters, the first must be either alphabetic or $, #, @; the remaining may be alphanumeric or $, #, @.

OVFL()

specifies whether or not JES3 should test for page overflow on an output printer. (JES3 only)

PAGEDEF(member_name)

specifies the member of a partitioned data set containing information that the Advanced Function Printer (AFP) uses to print the data set. The member can contain the following information:

Logical page size and width
Fonts
Page segments
Multiple page types or formats
Lines within a page; for example, line origin, carriage controls, and spacing
Multiple logical pages on a physical page.

PIMSG[(YES,nnn) | (NO,nnn)]

specifies whether messages are to be printed. Values are 0 through 999. The value specifies that the system is to cancel the printing of the current data set after the specified number of errors have been either:

Detected by the functional subsystem (FSS), or
Reported to FSS by the printer.

PIMSG(YES): specifies that messages generated by FSS are to be printed. PIMSG(YES,16) is the default.
PIMSG(NO): specifies that messages are to be suppressed.

If you specify nnn as zero, the system does not cancel the printing of the current data set.

PORTNO(nnnnn)

specifies the TCP/IP port number at which the FSS (for example, IP Printway) connects to the printer.

nnnnn: 1-65535.

PRMODE(process_mode)

specifies the process mode to be used to schedule output data sets either to output devices running under a functional subsystem (FSS) or to an output device managed by JES. For a list of valid process modes, contact your system programmer. If you do not specify PRMODE, JES might determine the process mode based on the content of the data. Specify 1 to 8 alphabetic or numeric characters for the process mode.

Use PRMODE to indicate the type of processing you want for a data set. You can use it to direct JES scheduling of this data set to a particular output FSS or JES writer. You can also use PRMODE to request specific processing of a Network Job Entry (NJE) transmitted data set at the destination node without knowing the device name or a SYSOUT class.

PRTATTRS(attributename=value attributename=value ...)

specifies an Infoprint Server job attribute. The Infoprint Server User's Guide documents job attributes names and syntax for acceptable values.

PRTERROR(FSS-to_JES print-time error handling action)

specifies how a SYSOUT data set that has had printing terminated by a functional subsystem is to be released to JES.

DEFAULT: indicates the default functional subsystem action is to be taken.
QUIT: indicates the functional subsystem should release the data set as complete even if a terminating error occurred during printing.
HOLD: indicates the functional subsystem should request the data set to be held on the JES spool for possible corrective action if a terminating error occurred.

PRTOPTNS(IP-destined dataset additional options entity)

character string of 1 to 16 characters indicating the named entity that contains additional print options for an IP-destined data set that an FSS transmits.

See appropriate functional subsystem documentation for the specific syntax that the FSS supports.

PRTQUEUE(target-print-queue for IP-destined datasets)

character string of 1 to 127 characters indicating the target print queue for IP-destined data set that an FSS transmits.

See appropriate functional subsystem documentation for the specific syntax that the FSS supports.

PRTY(nnn)

specifies the initial selection priority for the data set. Specify a value from 0 to 255, where 0 is the lowest output processing priority and 255 is the highest output processing priority.

Note: The PRTY(n) option will be ignored, unless the JES2 initialization parameter OUTDEF PRTYOUT=YES is also specified. For details see z/OS JES2 Initialization and Tuning Reference or contact your JES2 system programmer.

REPLYTO(username)

specifies the e-mail address to which recipients of the e-mail should respond.

The address can be up to 60 characters.

RESFMT(Pnnn)

specifies the resolution used to format the print data set.

Pnnn: P240 or P300 (pels per inch).

RETAINF(cccccccccc, for IP-destined datasets)

character string of 1 to 10 characters indicating how long an FSS will hold on to an IP-destined data set after a failed transmission.

See appropriate functional subsystem documentation for the specific syntax that the FSS supports.

RETAINS(cccccccccc, for IP-destined datasets)

character string of 1 to 10 characters indicating how long an FSS will hold on to an IP-destined data set after a successful transmission.

See appropriate functional subsystem documentation for the specific syntax that the FSS supports.

RETRYL(nnnnn, for IP-destined datasets)

specifies the number of attempts an FSS will try for transmission of an IP-destined dataset.

nnnnn: 0-32767.

See appropriate functional subsystem documentation for the specific syntax that the FSS supports.

RETRYT(cccccccccc, for IP-destined datasets)

character string of 1 to 10 characters indicating how much time a functional subsystem will wait between retries of transmission attempts of a data set.

See appropriate functional subsystem documentation for the specific syntax that the FSS supports.

ROOM(room_identification)

specifies the room identification to be associated with the output data set. This room identification prints on the separator pages. You can specify from 1 to 60 EBCDIC characters. See Coding rules for the valid characters allowed with and without quotation marks.

SYSAREA | NOSYSAREA

SYSAREA: specifies that the output should include a system printable area. (See also NOSYSSAREA).
NOSYSAREA: specifies that the output should not include a system printable area. (See also SYSAREA).

THRESHLD(nnnnnnnn)

specifies the maximum number of records for the sysout data set. For more information see OUTDES command in the z/OS MVS JCL Reference. This applies to JES3 only.

TITLE(description_of_output)

specifies the report title to be associated with the output file. This title prints on the separator pages. You can specify from 1 to 60 EBCDIC characters. See Coding rules for the valid characters allowed with and without quotation marks.

TRC | NOTRC

TRC: specifies whether the data records contain table reference character (TRC) codes. The codes identify the font to be used to print each record.
A TRC code immediately follows the carriage control character, if any. Its value corresponds to either one of the four fonts specified by CHARS or one of the fonts in the PAGEDEF font list. PAGEDEF allows more than four fonts to be specified.
NOTRC: specifies that the data set does not contain TRC codes. NOTRC is the default.

UCS(character-set-code)

specifies universal character set, print train, or character-arrangement table for a 3800 Printing Subsystem.

character-set-code: 1-4 alphanumeric or $, #, @ characters.

USERDATA(value)

specifies the installation-defined values for the installation's prescribed processing. If your installation has defined further keywords through installation exits, that optional processing can be requested on the output descriptor with this keyword. Refer to your installation's definition for the intended use of this keyword operand.

You can code up to 16 installation-defined values for this keyword as previously specified by your installation. Each value can be 1 to 60 EBCDIC text characters. Apostrophes around each value are required if the string contains a blank, comma, tab, or semicolon; apostrophes are optional for all other EBCDIC characters. However, if the string contains an apostrophe, code two apostrophes and enclose the entire string in single apostrophes such as USERDATA('USERKEY1=User's value'). Null positions such as USERDATA(value_1,,value_3) or USERDATA(,value_2,value_3) are not allowed.

USERLIB(library_name {,library_name …})

specifies the data set name(s) of the libraries that contain the Advanced Function Printer (AFP) resources that the Print Services Facility (PSF) uses when processing the SYSOUT data set. The AFP resources that specify how the PSF is to print the SYSOUT data set are:

Fonts
Page Segments
Overlays
Pagedefs
Formdefs

Note: This parameter is not supported for PSF/MVS direct-attached printing.

You can use user libraries to maintain secure resources (such as signatures in private data sets), keep resources that are being tested in a private data set during the test period, or personalize and maintain your own library.

PSF searches for resources first in the resource libraries specified by USERLIB, then in the system-defined resources.

library_name specifies the data set name of a library containing the Advanced Function Printer (AFP) resources. The specified library can contain any AFP resources.

The data set name must follow the rules for MVS™ data set names. See z/OS MVS JCL Reference, for the rules regarding data set names. If the application supports the specification of unqualified data set names and you specify the USERLIB parameter without quotation marks, the specified data set name is concatenated to the system-defined high-level qualifier.

If you do not specify the USERLIB parameter, only the system and installation print resources are available for use.

A library is a partitioned data set (PDS). Member names are the same as the requested resource. When you create a member, the member name should be unique to all libraries in the search concatenation.

When you use the USERLIB keyword:

You must have read access (for example, via RACF) to libraries specified by USERLIB.
Libraries must be cataloged in a catalog that is available to PSF/MVS.
Libraries must be accessible to PSF while processing the SYSOUT data set.
Library data sets are dynamically deallocated after PSF has processed the SYSOUT data set.

See PSF/MVS Application Programming Guide for more information about the USERLIB keyword.

USERPATH(path,...)

names HFS or zFS file system paths containing resources to be used by Print Services Facility (PSF) when processing sysout data sets.

USERPATH={path, ... }

path is the path name only. It cannot include the file name.
you can omit the parentheses if you code only one path.
a USERPATH parameter can specify from 1 to 8 path subparameters.
USERPATH=(,path) is invalid.
if the path contains any special characters, blanks, or is continued to the next line, it must be enclosed in apostrophes.
the first character in path is a slash.
a path can be specified as a maximum of 255 characters including any blank characters.
see the PATH parameter on the DD statement for additional syntax rules.

WRITER(external_writer_name)

specifies a name for use in processing or selecting a SYSOUT data set. If you specify the external writer name, the output data set is written under the control of that external writer rather than the control of JES2 or JES3. The writer name can contain 1 to 8 alphabetic, numeric, or the special characters #, $, or @.

For more information about external writers, see z/OS MVS Using the Subsystem Interface.