Your Browser is not longer supported

Please use Google Chrome, Mozilla Firefox or Microsoft Edge to view the page correctly
Loading...

{{viewport.spaceProperty.prod}}

RENAME-CATID Renaming catalog IDs

&pagelevel(5)&pagelevel

This statement can be used to change the catalog ID in a file or job variable name. You can restrict the set of names to be changed by specifying a catalog ID and user ID

RENAME-CATID

DIRECTORY-NAME = <filename 1..54>

,OLD-CATID = *ALL / *BY-SPECIFICATION(...)


*BY-SPECIFICATION(...)



|

CATID = <cat-id>



|

,USER = *ALL / <name 1..8>

,NEW-CATID = <cat-id>

,NEW-DIRECTORY-NAME = <filename 1..54>

,SILENT-RUN = *NO / *YES


DIRECTORY-NAME = <filename 1..54>

Fully qualified path name of the directory file within which a catalog ID is to be renamed.

OLD-CATID =
Catalog ID to be renamed to the file and job variable name of the specified directory file.

OLD-CATID = *ALL
All catalog IDs are to be renamed as a single shared pubset ID.

OLD-CATID = *BY-SPECIFICATION(...)
Only the catalog ID specified below is to be renamed.

CATID = <cat-id>
Catalog ID to be renamed.

USER = *ALL
The catalog ID is to be renamed for all users.

USER = <name 1..8>
Catalog ID is to be renamed only for file and job variable names of this ID.

NEW-CATID = <cat-id>
New catalog ID specified in OLD-CATID is to be replaced.

NEW-DIRECTORY-NAME = <filename 1..54>
Fully qualified path name of the new directory file. 

SILENT-RUN = *NO / *YES
If the value is *NO, a message is output if an error occurs. The run is terminated.

If the value is *YES, the run is only simulated: the input directory is read in full but no output file is created. Every error (e.g. name conflict) that is identified during execution is logged.