Commands › EDIT Command › Non-interactive Editing › Parameter Description

Parameter Description

The following provides a description of each parameter:

volser

Specifies the volser of the tape whose volume record to edit.

volser fileseqnumber

Specifies the volser of the tape that contains the data set whose record to edit and identifies the data set by specifying its sequence number on the tape.

• If you want to edit the primary data set record, specify 1 for fileseqnumber. If you want to edit the second data set record, specify 2 for fileseqnumber, and so on.
• If you are editing a data set record for a data set on a multivolume sequence, volser can be any tape in the sequence. It does not have to be the tape on which the data set begins.

[ STACK { FIFO| LIFO } field1 [ field2 ... fieldn ] ]

Specifies that CA VM:Tape is to place the values of the specified fields in the program stack in first in, first out (FIFO) or last in, first out (LIFO) order. The stacked lines are in the following format:

* field1 value1
* field2 value2
*lue fieldn valuen

This option is not valid when you use CP SMSG to issue the EDIT command.

[ REPLACE fieldname { NULL | newval [ verval ] } ]

Replaces the current value in the specified field.

• You can specify NULL to null out the current value in the field, as follows:

You can specify a new value (newval) to replace the current value in the field. You can verify the current value in the field before replacing it by specifying a verification value (verval). If verval matches the current value, CA VM:Tape replaces the current value with newval. If verval does not match the current value, CA VM:Tape does not replace the current value. When the field name is DSN, you must enclose verval in parentheses.