VTOC-UPDATE

File 7
Statement PROCESS
Task Perform VTOC updates, for example, rename, scratch, purge datasets.

Relevant Error Codes

Code Text
530 Access denied by Security Facility.
556 File is in use.
565 Syntax error in dataset name.
572 NEWNAME missing.
600 Unknown function.
659 Dataset is already cataloged.
701 DSNAME missing.
722 Requested dataset not found.
733 User ID does not exist.
750 Invalid operand within operand list.
798 Task was not started under TSOS.
799 Entire Systems Management Adapter internal error.
853 Retention cycle unexpired / NEWNAME exists.

Field Descriptions

Dictionary Field Name Format/

Length/

Desc/

Mu

Description

DSNAME (A54) Required. Fully qualified file name.
  D  
ERASE-OPTION (A7) Possible options:
  D CATALOG Erase only catalog entry (tape files,
    private disks, default tape files).
    DATA Erase only data. Keep allocated space
    and catalog entry (no tape files).
    DESTROY Overwrite with x'00' (no tape files).
    SPACE Same as DATA, but release allocated
    space (no tape files, no private
    disks).
ERASE-RANGE (A1) Range of generation files to be deleted.
  D Possible options:
    A All files after the generation number in DSNAME.
    B All files before the generation number in DSNAME.
FUNCTION (A8) Possible functions are:
  D CLOSE Verify file to close it.
    PURGE Delete file. Ignore expiration date.
    RENAME Rename file.
    SCRATCH Delete file.
NEWNAME (A54) Relevant for FUNCTION=RENAME:
  D New name to be assigned to the file. Must be supplied without CAT-ID/User ID.
PASSWORD (A8) Password for write access to the file to be renamed or deleted.
  D