RENAME

Renames either the data or key file of a KSAM file.

   > {RENAME 

      R}oldfilereference, newfilereference [,TEMP]

The KSAMUTIL RENAME command can be used to change either the KSAM data file name or the KSAM key file name to a new name. Following execution of RENAME, the data and key files retain their relation to each other. Note that if the MPE :RENAME command is used, this relation is severed. The FRENAME intrinsic cannot be used to rename a KSAM file.

PARAMETERS

oldfile- reference

Current actual file designator identifying the KSAM data file or the KSAM key file, specified exactly like filereference1 or filereference2 in the BUILD command.

(Required parameter.)

newfile- reference

New actual file designator in same format as oldfilereference. The file named by newfilereference.

(Required parameter.)

TEMP

Indicates that old file was, and new file will be, a temporary file in the session/job temporary file domain.

(Optional parameter.)

Default: If omitted, permanent file is assumed.

RENAMING A KSAM FILE

You may rename either the data file or the key file, not both, with one >RENAME command. To rename the entire file, you must specify the RENAME command twice. Thus, to rename the data file KSAMFILE and its associated key file KFILE:

 

   >RENAME KSAMFILE,NEWDATA 

   >RENAME KFILE, NEWKEY

The relation between keys and data in the newly named files is the same as that in the files KSAMFILE and KFILE.

If the data file being renamed was protected by a lockword, then this lockword must be specified on both the old and new files if it is to be retained. If the lockword is omitted, it is removed when the file is renamed. Note that a lockword is never specified when renaming the key file; the keyfile is protected automatically by any lockword assigned to its associated data file. For example, to assign a new lockword to the data file DATAFIL:

 

      >RENAME DATAFIL/LOCKA, DATAFIL/LOCKB <--------- new lockword

Note that the new file name need not be in the same group as the old file name. RENAME provides a way to move a file from one group to another. For example, to move the KSAM file DATAFILE with its associated key file KEYFILE from GROUPA to GROUPB:

 

     >RENAME DATAFILE.GROUPA,DATAFILE.GROUPB

Note that only one RENAME command is used. This one command insures that both the data file and the key file are in the same group.

RENAME

Technical documentation

» Table of Contents

PARAMETERS

RENAMING A KSAM FILE