Previous Topic

Next Topic

Book Contents

Book Index

ON VSAM: Data Selection Statement

Processes VSAM file records using user-specified keys.

Figure 270 ON VSAM Statement Format

Type the word VSAM (or its abbreviation V) next to the ON in the Rule Definition screen. When Enter is pressed, the following fields appear:

Table 268 ON VSAM Statement Fields

Field

Description

FILENAME

Valid VSAM, KSDS, ESDS or RRDS dataset name. Mandatory. A maximum of 44 characters can be specified.

FIRSTKEY

Key of the first KSDS file record or RBA of the first RRDS/ESDS file record to be processed. Optional. If FIRSTKEY is blank, processing starts from the first record in the file.

The C (Continue?) field, when set to Y (Yes), provides additional space for specifying the FIRSTKEY field. A maximum of six lines may be opened for this field. Specifying N (No) in the C (Continue?) field closes the following preexisting line.

LASTKEY

Key of the last KSDS file record or RBA of the last RRDS/ESDS file record to be processed. Optional. If LASTKEY is blank, processing ends with the last record in the file. The last record is read by Control-M/Analyzer.

The C (Continue?) field, when set to Y (Yes), provides additional space for specifying the LASTKEY field. A maximum of six lines may be opened for this field. Specifying N (No) in the C (Continue?) field closes the following preexisting line.

T

VSAM file type. Valid values are: ESDS, RRDS and KSDS.

MODE

Determines the starting point upon which absolute WHEN line and column specifications are based. For more information, see WHEN: Rule Definition Structure. Optional. Available modes are:

  • DS (Dataset) – Line and column values are based on the start of the dataset.
  • PG (Page) – Line and column values are based on the start of the page. Default.

LINECT

Specifies the number of lines per printed page. Optional. If not specified, Control-M/Analyzer assumes a value of 60.

DATASTAMP

Determines whether a unique Datastamp is calculated and assigned to the data sources. See Datastamp Calculation for more information.

  • blank – A Datastamp is not generated. Default.
  • 1 – A Datastamp is calculated using the original algorithm to ensure compatibility with prior versions.
  • 2 – A Datastamp is calculated using the newer, more efficient algorithm.

Parent Topic

Rule Definition