JCL parameters
This information describes all of the JCL parameters that you might specify on the DD or OUTPUT JCL statements when you use Download for z/OS.
Figure 1 summarizes the JCL parameters that you might consider using when you are transmitting a data set for printing.
BUILDING=building
BURST={YES | NO}
CHARS=(font_names)
CKPTSEC=seconds
CLASS=class
COLORMAP=membername
COMSETUP=membername
COPIES=nnn
DATACK={BLOCK | UNBLOCK | BLKCHAR | BLKPOS }
DCB=OPTCD=J
DCB=RECFM={A | M}
DEPT=department
DEST=[node.]name
DEST='[node.]IP:ip_address'
DUPLEX={NO | NORMAL | TUMBLE}
FCB=pagedef_name
FORMDEF=formdef_name
FORMLEN=nn[.mmm]unit
FORMS=form_name
INTRAY=nnn
NAME=name
NOTIFY=([node.]userid)
OFFSETXB=nnnn[.mmm]unit
OFFSETXF=nnnn[.mmm]unit
OFFSETYB=nnnn[.mmm]unit
OFFSETYF=nnnn[.mmm]unit
OUTBIN=bin_number
OVERLAYB=overlay_name
OVERLAYF=overlay_name
PAGEDEF=pagadef_name
PRMODE={SOSI1 | SOSI2 | SOSI3 | SOSI4 | aaaaaaaa}
PRTQUEUE='print_queue_name'
RESFMT={P240 | P300}
ROOM=room
SEGMENT=page_count
SYSOUT=(class,,form_name)
TITLE=title
TRC={YES | NO}
UCS=font_name
Figure 2 summarizes the JCL parameters that you might consider using when you are transmitting a data set for archiving with OnDemand for AIX.
CLASS=class
DEST=[node.]name
FORMS=form_name
NOTIFY=(node.userid)
SEGMENT=page_count
SYSOUT=(class,,form_name)
Download for z/OS transmits all of the parameters that are shown in Figure 1 to each server on the remote system, except for the CKPTSEC, NOTIFY, and SEGMENT parameters.
- DD statement
- OUTPUT statement
- ADDRESS=(address_lines)
- Specifies up to four lines of address information to be sent to the remote server. Each line of
address information can contain 1 - 60 characters, separated with commas. Default: None.Example:
//OUTDS OUTPUT ADDRESS=('J. Plant','123 Main St.','BOULDER, CO','80301') - BUILDING=building
- Specifies 1 - 60 characters of building information to be sent to the remote server. Default: None.Example:
//OUTDS OUTPUT BUILDING='920' - BURST=YES | NO
- Specifies whether you want continuous-forms paper separated into single sheets with a
post-processing device that bursts, trims, or stacks, or sent to the continuous forms stacker.
- YES
- Specifies that the printed output is separated into separate sheets in the burster-trimmer-stacker (BTS).
- NO
- Specifies that the output is sent to the continuous-forms stacker (CFS) in continuous fanfold form.
Default: If you do not specify the BURST parameter, the default is NO.Example: You can specify the BURST parameter on the DD and OUTPUT statements, as shown.//DD1 DD BURST=YES//OUTDS OUTPUT BURST=NO - CHARS=(font_names)
- Specifies 1 - 4 coded font names that the remote print server uses to print a data set
containing line data. Do not include the 2-character prefix of the coded-font name (X0 through XG).
- For a remote PSF server, the fonts that you specify must be in a library that is assigned to the printer you are using or in a user library that is specified with the JCL USERLIB parameter, or else they must be inline with the print data set.
- For an AIX or Windows server, the fonts that you specify must be in a directory that is specified as part of the server search path, or be resident in the printer. For print servers that cannot print data sets that contain line data or mixed-mode data with inline fonts, consider using the AFP Conversion and Indexing Facility (ACIF) on the z/OS® operating system or the line2afp command in the AIX shell script or Windows Download for z/OS exit routine to convert such a data set to a MO:DCA-P data stream. For more information, see Using AFP resources for printing.
You can specify a font name in either the CHARS parameter or the UCS parameter. If you specify a font in both parameters, the font on the CHARS parameter is used. If the page definition used to print a data set specifies a font:
- A remote PSF server uses fonts in this order:
- The font that is specified in a page definition that is specified with the PAGEDEF or FCB parameter, including the JES default FCB for the printer.
- The font that is specified in the CHARS parameter.
- The font that is specified in a default page definition that is specified in the PSF startup procedure.
- AIX and Windows servers use the font that is specified in the page definition and ignore the font that is specified in the CHARS parameter.
Default: If no fonts are specified in the page definition, and if you do not specify either the CHARS or the UCS parameters, the default is the font set during Download for z/OS configuration. If no default was set, the remote print server uses the default font that is defined for the printer.Examples: You can specify the CHARS parameter on the DD and OUTPUT statements, as shown://DD1 DD CHARS=(60D8)//OUTDS OUTPUT CHARS=(60D8) - CKPTSEC=seconds
- Specifies the number of seconds to be taken between checkpoints of the data set as it is being
transmitted to the remote system; specify a number 1 - 32767, inclusive. Note: Do not specify the CKPTPAGE parameter because Download for z/OS does not support checkpointing by page. If you specify both CKPTPAGE and CKPTSEC:
- JES2 ignores the CKPTSEC parameter, unless your installation specified during JES2 initialization that checkpoints are to be based only on time.
- JES3 ignores the CKPTSEC parameter.
Consider these performance impacts when you choose an interval:- If the interval number is too low, resulting in many checkpoints, performance might be reduced because of the checkpointing processing required.
- If the number of seconds between intervals is too high, errors that require retransmittal of large amounts of data might reduce performance.
Default: Download for z/OS uses the default checkpoint interval that is specified during Download for z/OS configuration. If no default is specified, no checkpoints are taken.Example://OUTDS OUTPUT CKPTSEC=30 - CLASS=class
- Specifies the class of the data set to be sent to the remote server.
Download for z/OS might use the class that you specify, along with the destination and form names, to route the data set to a particular remote server.
You can specify an output class on two JCL statements:- The SYSOUT parameter on the DD statement.
- The CLASS parameter on an OUTPUT statement that is assigned to that DD statement. To specify a class on the OUTPUT statement, you must enter a null class in the DD SYSOUT parameter: SYSOUT=(,).
Note: Although this parameter is optional, you must specify either a class, form name, or destination name to direct the output to a remote system and server.Default: If you do not specify a class value in either the OUTPUT or the DD statement, the default class is A.Example://OUTDS OUTPUT CLASS=C //DD1 DD SYSOUT=(,),OUTPUT=(*.OUTDS) - COLORMAP=membername
- Specifies the object container member name of the color mapping table resource at
the receiver destination. Example: You can specify the COLORMAP parameter on the OUTPUT statement, as shown:
//OUTDS OUTPUT COLORMAP=MYCOLORM - COMSETUP=membername
- Specifies the object container member name of the microfilm setup resource at the
receiver destination. Example: You can specify the COMSETUP parameter on the OUTPUT statement, as shown:
//OUTDS OUTPUT COMSETUP=MYCOMSET - COPIES=nnn
- Specifies the copies value, 1 - 255, that is sent to the remote server.
Download for z/OS ignores any group values that you specify on this parameter; instead, specify group values in a form definition.
Default: One copy.Examples: You can specify the COPIES parameter on the DD and OUTPUT statements, as shown://DD1 DD COPIES=14//OUTDS OUTPUT COPIES=14 - DATACK={BLOCK | UNBLOCK | BLKCHAR | BLKPOS}
- Specifies the data blocking value to be sent to the remote server.
- BLOCK
- Specifies that the printer is not to report print-positioning or character errors that are not valid.
- UNBLOCK
- Specifies that the printer is to report all data-check errors. If a print-positioning error occurs, the exception is highlighted on the printed page to help you locate where the attempt to print outside the valid printable area occurred.
- BLKCHAR
- Specifies that the printer is not to report character errors that are not valid. Print-positioning errors are reported normally.
- BLKPOS
- Specifies that the printer is not to report print-positioning errors. Character errors that are not valid are reported normally.
Default: A default can be specified during Download for z/OS configuration. If no default is specified, the default is BLOCK.Example://OUTDS OUTPUT DATACK=UNBLOCK - DCB=OPTCD=J
- Specifies the DCB value to be sent to the remote server. This generally indicates that the print
data set contains table reference characters (TRCs). You can also specify TRCs on the TRC parameter
of the OUTPUT statement. Default: If you omit the TRC parameter and this parameter, the default is TRC=NO.Example:
//DD1 DD DCB=OPTCD=J - DCB=RECFM={A | M}
- Specifies whether ANSI or machine carriage-control characters exist in a data set containing
line data. If the data set contains AFP resources (such as page segments), specify that either ANSI
or machine carriage controls exist. Default: None.Example:
//DD1 DD DCB=RECFM=A - DEPT=department
- Specifies a 1- to 60-character department name to be sent to the remote server. Default: None.Example:
//OUTDS OUTPUT DEPT='PAYROLL' - DEST=[node.]name
- Specifies a destination name to be sent to the remote server. Specify a 1- to 8-character
destination name or a node and destination name.
Download for z/OS might use the destination that you specify, along with the class and form names, to route the data set to a particular remote server. Contact your system programmer to determine the correct destination to specify, depending on how Download for z/OS and the server are configured.
Note: Although this parameter is optional, you must specify either a class, form name, or destination name to direct the output to a remote system and server.If you specify the DEST parameter on the DD statement, you must also specify the SYSOUT parameter; otherwise, the system ignores the DEST parameter after it is checked for syntax.
For a Windows server, the supplied destination control file also uses the destination name as the target-printer-destination for the data set. Contact your Windows system programmer to determine the correct destination to specify.
Examples: You can specify the DEST parameter on the DD and OUTPUT statements, as shown://DD1 DD SYSOUT=R,DEST=PSF6000//OUTDS OUTPUT DEST=PSF6000 - DEST='[node.]IP:ipaddr'
- Specifies an IP address for the print data set. Specify 1 - 124 printable characters; the length
of the entire parameter list must not exceed 127 characters and must be enclosed in single quotation
marks.
This IP address does not affect the transmission of the data set to a remote system or server; Download for z/OS always uses the IP address that is specified in the routing-control data set to transmit a data set to a remote server. This field provides an extra value, which the shell script, destination control file, or exit routine on the remote server can optionally use to route a file to a particular printer attached to the remote server. In an AIX or Windows server, the administrator must modify the supplied shell script, destination control file, or exit routine to use this field.
Note: If you specify the DEST=IP parameter, you cannot also specify a destination name in the DEST JCL parameter. Therefore, if your system programmer configured the Download for z/OS FSA to select jobs that are based on destination name (that is, WS=R is specified as a JES work-selection criterion), or if your system programmer defined destination name as a routing criterion for the remote server in the routing-control data set, you must specify a destination name and cannot specify the DEST=IP parameter.Example://OUTDS OUTPUT DEST='IP:PRINTER629' - DUPLEX={NO | NORMAL | TUMBLE}
- Specifies the duplex value to be sent to the remote server and indicates whether printing is to
be done on one or both sides of each sheet.
- NO
- Requests printing on the front side of each sheet.
- NORMAL
- Requests printing on both sides of the sheet such that the sheets can be bound on the long edge of the paper.
- TUMBLE
- Requests printing on both sides of the sheet such that the sheets can be bound on the short edge of the paper.
Default: If you omit this parameter, an AIX or Windows server uses the value in the form definition.Example://OUTDS OUTPUT DUPLEX=NORMAL - FCB=pagedef_name
- Specifies the 1- to 4-character name of the page definition to be sent to the remote server. Do
not add the P1 prefix to the name of the page definition because Download for
z/OS adds the system prefix P1 to the name.
Because the FCB parameter allows a maximum of only 4 characters, the PAGEDEF parameter is preferred. For more information, see the description of the PAGEDEF parameter.
- FORMDEF=formdef_name
- Specifies the name of the form definition to be sent to the remote server. Specify a 1- to
6-character name. Do not add the F1 prefix to the name because Download for
z/OS adds F1 to the name that is specified in this
parameter.
For an AIX or Windows server:
- If the data set contains a MO:DCA-P data stream, the form definition that you specify must be in a directory that is specified in the server search path or can be included inline.
- If the data set contains line data or mixed-mode data, the form definition that you specify must be in a directory that is specified in the server search path. Because the server cannot print data sets that contain line data or mixed-mode data with an inline form definition, consider using the AFP Conversion and Indexing Facility (ACIF) on the z/OS system or the line2afp command in the AIX shell script or Windows exit routine to convert such a data set to a MO:DCA-P data stream. For more information, see Using AFP resources for printing.
To use an inline form definition in an AIX or Windows server, specify the name of the inline form definition or specify DUMMY as the name.Note: For the line2afp command, specify DUMMY only if the data set does not contain line data or mixed-mode data. If you specify DUMMY, the line2afp command uses the first inline form definition found; however, if no inline form definition is found, the line2afp command looks for a form definition that is named DUMMY in the AIX or Windows resource directories. For more information, see Identifying the data type for printing.Default: The default is the form definition name that is specified during Download for z/OS configuration. If no default is specified, an AIX or Windows server uses the default that is established by the system administrator.Example: This example specifies F1USER10 as the form definition.//OUTDS OUTPUT FORMDEF=USER10 - FORMLEN=nn[.mmm]unit
- Specifies the length of the form (paper) to be sent to the remote server.
Download for
z/OS converts all values to
millimeters.
Together with FORMDEF, this parameter allows the length of the form that is
specified in JCL to override the value that is configured at Intelligent Printer Data Stream (IPDS)
printers that support Set Media Size. Generally, FORMS is also used to have the operator load the
correct paper. - nn
- Specifies a one- or two-digit number, which can be zero. This value is required.
- .mmm
- Specifies a decimal point (period) followed by 1 - 3 digits. This value is optional.
- unit
- Specifies the unit of measure:
- IN
- Specifies a unit of inches.
- CM
- Specifies a unit of centimeters.
Download for
z/OS converts all values to
millimeters.
Default: If you do not specify this value, then the printer's default paper length is used.Example: This example sets a paper length of 9.5 inches in the output statement://OUTPUT1 OUTPUT FORMLEN=9.5IN //DD1 DD SYSOUT=class,OUTPUT=(*.OUTPUT1) - FORMS=form_name
- Specifies the 1- to 8-character form name to be sent to the remote server. An AIX or Windows server can print the form name on the header, trailer, or separator
pages, if the correct user exit is activated.
The form name that you specify does not result in any forms setup messages on the remote server.
Download for z/OS might use the form name that you specify, along with the class and destination values, to route the data set to a particular remote server. Contact your system programmer to determine the correct form name to specify, depending on how Download for z/OS is configured.
Notes:- Although this parameter is optional, you must specify either a class, form name, or destination name to direct the output to a remote system and server.
- JES3 does not pass the form name to the Download for z/OS FSA unless you specify the form name as a work-selection criteria. Therefore, in the JES3 environment, to pass FORM to an AIX or Windows server or OnDemand, specify form name as a work-selection criteria and specify form name as a selection criteria in the routing-control data set.
Default: If you do not specify a form name on either the OUTPUT or the DD statement, JES uses an installation default.Example://OUTDS OUTPUT FORMS=BILLS - INTRAY=nnn
- Specifies an input tray number 1 - 255 to be sent to the remote server. The input tray number
identifies the tray from which paper is to be selected. To determine the input tray identifiers for
your printer, see your printer documentation. Default: If you omit this parameter, a remote print server uses the value in the form definition.Example: This example specifies that paper is to be taken from the side tray of an IBM® 3160 printer with the optional side tray installed. The optional side tray of a 3160 printer is identified as tray 4.
//OUTDS OUTPUT INTRAY=4 - NAME=name
- Specifies a 1- to 60-character name to be sent to the remote server. Default: None.Example:
//OUTDS OUTPUT NAME='R. ROPER' - NOTIFY=([node.]userid ...)
- Specifies up to four user IDs that Download for
z/OS is to notify when the data set is successfully or unsuccessfully transmitted to the remote
system; separate the user IDs with commas.
Download for z/OS notifies the user IDs when the transmission is successful, the data set is held by the system because of an error, or the operator cancels the data set. The notification message is also sent to the SYSLOG data set.
Default: None.Example://OUTDS OUTPUT NOTIFY=(SEATTLE.JOE,SEATTLE.MARY) - OFFSETXB=nnnn[.mmm]unit
- Specifies the OFFSETXB value to be sent to the remote server. OFFSETXB is the offset in the x
direction of the logical page origin from the media origin for the back side of each sheet.
- nnnn
- Specifies a one- to four-digit number, which can be zero. This value is required.
- .mmm
- Specifies a decimal point (period) followed by 1 - 3 digits. This value is optional.
- unit
- Specifies the unit of measure:
- IN
- Specifies a unit of inches.
- CM
- Specifies a unit of centimeters.
- MM
- Specifies a unit of millimeters.
- PELS
- Specifies a unit of picture elements (1/240 inch).
- POINTS
- Specifies a unit of points (1/72 inch).
Default: A remote print server uses the value in the form definition.Example: This example sets the page origin to 0.5 inches, 1.1 inches on the front side and 1.5 inches, 1.1 inches on the back side.//OUTDS OUTPUT OFFSETXF=0.5IN,OFFSETYF=1.1IN,OFFSETXB=1.5IN,OFFSETYB=1.1IN - OFFSETXF=nnnn[.mmm]unit
- Specifies the OFFSETXF value to be sent to the remote server. OFFSETXF is the offset in the x
direction of the logical page origin from the media origin for the front side of each sheet.
- nnnn
- Specifies a one- to four-digit number, which can be zero. This value is required.
- .mmm
- Specifies a decimal point (period) followed by 1 - 3 digits. This value is optional.
- unit
- Specifies the unit of measure:
- IN
- Specifies a unit of inches.
- CM
- Specifies a unit of centimeters.
- MM
- Specifies a unit of millimeters.
- PELS
- Specifies a unit of picture elements (1/240 inch).
- POINTS
- Specifies a unit of points (1/72 inch).
Default: A remote print server uses the value in the form definition.Example: This example sets the page origin to 0.5 inches, 1.1 inches on the front side and 1.5 inches, 1.1 inches on the back side.//OUTDS OUTPUT OFFSETXF=0.5IN,OFFSETYF=1.1IN,OFFSETXB=1.5IN,OFFSETYB=1.1IN - OFFSETYB=nnnn[.mmm]unit
- Specifies the OFFSETYB value to be sent to the remote server. OFFSETYB is the offset in the y
direction of the logical page origin from the media origin for the back side of each sheet.
- nnnn
- Specifies a one- to four-digit number, which can be zero. This value is required.
- .mmm
- Specifies a decimal point (period) followed by 1 - 3 digits. This value is optional.
- unit
- Specifies the unit of measure:
- IN
- Specifies a unit of inches.
- CM
- Specifies a unit of centimeters.
- MM
- Specifies a unit of millimeters.
- PELS
- Specifies a unit of picture elements (1/240 inch).
- POINTS
- Specifies a unit of points (1/72 inch).
Default: A remote print server uses the value in the form definition.Example: This example sets the page origin to 0.5 inches, 1.1 inches on the front side and 1.5 inches, 1.1 inches on the back side.//OUTDS OUTPUT OFFSETXF=0.5IN,OFFSETYF=1.1IN,OFFSETXB=1.5IN,OFFSETYB=1.1IN - OFFSETYF=nnnn[.mmm]unit
- Specifies the OFFSETYF value to be sent to the remote server. OFFSETYF is the offset in the y
direction of the logical page origin from the media origin for the front side of each sheet.
- nnnn
- Specifies a one- to four-digit number, which can be zero. This value is required.
- .mmm
- Specifies a decimal point (period) followed by 1 - 3 digits. This value is optional.
- unit
- Specifies the unit of measure:
- IN
- Specifies a unit of inches.
- CM
- Specifies a unit of centimeters.
- MM
- Specifies a unit of millimeters.
- PELS
- Specifies a unit of picture elements (1/240 inch).
- POINTS
- Specifies a unit of points (1/72 inch).
Default: A remote print server uses the value in the form definition.Example: This example sets the page origin to 0.5 inches, 1.1 inches on the front side and 1.5 inches, 1.1 inches on the back side.//OUTDS OUTPUT OFFSETXF=0.5IN,OFFSETYF=1.1IN,OFFSETXB=1.5IN,OFFSETYB=1.1IN - OUTBIN=bin_number
- Specifies the value of the output bin to be sent to the remote server. Default: The default is either the value in the form definition or the value that is established by the system administrator for the remote server.Example:
//OUTDS OUTPUT OUTBIN=2 - OVERLAYB=overlay_name
- Specifies the name of a medium overlay to be sent to the remote server. This overlay is typically placed on the back side of each page. The complete name of the overlay must be given; Download for z/OS does not add an O1 prefix.
- OVERLAYF=overlay_name
- Specifies the name of a medium overlay to be sent to the remote server. This overlay is typically placed on the front side of each page. The complete name of the overlay must be given; Download for z/OS does not add an O1 prefix.
- PAGEDEF=pagedef_name
- Specifies the name of the page definition to be sent to the remote server that formats a data
set containing line data; specify a 1- to 6-character name. Do not specify the P1 prefix to the name
because Download for
z/OS adds P1 to the name that is
specified in this parameter.
For an AIX or Windows server:
- If the data set contains a MO:DCA-P data stream, the page definition that you specify must be in a directory that is specified in the server search path or can be included inline.
- If the data set contains line data or mixed-mode data, the page definition that you specify must be in a directory that is specified in the server search path. Because the server cannot print data sets that contain line data or mixed-mode data with an inline page definition, consider using the AFP Conversion and Indexing Facility (ACIF) on the z/OS system or the line2afp command in the AIX shell script or Windows exit routine to convert such a data set to a MO:DCA-P data stream. For more information, see Using AFP resources for printing.
To use an inline page definition in an AIX or Windows server, specify the name of the inline page definition or specify DUMMY as the name.
Note: For the line2afp command, specify DUMMY only if the data set does not contain line data or mixed-mode data. If you specify DUMMY, the line2afp command uses the first inline page definition found; however, if no inline page definition is found, the line2afp command looks for a page definition that is named DUMMY in the AIX or Windows resource directories.You can also specify a page definition in the FCB parameter. If you specify a page definition in both the PAGEDEF and FCB parameters, the page definition that is specified in the PAGEDEF parameter is used.
Default: If you omit the FCB parameter and the PAGEDEF parameter, the default is the page definition name that is specified during Download for z/OS configuration. If no default is specified, an AIX or Windows server uses the default that is established by the system administrator.Example: This example specifies P1USER10 as the page definition.//OUTDS OUTPUT PAGEDEF=USER10 - PRMODE={SOSI1 | SOSI2 | SOSI3 | SOSI4 | aaaaaaaa}
- Specifies the processing mode value to be sent to the remote server. PRMODE indicates the
processing mode of the data set and whether optional processing of the data must be done.
- SOSI1
- Specifies that each shift-out, shift-in code is converted to a blank and a Set Coded Font Local text control.
- SOSI2
- Specifies that each shift-out, shift-in code is converted to a Set Coded Font Local text control.
- SOSI3
- Specifies that each shift-in code is converted to a Set Coded Font Local text control and two blanks. A shift-out code is converted to a Set Coded Font Local text control.
- SOSI4
- Specifies that each shift-out, shift-in code is to be skipped and not counted when offsets for the data set are calculated. SOSI4 is used when double-byte character set (DBCS) text is converted from ASCII to EBCDIC. When SOSI4 is specified, the page definition offsets are correct after conversion; therefore, the user does not need to account for SOSI characters when FIELD offsets are computed.
- aaaaaaaa
- Specifies any string that is defined in the JES initialization parameters for Download for z/OS. LINE and PAGE are examples of PRMODE values that JES uses for job routing information.
Note: Download for z/OS transmits only the SOSI1, SOSI2, SOSI3, and SOSI4 values to the remote system.Default: JES assigns a value of LINE or PAGE.Example://OUTDD OUTPUT PRMODE=SOSI1 - PRTQUEUE='print_queue_name'
- Specifies the name of a print queue to be sent to the remote server. A print queue is used for
printing the data set. Specify any printable character string 1 - 127 characters, and enclose the
string in single quotation marks. You do not need to specify the DEST=IP parameter with the PRTQUEUE
parameter. Default: None.Examples: The first example shows the PRTQUEUE parameter with the DEST=IP parameter. The second example shows the PRTQUEUE parameter without the DEST=IP parameter.
//OUTDS OUTPUT DEST='PSF6000.IP:ATLANTA',PRTQUEUE='PRINTER619'//OUTDS OUTPUT PRTQUEUE='PRINTER619' - RESFMT={P240 | P300}
- Specifies the resolution at which the output was formatted. A remote PSF server uses this value
to choose the correct resolution system library. An AIX or Windows
server can use this value to print the data set on a printer that supports the specified font
resolution. Default: None. If you omit this parameter and if no font resolution is specified in the data stream, PSF uses the default resolution system library. An AIX or Windows server uses the default font resolution that is defined by the printer.Example:
//OUTDS OUTPUT RESFMT=P240 - ROOM=room
- Specifies a 1- to 60-character room name to be sent to the remote server. Default: None.Example:
//OUTDS OUTPUT ROOM='CONFERENCE ROOM' - SEGMENT=page_count
- Specifies that the output data set is to be segmented into separate data sets, where
page_count specifies the number of pages to be included in each data set.
Each data set is transmitted separately to the remote system, along with a segment ID, a number to
indicate the position of the segment in the original data set.
Use this parameter only with line-mode data; do not use this parameter if you requested conditional processing in the form definition because conditional processing is not supported across data set boundaries.
Download for z/OS transmits the segment ID of each segmented data set to the remote system. An AIX or Windows server can print the segment ID on the header, trailer, or separator pages, if the correct user exit is activated.
Default: The data set is not segmented.Example://DD1 DD SEGMENT=100 - SYSOUT=(class,,form_name)
- Specifies the class and form name.
- class
- Specifies a 1-character alphanumeric class.
- form_name
- Specifies a 1- to 4-character form name.
You can also specify the output class and form name in the CLASS and FORMS parameters of the OUTPUT statement. To specify a form name longer than 4 characters, you must use the FORMS parameter of an OUTPUT statement. See the description of the CLASS and FORMS parameters for more detail about these parameters.
Note: Although this parameter is optional, you must specify either a class, form name, or destination name to direct the output to a remote system and server.Default: If you do not specify a class on either the OUTPUT or the DD statement, the default class is A. If you do not specify a form name on either the OUTPUT or the DD statement, JES uses an installation default.Examples: This example specifies class R and form name BILL.//DD1 DD SYSOUT=(R,,BILL)To specify class in an OUTPUT statement instead of the DD statement, code a null value for the class in the SYSOUT parameter, as shown://OUTDS OUTPUT CLASS=R //DD3 DD SYSOUT=(,),OUTPUT=(*.OUTDS) - TITLE=title
- Specifies a 1- to 60-character description of the output data set to be sent to the remote
server. Default: None.Example:
//OUTDS OUTPUT TITLE='ANNUAL REPORT' - TRC=YES | NO
- Specifies the TRC value to be sent to the remote server and indicates whether the print data set
contains table reference characters (TRCs). You can also specify TRCs in the DCB parameter of the DD
statement. Default: If you do not specify DCB=OPTCD=J or the TRC parameter, the default is TRC=NO.Example:
//OUTDS OUTPUT TRC=YES - UCS=font_name
- Specifies the name of one coded font to be sent to the remote server and used for a data set
containing line data. Do not include the 2-character prefix of the coded-font name (X0 through XG).
You can specify a font name in either the CHARS parameter or the UCS parameter. If you specify a font in both parameters, the font on the CHARS parameter is used. If the page definition used to print a data set specifies a font:
- A remote PSF server uses fonts in this order:
- The font that is specified in a page definition that is specified by using the PAGEDEF or FCB parameter, including the JES default FCB for the printer.
- The font that is specified in the UCS parameter.
- The font that is specified in a default page definition that is specified in the PSF startup procedure.
- An AIX or Windows server uses the font that is specified in the page definition and ignores the font that is specified in the UCS parameter.
Default: If no fonts are specified in the page definition, and if you do not specify either the CHARS or UCS parameter, the default is the font that is specified during Download for z/OS configuration. If no default was specified, the remote print server uses the default font that is defined for the printer.Examples: You can specify the UCS parameter on the DD and OUTPUT statements, as shown://DD1 DD UCS=60DB//OUTDS OUTPUT UCS=60DB - A remote PSF server uses fonts in this order: