The CREATE-PUBSET-FROM-MIRROR statement creates a new SF pubset with a new catalog ID or, in the case of SM pubsets, new volume sets with new catalog IDs from mirror disks (BCVs, clone units, snap units) of an SF or SM pubset.
The MIRRORING-METHOD = *MULTI-MIRRORING(...) operand causes a pubset’s BCVs of a pubset to be separated and assigned a new name in a free pubset. A set of separated BCVs in double-point notation can exist in parallel here.
The MIRRORING-METHOD = *SPLIT-MIRROR operand causes a pubset’s mirror disks which were already separated before PVSREN was called to be assigned a new name in a free pubset. Here the separated mirror disks comply with double-point notation.
The MIRRORING-METHOD = *SNAP(...) operand causes a new snap session to be set up for a pubset. All snap units of this snap session are activated and assigned a new name in a free pubset. Here one or more snapsets may exist in parallel for the pubset.
The MIRRORING-METHOD = *CLONE(...) operand causes all clone units of a clone session which has already been set up to be activated for a pubset and a free pubset to be assigned a new name.
Prerequisites
When PVSREN separates or activates the mirror pubsets, the pubset must have been exported. Only in this way can PVSREN execute the separation consistently.
The VSNs of mirror pubsets that are already separated must comply with double-point notation.
The new catalog ID must be of the same length as the catalog ID of the source pubset.
The catalog IDs of the new pubsets or volume sets may not already exist in the system.
In the case of SM pubsets a renaming rule must be specified for all volume sets. This renaming rule must be stored in a file. It must be ensured here that the length of the new catalog IDs must be selected to ensure that all volumes of the volume set in question can be named with the VSN concerned: In PUB notation up to 32 volumes can be addressed, in point notation up to 255 volumes (with 2- and 3-digit catalog IDs) or max. 36 volumes (with 4-digit catalog IDs). Renaming takes place with the SET-NAME-OF-NEW-VOLUME-SET statement per volume set (see "SET-NAME-OF-NEW-VOLUME-SET - Define volume set name when creating an SM pubset from mirror disks").
See also the section "Prerequisites for creating new pubsets from mirror pubsets".
For a detailed description of execution, including any necessary reworking, please see "PVSREN operation" and "Restrictions and reworking".
Format
CREATE-PUBSET-FROM-MIRROR | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Operands
SOURCE-PUBSET = <catid 1..4>
Specifies the catalog ID of the pubset from whose mirror disks a new pubset is to be created.
NEW-PUBSET = <catid 1..4>)
Specifies the catalog ID of the new pubset.
PUBSET-TYPE =
Specifies the type of pubset involved.
PUBSET-TYPE = *SF
An SF pubset is involved.
An SM pubset is involved.
CONTROL-VOLUME-SET = <catid 1..4>
Specifies the catalog ID of the control volume set of the SM pubset from whose mirror pubset a new pubset is to be created.
NEW-VOLUME-SET-NAMES = *BY-FILE(...)
Assigns new catalog IDs for the SM pubset that is to be created to the catalog IDs of the volume sets of the source pubset. The rule for converting the volume sets’ catalog IDs is stored in a file.
FILE-NAME = <filename 1..54>
Name of the file in which the renaming rule for the volume sets of the SM pubset that is to be created is stored.
MIRRORING-METHOD =
Specifies the type of mirror disks. It also defines whether and, if required, how PVSREN separates the mirror disks.
MIRRORING-METHOD = *MULTI-MIRRORING(...)
The mirror disks are BCVs which are administered by SHC-OSD.
SELECT =
Specifies which group of BCVs are to be separated from a configuration with SRDF source and target units. If no remote mirroring with SRDF takes place, this parameter may only have the value *STD.
SELECT = *STD
The BCVs on the source page of an SRDF configuration are separated.
SELECT = *TARGET-UNIT(...)
The BCVs on the target page of an SRDF configuration are separated.
RA-GROUP =
Selects the target unit via the RA group in the case of concurrent target units.
RA-GROUP = *UNIQUE
The only existing target unit is selected.
RA-GROUP = <integer 1..64> / <name 1..1>
Specifies the RA group for selecting the target unit.
MIRRORING-METHOD = *SPLIT-MIRROR
The mirror disks are already separated BCVs, clone or snap units. Their VSNs must comply with double-point notation.
The mirror disks are snap units which are administered by SHC-OSD.
SELECT =
Specifies which group of snap units of a remote mirror configuration with source and target units is to be separated. If no remote mirroring takes place, this parameter may only have the value *STD.
SELECT = *STD
The snap units on the source page of a remote mirror configuration are separated.
SELECT = *TARGET-UNIT(...)
The snap units on the target page of a remote mirror configuration are separated.
RA-GROUP =
Selects the target unit via the RA group in the case of concurrent target units.
RA-GROUP = *UNIQUE
The only existing target unit is selected.
RA-GROUP = <integer 1..64> / <name 1..1>
Specifies the RA group for selecting the target unit.
MIRRORING-METHOD = *CLONE(...)
The mirror disks are clone units which are administered by SHC-OSD.
SELECT =
Specifies which group of clone units of a remote mirror configuration with source and target units is to be separated. If no remote mirroring with SRDF takes place, this parameter may only have the value *STD.
SELECT = *STD
The clone units on the source page of a remote mirror configuration are separated.
SELECT = *TARGET-UNIT(...)
The clone units on the target page of a remote mirror configuration are separated.
RA-GROUP =
Selects the target unit via the RA group in the case of concurrent target units.
RA-GROUP = *UNIQUE
The only existing target unit is selected.
RA-GROUP = <integer 1..64> / <name 1..1>
Specifies the RA group for selecting the target unit.