/*OUTPUT statement - IBM-JCL

Purpose
Use the /*OUTPUT statement to specify characteristics and options for one or more sysout data sets. This statement supplies processing options in addition to and in place of the options specified on the sysout DD statement.

Note: You should use the OUTPUT JCL statement instead of the JES2 /*OUTPUT statement because of the OUTPUT JCL statement’s enhanced output processing capabilities.

1.Syntax

Syntax

The /*OUTPUT statement consists of the characters /* in columns 1 and 2, OUTPUT in columns 3 through 8, a blank in column 9, a code beginning in column 10, followed by a blank and the keyword parameters. JES2 ignores columns 72 through 80.

An * in column 10 indicates that this /*OUTPUT statement is a continuation of the previous /*OUTPUT statement: JES2 treats it as a continuation, even through the previous /*OUTPUT statement does not immediately precede the continuation.

Do not specify * in column 10 on the first /*OUTPUT statement in a job.

2.Parameter Definition

code
Identifies the /*OUTPUT statement. The code is 1 through 4 alphanumeric characters. To refer to a /*OUTPUT statement, the DD statement SYSOUT parameter must specify this code in its code-name subparameter. The referenced /*OUTPUT statement specifies processing options for the sysout data set defined in the referencing DD statement.

A code of * indicates that this /*OUTPUT statement is a continuation of the previous /*OUTPUT statement.

Note: If you specify the code-name subparameter on a DD statement SYSOUT parameter in a job or job step that contains a default OUTPUT JCL statement, JES2 uses the default OUTPUT JCL statement instead of the reference to the /*OUTPUT statement.

If more than one /*OUTPUT statement has the same code starting in column 10, JES2 uses the parameters from only the first /*OUTPUT statement.

BURST=Y
BURST=N
Indicates the default burst characteristic of all sysout data sets that JES2 produces for this job. BURST applies only when the data set is directed to a 3800 Printing Subsystem equipped with a burster-trimmer-stacker.

Y Requests that the 3800 output is to be burst into separate sheets.
N Requests that the 3800 output is to be in a continuous fanfold.

CHARS=xxxx
CHARS=(xxxx[,xxxx]...)
Names a font for all output that JES2 prints on an AFP printer in this job. The xxxx is 1 through 4 alphanumeric or national ($, #, @) characters. Code one to four names.

CKPTLNS=nnnnn
Specifies the maximum number of lines or cards contained in a logical page. The nnnnn is 1 through 5 decimal numbers from 0 through 32,767 for printers and 1 through 32,767 for punches. The default is specified in the JES2 initialization parameter for the device.

CKPTPGS=nnnnn
Specifies the number of logical pages to be printed before the next checkpoint is taken. The nnnnn is 1 through 5 decimal numbers from 1 through 32,767. The default is specified in the JES2 initialization parameter for the device.

COMPACT=nn
Specifies a compaction table for JES2 to use when sending this sysout data set, which must be a systems network architecture (SNA) data set, to a SNA remote terminal.

Note: The COMPACT parameter has no effect on compaction for NJE sessions; it applies only to SNA RJE sessions.

COPIES=nnn
COPIES=(nnn[,(group-value[,group-value]...)])
Specifies how many copies of the sysout data set are to be printed in page sequence order, or from an AFP printer, grouped by page.

If you route a job that has a COPIES parameter, the parameter will be used only if the receiving node is a JES2 node.

nnn
Specifies how many copies of the sysout data set are to be printed; each copy will be in page sequence order. The nnn is 1 through 3 decimal numbers from 1 through 255, subject to an installation-specified limit. For a data set printed on an AFP printer, JES2 ignores nnn if any group values are specified.

If you omit or incorrectly code the nnn parameter of COPIES, it defaults to 1 and a warning message is issued.

group-value
Specifies how many copies of each page are to be printed before the next page is printed. Each group-value is 1 through 3 decimal numbers from 1 through 255. You can code a maximum of eight group-values. Their sum must not exceed 255 or the installation-specified limit. The total copies of each page equals the sum of the group-values.

Note: This subparameter is valid only for output processed by PSF. For PSF-processed output, this subparameter overrides the nnn subparameter. The group-value subparameter of the COPIES parameter overrides the group-value subparameter of the COPYG parameter.

The following are not valid:

  • A null group-value, for example, COPIES=(5(,)) or COPIES=(5,)
  • A zero group-value, for example, COPIES=(5,(1,0,4))
  • A null within a list of group-values, for example, COPIES=(5,(1,,4))

COPYG=group-value
COPYG=(group-value[,group-value]...)
Specifies how many copies of each page are to be printed before the next page is printed. Each group-value is 1 through 3 decimal numbers from 1 through 255. You can code a maximum of eight group-values. Their sum must not exceed 255. The total copies of each page equals the sum of the group-values.

Note: This parameter applies only for output processed by PSF. If you code COPYG and JES2 prints the data set on an impact printer, JES2 ignores COPYG. The group-value subparameter of the COPIES parameter overrides the group-value subparameter of the COPYG parameter.

DEST=destination
DEST=(destination[,destination]...)
Note: JES2 initialization statements determine whether or not the node name is required when coding a userid.

Specifies one to four different destinations for the sysout data set. The destination subparameters follow:

ANYLOCAL
LOCAL
Indicates a local node on a local device.

name
Identifies a local or remote device by a symbolic name defined by the installation during JES2 initialization. The name is 1 through 8 alphanumeric or national ($, #, @) characters.

Nnnnn
Identifies a node. nnnn is 1 through 4 decimal numbers from 1 through 1000. For example, N0103.

NnnRmmmm
NnnnRmmm
NnnnnRmm
Identifies a node and a remote work station connected to the node. The node number, indicated in the format by n, is 1 through 4 decimal numbers from 1 through 1000. The remote work station number, indicated in the format by m, is 1 through 4 decimal numbers from 1 through 9999. Do not code leading zeros in n or m. The maximum number of digits for n and m combined cannot exceed six.

Note: NnnR0 is equivalent to LOCAL specified at node Nn.

nodename.userid
nodename:userid
nodename/userid
nodename(userid)
Identifies a destination node and a TSO/E or VM userid at that node. Use this parameter to route a sysout data set between JES2 nodes and non-JES2 nodes. The nodename is a symbolic name defined by the installation during initialization; nodename is 1 through 8 alphanumeric or national ($, #, @) characters. The userid must be defined at the node; userid for TSO/E is 1 through 7 alphanumeric or national ($, #, @) characters and for VM is 1 through 8 alphanumeric or national ($, #, @) characters.

Use the form nodename.userid to specify up to four destinations using continuation statements. The continuation statement must contain the characters /* in columns 1 and 2, OUTPUT in columns 3 through 8, a blank in column 9, an * in or following column 10, followed by one or more blanks, and the characters DEST= with the specified destinations. For example:

/*OUTPUT ABCD DEST=(POK.USER27,NYC.USER31) /*OUTPUT * DEST=(BOCA.USER58,STL.USER22)

Use the form nodename.userid to send the output to the VM user’s virtual reader.

Rnnnn
RMnnnn
RMTnnnn
Identifies a remote terminal. nnnn is 1 through 4 decimal numbers from 1 through 9999. Note that with remote pooling, the installation may translate this route code to another route code.

If you send a job to execute at a remote node and the job has a ROUTE PRINT RMTnnnn statement, JES2 returns the output to RMTnnnn at the node of origin. For JES2 to print the output at RMTnnnn at the executing node, code DEST=NnnnRmmm on an OUTPUT JCL statement or sysout DD statement.

Note: R0 indicates any local device.

Unnnn
Identifies a local terminal with special routing. nnnn is 1 through 4 decimal numbers from 1 through 9999.

If you send a job to execute and the job has a ROUTE PRINT Unnnn statement, JES2 returns the output to Unnnn at the node of origin.

Userid
Identifies a userid at the local node.

FCB=xxxx
Identifies the forms control buffer (FCB) image JES2 is to use to guide printing of the sysout data set. The xxxx is 1 through 4 alphanumeric or national ($, #, @) characters and is the last characters of a SYS1.IMAGELIB member name:

  • FCB2xxxx member, for a 3211 Printer, a 3203 Printer Model 5, or a printer supported by systems network architecture (SNA).
  • FCB3xxxx member, for a 3800 Printing Subsystem.
  • FCB4xxxx member, for a 4248 Printer.

IBM provides two standard FCB images. Code STD1 or STD2 only to request them.

  • STD1, which specifies 6 lines per inch on an 8.5-inch-long form. (3211 and 3203-5 only)
  • STD2, which specifies 6 lines per inch on an 11-inch-long form. (3211 and 3203-5 only)

If the printer on which JES2 is to print the data set does not have the forms control buffer feature, JES2 sends the operator a message to mount the proper carriage control tape.

FLASH=overlay-name
FLASH=(overlay-name[,count])
FLASH=NONE
Identifies the forms overlay to be used in printing the sysout data set on a 3800 Printing Subsystem and, optionally, specifies the number of copies on which the forms overlay is to be printed.

overlay-name
Identifies the forms overlay frame that the operator is to insert into the printer before printing begins. The name is 1 through 4 alphanumeric or national ($, #, @) characters.

Do not omit the overlay-name. The count subparameter is optional. If you omit it, you can omit the parentheses. However, if you omit it, you must not code it as a null; for example, FLASH=(ABCD,) is invalid.

Before printing starts, JES2 does not verify that the operator inserted the correct forms overlay frame for flashing.

count
Specifies the number, 1 through 255, of copies that JES2 is to flash with the overlay, beginning with the first copy printed.

JES2 determines the maximum number of copies to flash with the forms overlay by the value of nnn or the group-value total on the COPIES parameter. If the FLASH count value is greater than the value from the COPIES parameter, JES2 prints with the forms overlay the lower value.

The count subparameter of the FLASH parameter overrides the count value of the FLASHC parameter.

NONE
Suppresses flashing for this sysout data set.

Defaults: If you omit this parameter and did not specify FLASH on the DD statement or FLASHC on the /*OUTPUT statement, JES2 uses the default specified at JES2 initialization.

If you specify an overlay-name without specifying a count, JES2 flashes all copies. That is, the default for count is 255. If you specify 0 for count, JES2 also flashes all copies.

FLASHC=count
Specifies the number, 0 through 255, of copies that JES2 is to flash with the overlay, beginning with the first copy printed.

Note: For the 3800 printer, if you specify FLASH and omit FLASHC, JES2 flashes all copies.

The count subparameter of the FLASH parameter overrides the count value of the FLASHC parameter.

FORMS=xxxx
FORMS=STD
Identifies the forms on which JES2 is to print or punch the sysout data set.

xxxx
Identifies the print or punch forms. form-name is 1 through 4 alphanumeric or national ($, #, @) characters.

STD
Indicates that JES2 is to use the default specified at JES2 initialization.

INDEX=nn
Sets the left margin for output on a 3211 Printer with the indexing feature. The width of the print line is reduced by the INDEX parameter value. The nn specifies how many print positions the left margin on the 3211 output is to be indented. nn is a decimal number from 1 through 31. n=1 indicates flush-left; n=2 through n=31 indent the print line by n-1 positions.

JES2 ignores the INDEX parameter if the printer is not a 3211 with the indexing feature.

Note: INDEX and LINDEX are mutually exclusive; if you code both, JES2 uses the value you specified in INDEX.

LINDEX=nn
Sets the right margin for output on a 3211 Printer with the indexing feature. The width of the print line is reduced by the LINDEX parameter value. The nn specifies how many print positions the right margin on 3211 output is to be moved in from the full page width. nn is a decimal number from 1 through 31. n=1 indicates flush-right; n=2 through n=31 move the right margin over by n-1 positions.

JES2 ignores the LINDEX parameter on all printers except the 3211 with the indexing feature.

Note: INDEX and LINDEX are mutually exclusive; if you code both, JES2 uses the value you specified in INDEX.

LINECT=nnn
Specifies the maximum number of lines JES2 is to print on each output page. The nnn is a number from 0 through 255.

Specify LINECT=0 to keep JES2 from starting a new page when the number of lines exceeds the JES2 initialization parameter.

If you code LINECT on the /*OUTPUT statement, it overrides the LINECT value on the /*JOBPARM statement and the linect value in the accounting information parameter of the JOB statement.

If the LINECT parameter is omitted from the /*OUTPUT statement, JES2 obtains the value from one of the following sources, in order:

  1. The LINECT parameter on the /*JOBPARM statement.
  2. The linect field of the accounting information parameter on the JOB statement.
  3. The installation default specified at JES2 initialization.

MODIFY=module-name
MODIFY=(module-name[,trc])
Specifies a copy-modification module that tells JES2 how to print the sysout data set on a 3800 Printing Subsystem. The module can specify legends, column headings, blanks, and where and on which copies the data is to be printed. The module is defined and stored in SYS1.IMAGELIB using the IEBIMAGE utility program.

module-name
Identifies a copy-modification module in SYS1.IMAGELIB. The module-name is 1 through 4 alphanumeric or national ($, #, @) characters. Do not omit the module-name.

trc
Identifies which table-name in the CHARS parameter is to be used. This table reference character is 0 for the first table-name specified, 1 for the second, 2 for the third, or 3 for the fourth.

If you do not specify trc, the default is 0. If the trc value is greater than the number of table-names in the CHARS parameter, JES2 uses the first table named in the CHARS parameter.

The trc subparameter is optional. If you omit it, you can omit the parentheses. However, if you omit it, you must not code it as a null; for example, MODIFY=(TAB1,) is invalid. If you omit the trc subparameter, JES2 uses the first table-name.

The trc subparameter of the MODIFY parameter overrides the trc subparameter of the MODTRC parameter

MODTRC=trc
Identifies which table-name in the CHARS parameter is to be used. This table reference character is 0 for the first table-name specified, 1 for the second, 2 for the third, or 3 for the fourth.

If you do not specify trc, the default is 0. If the trc value is greater than the number of table-names in the CHARS parameter, JES2 uses the first table named in the CHARS parameter.

The trc subparameter of the MODIFY parameter overrides the trc subparameter of the MODTRC parameter.

UCS=xxxx
Identifies the universal character set (UCS) image JES2 is to use in printing the sysout data set. The xxxx is 1 through 4 alphanumeric or national ($, #, @) characters.

3.Overrides

  • /*OUTPUT statement parameters override all equivalent DD statement parameters.
  • If a /*OUTPUT statement contains duplicate parameters, the last parameter overrides all preceding duplicates, except for the DEST parameter.
  • Any parameter coded on subsequent /*OUTPUT statements overrides the same parameter on previous /*OUTPUT statements.
  • JES2 adds any parameter you code on subsequent /*OUTPUT statements that you did not code on previous /*OUTPUT statements to the previous /*OUTPUT statement.
  • If you code LINECT on the /*OUTPUT statement, it overrides the LINECT value on the /*JOBPARM statement and the linect value in the accounting information parameter of the JOB statement.

4.Relationship to Other Control Statements

  • JES2 processes /*OUTPUT statements placed after a /*ROUTE XEQ statement at the execution node only.
  • JES2 processes /*OUTPUT statements placed before a /*ROUTE XEQ statement at both the input node and the execution node.

5.Location in the JCL
Place the /*OUTPUT statement after the JOB statement. Do not include the /*OUTPUT statement in an instream procedure.

6.Example of the /*OUTPUT Statement

/*OUTPUT ABCD COPIES=6,COPYG=(1,2,3),DEST=RMT23

This statement refers to all sysout data sets defined by a DD statement that specifies SYSOUT=(c,,ABCD). Six copies of each page of output are printed. If the printer is an AFP printer, first one copy of each page is printed, then two copies of each page, and finally, three copies of each page. If the printer is not an AFP printer, COPYG is ignored and six copies of the entire data set are printed. The output is sent to remote terminal 23.


All rights reserved © 2018 Wisdom IT Services India Pvt. Ltd DMCA.com Protection Status

IBM-JCL Topics