THRESHLD parameter - IBM-JCL

Parameter Type

Keyword, optional, JES3 only

Purpose

Use the THRESHLD parameter to specify the maximum size for the sysout data set. JES3 calculates the sysout data set size as the number of records multiplied by the number of copies requested. When this size exceeds the THRESHLD value, JES3 creates a new unit of work, on a data set boundary, and queues it for printing. Consequently, copies of the sysout data set may be printed simultaneously by different printers.

Use the THRESHLD parameter for jobs that generate many large data sets or many copies of one large data set.

Note: THRESHLD is supported only on JES3 systems.

1.Syntax

THRESHLD=limit

2.Subparameter Definition

limit
Specifies the maximum number of records for a single sysout data set. limit is a decimal number from 1 through 99999999

3.Defaults
If you do not code the THRESHLD parameter, JES3 uses an installation default specified at initialization.

4.Example of the THRESHLD Parameter

In this example, the report data sets, RPT1, RPT2, and RPT3, are processed in sysout class A. All three DD statements implicitly reference the step-level default OUTPUT JCL statement SYSDS3; therefore, the THRESHLD value specified in the OUTPUT JCL statement applies to the three reports combined. JES3 is to print the following:

Copies Data Records in Total Set Data Set Records 10 RPT1 1000 10000 2 RPT2 2000 4000 5 RPT3 500 2500
Total 16500

Because the total exceeds the THRESHLD limit, JES3 divides the sysout data sets into two units of work. RPT1 is printed as one unit, and the other two data sets are printed together as another unit. If the THRESHLD limit had been 20000, all three data sets would have been printed as one unit of work.

TITLE parameter

Parameter Type

Keyword, optional

Purpose

Use the TITLE parameter to print a description of the output on the separator pages of the output of a sysout data set. An installation can use the description to assist in sysout distribution.

1.Syntax

TITLE= {’description of output’} {description-of-output }

Valid Characters in Enclosing Apostrophes:

  • A description of output enclosed in apostrophes can contain any EBCDIC text character.
  • When the value for description of output contains a blank, enclose the value in apostrophes.
  • To code an apostrophe in the description of output, code 2 apostrophes, and enclose the description of output in single apostrophes. For example:
  • //OUTDS OUTPUT TITLE=’PRESIDENT’’S REPORT’
  • Each value may optionally be enclosed in apostrophes.

Valid Characters Without Enclosing Apostrophes: When the value for description of output is not enclosed in apostrophes, the following characters are valid:

  • Alphanumeric and national (@, $, #) characters
  • Period (.) and asterisk (*); however, an asterisk followed by a period indicates a referral and is not allowed as the start (first and second characters) of the value.
  • Ampersand (&). An ampersand that refers to a symbolic is substituted. Two consecutive ampersands are not substituted, but they will result in a single ampersand as part of the value.
  • Plus sign (+)
  • Hyphen (-)
  • Slash (/)

Symbolic Parameters: Do not enclose symbolic parameters in apostrophes. Symbolic parameters within apostrophes are not resolved for this keyword.

2.Subparameter Definition

description of output
Specifies a description of output to be associated with a sysout data set. The description of output is 1 - 60 EBCDIC text characters.

3.Example of the TITLE Parameter

//OUTDS5 OUTPUT TITLE=’ANNUAL REPORT’

In this example, ANNUAL REPORT is printed on the line reserved for title on the separator pages of any sysout data set referencing OUTDS5.

TRC parameter

Parameter Type

Keyword, optional

Purpose

Use the TRC parameter to specify whether the logical record for each output line in the sysout data set contains table reference character (TRC) codes or not. The TRC code identifies which font-name in the CHARS parameter is to be used to print the record.

If present, a TRC code in the output line record is:

  • The first byte, if a carriage control character is not used.
  • The second byte, immediately following the carriage control character, if used.

Note: TRC is supported only for a data set processed by the Print Services Facility (PSF).

1.Syntax

TRC= {YES} {Y } {NO } {N }

2.Subparameter Definition

YES
Indicates that the data set contains TRC codes. This subparameter can also be coded as Y.

NO
Indicates that the data set does not contain TRC codes. This subparameter can also be coded as N.

Note: The data set DCB must not indicate that the data set contains TRC codes. DCB=(OPTCD=J) overrides TRC=NO when the data set is printed by PSF.

3.Defaults
If you do not code the TRC parameter, the default is to use TRC characters only if the data set DD statement specified DCB=(OPTCD=J).

4.Relationship to Other Parameters
A table reference character for the entire data set can be specified in the OUTPUT JCL MODIFY parameter.

5.Example of the TRC Parameter

In this example, sysout DD statement DAILY implicitly references the default job-level OUTPUT JCL statement DS23. This OUTPUT JCL statement directs PSF to print the daily report on standard forms, using table reference characters. The sysout data set defined by DD statement DAILY contains carriage control characters in the first character of each logical record and a TRC code in the second character. The TRC characters in the records are 0 to use the font GT12; 1 to use GB12; and 2 to use GI12.


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

IBM-JCL Topics