Previous Topic: System VariablesNext Topic: Input Commands


Fields

The following are the fields on the Report Distribution Specifications subpanel and their descriptions:

Sel

Defines the tabular commands in this column.

Name

Defines the name of the variable to be used to reference data on the report page.

Specifies a 1 to 8 character name that consists of alphabetic, numeric, or national (@, #, or $) characters. The first character must start with an alphabetic or national character.

Line

Specifies the line number (1 to 255) where variable data is to be extracted from the page.

Column

Specifies the beginning column number (1 to 32760) where variable data is to be extracted from the page.

Note: Column number does not include the carriage control character.

Length

Specifies the length (1 to 32) of the variable data.

Type

Identifies the type of name that is being assigned.

Values are as follows:

REPT

Indicates that a report name is being assigned.

Can be abbreviated as “R” on input.

DIST

Indicates that a distribution name is being assigned.

Can be abbreviated as “D” on input.

A REPT entry must be defined first followed by the associated DIST entries for the report entry. Multiple DIST entries can be specified for a given report entry and multiple sets of REPT and DIST entries can also be specified.

Note: The Out, Dest, Writer/Eformat, Day MTWTFSS, Copies, Rview, Reprt, and Del fields are only applicable to DIST entries.

Report/Distribution ID

Specifies a 1 to 32 character name that identifies the report or distribution name (determined by the Type field) for the report pages.

The name is composed of text characters, variable names defined in variable specifications, and/or system variable names.

During distribution the variable name(s) are replaced with the associated variable data. Leading and trailing blanks are removed from the variable data before substitution.

Out

Specifies whether output is to be printed, tracked, untracked for view only, or emailed.

Values are as follows:

T

Creates tracked, view-only output

Y

Creates printed output

N

Creates view-only output (not printed or tracked)

E

Sends email notification to recipient

Dest

Specifies a destination where the report is to be printed.

Blank

Accepts the value specified in the JCL. Blank is the default

Writer/ EFormat

Specifies the name of an external writer to process the report.

Blank

Accepts the value specified on the Distribution Data panel or in the JCL used to create the report

'*' —If specified for this field, the external writer name specified in the JCL for the job that creates the report is ignored, and the report is printed without the external writer.

For reports that are being emailed (Out field set to E), this field specifies the name of the EFORMAT member to be used to format the email notification. If omitted, the EFORMAT member defined to the distribution identifier or defined on the EFORMAT initialization parameter is used.

Days MTWTFSS

Specifies the days of the week from Monday to Sunday that printed output or email notification can be generated.

Valid values for each of the days of week are as follows:

Y

Allows printed output or email notification

N

Prevents printed output or email notification

The default for days is YYYYYYY.

The day of the week by default is based on the day that the job was submitted and the setting of the BEGINDAY initialization parameter. Jobs submitted before the BEGINDAY setting is considered part of the previous day's cycle.

Copies

Specifies the number of copies to be sent to the recipient.

Rview

Specifies whether the recipient has restricted viewing privileges for the report within CA View, which provides viewing through non-secured logical views and prevents the use of the VIEW command.

Valid values are Y, N, and Blank.

Reprt

Specifies whether recipients can reprint the report within CA View.

Valid values are Y, N, and Blank.

Del

Specifies whether recipients can delete the archived version of the report or can alter the archive status within CA View.

Values are as follows:

Y

Permits the recipients to delete the archived version of the report or alter the archive status.

N

Prevents the recipients from deleting the report or altering the archive status.