Commands › CATALOG Command › Parameter Descriptions

Parameter Descriptions

The following provides a description of each parameter for changing data set information:

volser

Specifies the volser of the tape whose data set information to change. By default, CA VM:Tape changes information for the primary data set.

If you want CA VM:Tape to change information for a secondary data set, specify the FILESEQ number option.

BLKCOUNT number (or BLKCNT number)

Specifies the number of blocks for the data set. You can specify an integer between 0 and 99,999,999 for number.

DROP DSN

Specifies that CA VM:Tape is to drop the data set you are working with and all subsequent data sets. When you drop data sets, CA VM:Tape nullifies the data set information in the TMC, such as the creation dates and times and the data set name.

DSN dsname [ ( gdg ) ]

Lets you perform one of the tasks listed below.

• To change the primary data set name to dsname, specify the following:

  DSN dsname

• To make the primary data set name dsname part of a GDG, specify the following:

  DSN dsname (+1)

• To create a new generation of the primary data set name dsname, which is already part of a GDG), specify the following:

  DSN dsname (+1)

• To create the data set name dsname as the last data set name for the tape, specify the following:

  DSN dsname

  FILESEQ *

If you want CA VM:Tape to perform one of the first three tasks for a secondary data set name instead of the primary data set name, specify the FILESEQ number option.

The DSN dsname parameter must appear last, because CA VM:Tape assumes that all parameters after the DSN keyword and before any options are data set name qualifiers. For more information about specifying data set names and generations, see Specifying Data Set Names. You can specify a question mark for dsname.

Note: When you are creating standard label tapes in CMS for later use in OS/MVS, remember that the last 17 characters of the data set name must exactly match those specified by the FID parameter on the CMS LABELDEF command.

JOBNAME name

If you are changing information for a secondary data set name, specifies the owner of the data set. The owner can be different from the owner of the tape. The variable name is any valid character string of up to eight characters. You cannot change the owner of the primary data set.

[ ANYTAPE ]

Lets you change another user ID's tape. Refer to for information about working with tapes that do not belong to you and for explanations of and authorizations for these options.

[ FILESEQ number ]

Specifies the data set name to work with or indicates that CA VM:Tape is to add a new data set name to the tape. The variable number indicates the number of the data set name on the tape (for example, FILESEQ 3 indicates the third data set name). The default for number is 1, or the primary data set name. If you want to append a data set name, specify an asterisk for number.