ADDRESS parameter - IBM-JCL

Parameter Type

Keyword, optional

Purpose

Use the ADDRESS parameter to print an address on the separator pages of an output data set. An installation can use the address to assist in sysout distribution.

1.Syntax

ADDRESS= {(’delivery address’[,’delivery address’]...)} {delivery-address }

Valid Characters in Enclosing Apostrophes:

  • A delivery address enclosed in apostrophes can contain any EBCDIC text character.
  • Enclose a value that contains a blank in apostrophes.
  • To code an apostrophe in the delivery address, code 2 apostrophes, and enclose the entire delivery address in single apostrophes. For example:
  • //OUTDS OUTPUT ADDRESS=’O’’DARBY AVE’
  • Each value may optionally be enclosed in apostrophes.

Valid Characters Without Enclosing Apostrophes: When the value for delivery address 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 (/)

Null Subparameters: You may code a null subparameter to cause a blank line to appear in the delivery address. Code a comma to indicate the omitted subparameter.

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

2.Subparameter Definition

delivery address
Specifies the delivery address for the output data set. You can code up to 4 delivery addresses. Each delivery address can be 1 - 60 EBCDIC text characters.

3.Defaults

  • In an APPC scheduling environment:
  • In both JES2 and JES3 systems, if you do not code ADDRESS, the system uses the value defined in the transaction program (TP) user’s RACF profile when:
    – The user submitting the TP profile has a RACF profile defined for him, and
    – The transaction program profile includes TAILOR_SYSOUT(YES).
  • In a non-APPC scheduling environment:
  • There is no default for the ADDRESS parameter on the OUTPUT JCL statement.

4.Overrides

  • In an APPC scheduling environment:
  • In both JES2 and JES3 systems, the ADDRESS parameter on the OUTPUT JCL statement overrides the address in the RACF profile.
  • In a non-APPC scheduling environment:
  • In both JES2 and JES3 systems, there are no override considerations for ADDRESS.

5.Examples of the ADDRESS Parameter

Example 1

//OUTDS2 OUTPUT ADDRESS=(’J. Plant’,’1234 Main Street’, // ’POUGHKEEPSIE, NY’,’zipcd’)

In this example, the address

J. Plant
1234 Main Street
POUGHKEEPSIE, NY
zipcd

is printed on the separator pages of each output data set that references OUTDS2. You may code a name in the address field when the name associated with an address is not the name you want to associate with the output (coded on the OUTPUT NAME statement.) The name appears in the address field on the separator pages.

Example 2

//OUTDS3 OUTPUT ADDRESS=(,’57 FAIR LANE’,’OMAHA,NE’,12121)

In this example, the following address is printed on the separator pages of each output data set that references OUTDS3.

57 FAIR LANE
OMAHA,NE
12121

The first line reserved for the address on the separator page will be blank. Note that 12121 does not require enclosing apostrophes, because it contains only characters that are valid without them.

AFPSTATS parameter

Parameter Type

Keyword, optional

Purpose
Use the AFPSTATS keyword on the OUTPUT statement to indicate to the Print Services Facility (PSF) that an AFP Statistics (AFPSTATS) report is to be generated while printing this sysout data set. The AFPSTATS report can provide sysout data set processing detail for:

  • Determining in which resource libraries PSF found particular resources.
  • Diagnosing some resource selection problems.
  • Obtaining statistical data about the printing of a sysout data set. These statistics may contain some inaccuracies caused by error recovery and repositioning within the sysout data set that make them unsuitable for accounting purposes.
  • Diagnosing some sysout data set printing performance situations.

1.Syntax

AFPSTATS= {YES} {Y } {NO } {N }

2.Parameter Definition

YES
Requests that PSF produce an AFPSTATS report for the printing of this sysout data set. This parameter may also be coded as Y.

NO
Specifies that PSF should not produce an AFPSTATS report for the printing of this sysout data set. This parameter may also be coded as N.

3.Defaults
If you do not code an AFPSTATS keyword, PSF will assume the value NO.

4.Overrides
Specification of AFPSTATS=YES will be ignored on systems with a PSF older than PSF for OS/390 3.3.0.

The specification for the AFPSTATS keyword is exposed by PSF on the PSF Installation Exit.

The Installation Exit can override the user’s OUTPUT statement specification. When the Installation Exit overrides the OUTPUT statement specification of the AFPSTATS keyword, the user will receive a message in the sysout data set messages printed at the end of the sysout data set.

5.Relationship to Other Control Statements
Coding the AFPSTATS=YES keyword on the OUTPUT statement will not generate an AFPSTATS report unless the AFPSTATS DD statement in the PSF startup procedure has been coded. The AFPSTATS DD statement identifies the data set where PSF will place the AFPSTATS report. If you code the AFPSTATS keyword, but the PSF start-up procedure does not have a valid AFPSTATS DD statement, the sysout data set will be processed without PSF producing an AFPSTATS report.

6.Example of the AFPSTATS keyword

//OUT1 OUTPUT AFPSTATS=YES //PRINT DD SYSOUT=*,OUTPUT=*.OUT1

In this example, PSF will produce an AFPSTATS report for the sysout data set defined by the PRINT DD statement.


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

IBM-JCL Topics