Previous Topic: Rules for Defining Distribution IdentifiersNext Topic: Defining Basic Reports


Using the Report Definition Attributes Panel

Use the Report Definition Attributes panel to specify report attributes.

Report definition attributes are a set of parameters you specify for a report.

For example, the LATE report definition attribute indicates the time when a report is to be marked late if it is not queued for printing.

By default, the system uses the attributes specified in the Job Control Language (JCL) for the reports. There is generally no need to specify overrides to the attributes in the report definitions.

However, you might want to add or modify some of the non-JCL attributes for reports—for example, late time, archive criteria, report description, and special instructions.

CA Deliver ------------- Report Definition Attributes ------------------------ Command ===> ID ---> EDITREPT01 Job ---> TRJOB01 Step ---> EDITSTEP Procstep ---> DD ---> EDITLIST Type ---> Desc ===> Arch ID ===> Attributes: ARCH ===> BANNER ===> BURST ===> CC ===> CLASS ===> COPIES ===> FCB ===> FORM ===> FLASH ===> ( , ) LATE ===> OPTCDJ ===> UCS ===> FORMDF ===> PAGEDF ===> PRMODE ===> PRSET ===> PRTY ===> GRPID ===> CHARS ===> ( , , , ) MODIFY ===> ( , ) COPYG ===> ( , , , , , , , ) The following attributes may be selected by entering the 1-character selection code on the command input line: B - Bundle specifications. D - Distribution specifications. I - Special instructions. T - Report Identification text.

This list describes the attribute fields on the Report Definition Attributes panel:

Desc

The 1- to 40-character brief description of the report.

Arch ID

The 1- to 32-character archive report identifier.

Note:

If an Arch ID is provided, the report appears in CA View under that name.

This field is not displayed for dynamic type reports.

ARCH

Enter 1 to 99 sets of criteria for archiving reports

Each set of criteria (which you define by an initialization parameter) specifies the following:

You can enter a blank or a value between 0 and 99 in this field.

Valid values are:

0 - Suppress the archiving of a report

Blank - Use the default value defined by the initialization parameter ARCH

Note: For more information about the ARCH parameter, see the Reference Guide.

BANNER

Enter the name of the model banner page to print at the beginning and end of a report

Valid values are:

* - Suppress banner page printing

Blank - Print the default model banner page defined by the initialization parameter BANNER

Note: For more information about the BANNER initialization parameter, see the Reference Guide.

BURST

Specify whether a report is to be burst into separate sheets when it is printed on an IBM 3800 printer

Valid values are:

Y—Burst the report

N—Do nothing with the report

Blank—Use the value specified in the JCL for the job that created the report

CC

Enter the type of carriage control characters to use in the report

Valid values are:

M—Use machine control characters

A—Use ASA control characters

A single-character identifier—Use the set of control characters you define

Blank—Use the carriage control specification from the DCB/ACB for the report

CLASS

Enter the SYSOUT class for the report

Valid values are:

A single alphanumeric character—Use the SYSOUT class character you define

Blank—Use the SYSOUT class specified in the JCL for the job that created the report

COPIES

Specify whether to print the report on single- or multi-part paper

Valid values are:

Y or Blank—Use the copies DD parameter that specifies the number of grouped distribution identifiers to use when the report is written to spool

N—Assume COPIES = 1

Note: For more information about the copies DD parameter, see the Reference Guide.

FCB

Enter the name of the forms control image to use to print a report

Blank--the forms control image specified in the JCL for the job that created the report is used.

'*'--The forms control image specified in the JCL for the job that created the report is ignored, and the report is printed as if no forms control image had been specified.

FORM

Enter the name of the special form on which the report is to be printed or punched

Blank -- The forms control image specified in the JCL for the job that created the report is used.

Note: OUTPUT JCL statements might not be available for processing; in this case, only the first four characters of the form are used.

OUTPUT JCL can be unavailable if the initialization parameter OUTPUT is set to OUTPUT=NO or is set to the default.

FLASH

Enter the name of the forms overlay to be used when a report is to be printed on an IBM 3800 printer and the number of copies is to be flashed with the overlay

Blank --, The forms overlay name and count specified in the JCL for the job that created the report is used.

'*’ -- The forms overlay name and count specified in the JCL for the job that created the report is ignored. The report is printed as if no forms overlay name and count had been specified.

LATE

Enter the time as a 24-hour clock in an hh:mm format when a report is to be marked late if it is not queued for printing

Example: 09:35 represents 9:35 a.m., and 15:45 represents 3:45 p.m.

Blank -- The system does not check to see if the report is late.

Note: When you specify the late time, enter 00:01 (not 00:00) and 23:59 (not 24:00).

OPTCDJ

Specify whether the report contains IBM 3800 printer table reference characters

Y—The report contains IBM 3800 printer table reference characters

N or Blank—The report does not contain IBM 3800 printer table reference characters

UCS

Enter the name of the special character set used to print a report

Blank--The character set name specified in the JCL for the job that created the report is used.

'*' -- The character set name specified in the JCL for the job that created the report is ignored and the report is printed as if no character set name had been specified.

FORMDF

Enter the name of the form definition used to print a report on an IBM 3800 printing subsystem

Blank--The form definition name specified in the JCL for the job that created the report is used.

Note: If OUTPUT JCL statements are not available for processing (that is, if the initialization parameter OUTPUT is set to OUTPUT=NO or is set to its default), the form definition name is ignored.

PAGEDF

Enter the name of the page definition to be used to print a report on an IBM 3800 printing subsystem

Blank--The page definition name specified in the JCL for the job that created the report is used.

OUTPUT JCL statements might not be available for processing; in this case, only the first four characters of the form are used.

Note: OUTPUT JCL can be unavailable if the initialization parameter OUTPUT is set to OUTPUT=NO or is set to the default,

PRMODE

Enter the process mode required to print a SYSOUT data set

Valid values are:

LINE—Sends the data set to a line mode printer

PAGE—Sends the data set to a page mode printer

Specific 1- to 8-character mode name—Sends the data set to a mode printer defined for your site

PRSET

Enter the name of the printer setup member in the database used for a report

You can use this member to enter XEROX DJDE parameters or for any other information that you want to precede the report data.

If specified, the printer setup records are appended to the report immediately after the report banner page but before the first record in the report.

If omitted, printer setup records are not appended to the report.

Note: You use the RMODBASE utility PLOAD control statement to add PRSET members to the database. For more information, see RMODBASE in the Reference Guide.

PRTY

Enter the priority for a SYSOUT data set to enter the output queue

You can specify a decimal value between 1 (lowest priority) and 255 (highest priority) or a space or 0. If a space or 0 is entered, it is treated as a null and it nullifies any existing PRTY value.

A higher priority data set prints sooner.

GRPID

Enter the 1-8 character name of the output group to be used when the report is printed. Groupid is only valid on JES2 systems. If an archival copy of the report is sent to a View FSS collector, this name identifies the member name in the SARINDEX data set which contains archive control statements for the report.

CHARS

Enter the names of the character arrangement tables that are used when a report prints on an IBM 3800 printer

Specify 1 to 4 names in this field.

Blank--The character arrangement table names specified in the JCL for the job that creates the report are used.

MODIFY

Enter the name of the copy modification module and table reference character used when a report prints on an IBM 3800 printer

Blank--The copy modification module name and table reference character that are specified in the JCL for the job that created the report are used..

COPYG

Enter the number of copies of each page that are to be grouped together when a report prints on an IBM 3800 printer

If blank, the IBM 3800 copy groups specified in the JCL for the job that created the report are used.