Batch Processing › SARBCH Control Statements › PRINTIDX

PRINTIDX

The PRINTIDX control statement allows printing of index data for a specific logical view of a report. The report is written to the JES spool or directed to a specific DD statement. For JES spool output, you can designate a SYSOUT class, destination, forms, and other attributes for the SYSOUT data set.

Syntax:

/PRINTIDX  BANNER=name
           CHARS=(xxxx xxxx xxxx xxxx)
           CLASS=x
           DDNAME=xxxxxxxx
           DEST={destid.userid|subsysid.destid}
           FORM=xxxxxxxx
           FORMDEF=xxxxxx
           GEN=nnnnn
           ID=id
           INDEX=xxxxxxxx
           PAGEDEF=xxxxxx
           PRMODE=xxxxxxxx
           SELECT=(xxxxxxxx,…)
           SEQ=nnnnn
           VIEW=(nnn,viewid,userid)
           WRITER=xxxxxxxx

where:

BANNER=name

Specifies the name of the model banner page to be used for producing beginning and ending banner pages for the report.

If omitted, the user's default banner page is used.

You can specify * for name to bypass printing of banner page data.

CHARS=
(xxxx xxxx xxxx xxxx)

Specifies a set of character arrangement table names for the 3800 printer to be used for printing the index data.

A value of one to four names separated by one or more blanks and/or commas and enclosed in parentheses can be specified.

CLASS=x

Specifies the SYSOUT class to which the index data is to be printed.

DDNAME=
xxxxxxxx

Specifies the DD statement name to which the index data is printed

If the DCB attributes for the DD statement are omitted, the following values are used:

• A record format of VBM
• A record size of the SYSOUT group record size plus 4 but not less than 137
• A block size of 32760

DEST={destid.userid|subsysid.destid}

Specifies the destination to which to print the index data, using one of these formats:

• destid.userid: 1-8 characters destination ID followed by 1-8 characters for the optional user ID. The destination can be a synonym created using the DEFDEV define device command.
• subsysid.destid: 4-character subsysid of an alternate CA Spool subsystem followed by a 1-8 character destination in it.

Note: For details about printing to CA Spool, see the “Printing Output” chapter in the User Guide.

FORM=xxxxxxxx

Specifies the forms name to use for printing the index data.

FORMDEF=
xxxxxx

Specifies a library member containing statements to control printing of the index data on the 3800 printer.

The statements can specify overlay forms, page location for overlays, and page format suppressions that can be activated.

GEN=nnnnn

Specifies the absolute or relative number of the generation for which index data is printed.

If omitted, the most recently archived index data for the ID is printed.

ID=id

Specifies the SYSOUT or report ID of the index data to be printed.

You can specify 1 to 32 characters for ID. This parameter is required.

Note: If the id contains embedded blanks, commas, equal signs, parentheses, or quotes, it must be enclosed in quotes (single or double). Any quotes in Report-id must be entered as a pair of quotes because a non-paired quote ends the ID. For example, if the value is JIM’S REPORT, it must be entered as ‘JIM’’S REPORT’ or "JIM’S REPORT".

INDEX=
xxxxxxxx

Specifies the index name for an ACIF or XEROX report. If the index name contains blanks or special characters, the index name must be enclosed within quotes.

PAGEDEF=
xxxxxx

Specifies a library member containing statements to control printing of the index data on the 3800 printer.

The statements can specify logical page length and width, fonts, and page segments.

PRMODE=
xxxxxxxx

Specifies the process mode required for printing the index data.

SEQ=nnnnn

Specifies the absolute or relative SYSOUT sequence number of the index data to be printed.

• If omitted, the most recently archived SYSOUT data for the ID and generation specified is processed.
• If GEN is omitted and SEQ is specified as a negative relative number, the SYSOUT relative to the most recently archived SYSOUT is processed.
• If GEN is omitted and SEQ is specified as a positive number, SEQ number is ignored and the most current SYSOUT is processed.

EX: SEQ=-1

The second most recently archived SYSOUT is processed regardless of its generation and sequence number.

EX: SEQ=-2

The third most recently archived SYSOUT is processed regardless of its generation and sequence number.

SELECT=
(xxxxxxxx,…)

Specifies the selection of specific index values to be printed for the report. The values that are specified correspond one to one with the indexes defined in the view definition. Each of these values can identify the full index value or a portion of the index value, which can optionally be suffixed with an asterisk.

VIEW=(nnn, viewid,userid)

Specifies a view format in which report is printed,

Where:

Nnn

Views numbers (1 to 255).

Viewed

Optionally specifies the ID of a public, private, or global view.

Note: If the id contains embedded blanks, commas, equal signs, parentheses, or quotes, it must be enclosed in quotes (single or double). Any quotes in Report-id must be entered as a pair of quotes because a non-paired quote ends the ID. For example, if the value is JIM’S REPORT, it must be entered as ‘JIM’’S REPORT’ or "JIM’S REPORT".

Userid

Optionally specifies the user ID for private view.

WRITER=
xxxxxxxx

Specifies the external writer name to be used for printing the index data.

The printed report prints index values horizontally with the index names left justified above the index values. If the logical view does not have an index name specified, UNNAMED is presented for the index name.

Notes:

• The number of printed lines can be limited by the CA View OUTLIM initialization parameter.
• For more information about initialization parameter, see the chapter "Initialization Parameters".