This statement can be used to rename SF and SM pubsets and volume sets (also control volume sets) or convert their pubset notation.
The statement is executed only if the pubset has the status INACCESSIBLE.
The actions carried out depend on the mode.
When MODE=*NORMAL-RENAME is specified, the following steps are carried out one after the other by RENAME-PUBSET-OR-VOLUME-SET:
Check the length of the names of files, file generation groups and job variables (not for volume sets).
If the maximum length is exceeded, processing is aborted. The CHECK-FILENAME-LENGTH statement should therefore always be called first.Change the catalog ID of the pubset or volume sets
in the file catalog TSOSCAT (not for SM pubsets)
in the file name of the system files (paging area, TSOSCAT.<catid>)
in the SVL of all disks that belong to the SF pubset or volume set
in the pubset configuration file on the control volume set of the SM pubset
in the SVL of all main disks of the volume set of the corresponding SM pubset
Delete the old MRSCAT entries and create all new ones
Following confirmation, change the default catalog ID in the user catalog (SYSSRPM) of the home pubset and the modified pubset
Change the affected entries in the IMON-SCI on the data pubset and (following confirmation) HOME pubset.
If MODE=*COMPLETE-SHC-RENAME is specified, only actions 4 and 5 are executed, i.e.:
Following confirmation, change the default catalog ID in the user catalog (SYSSRPM) of the home pubset and the modified pubset
Change the affected entries in the IMON-SCI on the data pubset and (following confirmation) HOME pubset.
For a detailed description of execution, including any necessary reworking, please see "PVSREN operation" and "Restrictions and reworking".
Format
RENAME-PUBSET-OR-VOLUME-SET |
NAME = <catid 1..4> ,NEW-NAME = <catid 1..4> ,SYSID = *STD / *SAME / <integer 65..192> ,MODE = *NORMAL-RENAME / *COMPLETE-SHC-RENAME ,PUBSET-PARAMETERS = *STD / *SAME |
Operands
NAME = <catid 1..4>
Specifies the catalog ID of the pubset or the volume set to be modified (output catalog ID).
NEW-NAME = <catid 1..4>
Specifies the new catalog ID that the pubset or volume set is to receive after conversion or renaming (destination catalog ID).
SYSID =
The system ID is relevant only for home pubsets and is therefore interpreted only for SF pubsets. The system ID is entered in the SVL of the SF pubset and identifies the system which uses this home pubset in a shared pubset network. For SM pubsets and volume sets, the SYSID operand is ignored.
SYSID = *STD
Depending on the initial and target catalog IDs, the system ID is defined as follows:
catid-old | catid-new | Calculation of sysid |
|---|---|---|
Single-digit | Single-digit | sysid = catid |
Multi-digit | Single-digit | sysid = catid |
Single-digit | Multi-digit | sysid s converted: A=65 ... Z=90, 0=91 ... 9=100 |
Multi-digit | Multi-digit | sysid is accepted |
SYSID = *SAME
The system ID is taken from the initial pubset. This is possible only if the initial and target catalog IDs are multi-digit ones.
SYSID = <integer 65..192>
This specification is possible only if the target catalog ID is a multi-digit one. For a singledigit target catalog ID, the system ID is the same as the catalog ID and cannot be defined.
MODE =
This operand specifies the processing mode and thus the individual functions to be executed.
MODE = *NORMAL-RENAME
The specified pubset or volume set is completely renamed. In other words, the catalog ID, user catalog and SCI are modified.
MODE = *COMPLETE-SHC-RENAME
The partial renaming of a pubset by SHC-OSD at separation, i.e. the VSNs are renamed but not the links in IMON's SCI and in the user catalog (SYSSRPM), is completed by PVSREN. The user catalogs and the IMON-SCI are modified.
The modifications are only carried out following confirmation. If the HOME pubset has been separated by SHC-OSD, the following functions are not offered:
renaming of user entries on the HOME pubset
renaming of the IMON-SCI on the HOME pubset
Note that in this mode the NAME operand must be specified with the catalog ID of the original pubset and the NEW-NAME operand must be specified with the catalog ID of the pubset created by SHC-OSD.
PUBSET-PARAMETERS =
This operand defines which settings are transferred from the original pubset’s MRSCAT to the MRSCAT of the renamed pubset. The operand is evaluated only when an SF or SM pubset is renamed, but not when a volume set is renamed.
PUBSET-PARAMETERS = *STD
The following MRSCAT settings of the original pubset are transferred:
Pubset type
Device type of the Pubres disk
Settings for shareability on the local host
BCAM name of the partner system
PUBSET-PARAMETERS = *SAME
In addition to the MRSCAT settings for PUBSET-PARAMETERS=*STD, the following MRSCAT settings of the original pubset are also transferred
Number of buffers
Buffer storage location
Wait times for batch and interactive jobs
Access restriction for users with any special permission
XCS pubset property
Remote import options
Mnemonic device name of the Pubres disk
EAM parameters
The following are also transferred in the case of SF pubsets:
Settings for using SPEEDCAT
Direct allocation restrictions
Specific allocation parameters
If renaming with PUBSET-PARAMETERS = *SAME fails, PVSREN displays message PVR0142 and tries a second run with PUBSET-PARAMETERS = *STD.