Relative-record data sets

This topic describes the statements and options that are allowed for files associated with VSAM relative-record data sets (RRDS).

Table 1. Statements and options allowed for loading and accessing VSAM relative-record data sets
File declaration1 Valid statements with options you must include Other options you can also include
SEQUENTIAL OUTPUT
BUFFERED
WRITE FILE(file-reference)
FROM(reference);
 
LOCATE based-variable
FILE(file-reference);
KEYFROM(expression) or
KEYTO(reference)
 
SET(pointer-reference)
SEQUENTIAL INPUT
BUFFERED
READ FILE(file-reference)
INTO(reference);
 
READ FILE(file-reference)
SET(pointer-reference);
 
READ FILE(file-reference);2
KEY(expression) or
KEYTO(reference)
 
KEY(expression) or
KEYTO(reference)
 
IGNORE(expression)
SEQUENTIAL UPDATE
BUFFERED
READ FILE(file-reference)
INTO(reference);
 
READ FILE(file-reference)
SET(pointer-reference);
 
READ FILE(file-reference);2
 
WRITE FILE(file-reference)
FROM(reference);
 
REWRITE FILE(file-reference);
 
 
 
DELETE FILE(file-reference);
KEY(expression) or
KEYTO(reference)
 
KEY(expression) or
KEYTO(reference)
 
IGNORE(expression)
 
KEYFROM(expression) or
KEYTO(reference)
 
FROM(reference)
and/or
KEY(expression)
 
KEY(expression)
DIRECT OUTPUT
BUFFERED
WRITE FILE(file-reference)
FROM(reference)
KEYFROM(expression);
 
DIRECT INPUT
BUFFERED
READ FILE(file-reference)
INTO(reference)
KEY(expression);
 
READ FILE(file-reference)
SET(pointer-reference)
KEY(expression);
 
DIRECT UPDATE
BUFFERED
READ FILE(file-reference)
INTO(reference)
KEY(expression);
 
READ FILE(file-reference)
SET(pointer-reference)
KEY(expression);
 
REWRITE FILE(file-reference)
FROM(reference)
KEY(expression);
 
DELETE FILE(file-reference)
KEY(expression);
 
WRITE FILE(file-reference)
FROM(reference)
KEYFROM(expression);
 
Notes:
  1. The complete file declaration would include the attributes FILE and RECORD. If you use any of the options KEY, KEYFROM, or KEYTO, your declaration must also include the attribute KEYED.

    The UNLOCK statement for DIRECT UPDATE files is ignored if you use it for files associated with a VSAM RRDS.

  2. The statement READ FILE(file-reference); is equivalent to the statement READ FILE(file-reference) IGNORE(1);.