KEY
=
(
start
,
length
)
Defines a key field for use by
FROMKEY and
TOKEY program control statements. This statement can only occur once. The parameters are:
-
start
- The position in the record at which the key starts.
-
length
- The length of the key.
For VSAM keyed files, the KEY defaults to the actual key, although, as the files are processed sequentially, any field can be defined as the key for the purpose of specifying a range for record matching.
INCLUDE
Compare records only in the ranges defined by FROMKEYTOKEY or FROMRECCOUNT.
SKIP and INCLUDE are mutually exclusive.
IGNORE
Ignore records only in the ranges defined by FROMKEYTOKEY or FROMRECCOUNT.
SKIP and INCLUDE are mutually exclusive.
FROMKEY
=
'
value1
'
TOKEY
=
'
value1
'
Defines a range of records. value1 specifies the first record in the range, while value2 specifies the last record in the range. Hexadecimal values can be specified as
x
'
hhhhhh
'
, where hhhhhh is a hexadecimal number.
FROMREC
=
recnum
COUNT
=
count
Defines a range of record numbers, from record number x for the next y records.
FD
=
start
,
length
Defines a field to be ignored when comparing records. Used with INCLUDE only.
Example of Program Control Statements
In the following example:
- The key field is defined as being the first ten bytes of the record
- Records in the ranges AAAAAAAAAA to BBBBBBBBBB and WWWWWWWWW to ZZZZZZZZZZ are compared
- Positions 11 to 15 and 21 to 25 are ignored in the second range
//SYSIN DD *
KEY=(1,10)
INCLUDE FROMKEY='AAAAAAAAAA' TOKEY='BBBBBBBBBB'
INCLUDE FROMKEY='WWWWWWWWWW' TOKEY='YYYYYYYYYY'
FD=(11,5)
FD=(21,5)
