Modify SM pubset definitions
Component: | BS2000 |
Functional area: | Pubset and MRSCAT management |
Domain: | MULTI-CATALOG-AND-PUBSET-MGMT |
Privileges: | TSOS |
Function
The MODIFY-PUBSET-DEFINITION-FILE command enables systems support to modify the configuration of a system-managed pubset (SM pubset) while the pubset is online. An entry in the pubset configuration file can be created, modified or deleted for each volume set in an SM pubset. When creating or modifying an entry, systems support can specify the following attributes of a volume set:
usage mode as a file storage location for normal files or work files or as the S1 storage level of the HSMS subsystem (USAGE operand)
level of file availability in terms of the availability of the volume set (AVAILABILITY operand)
performance attributes of the volume set relative to file access (PERFORMANCE-ATTR attribute)
To modify the composition of pubsets and volume sets (to add a volume set, for example) you have to use the MODIFY-PUBSET-PROCESSING command.
The SHOW-PUBSET-DEFINITION-FILE command lists information on the current configuration. This information is also contained in the output of the SHOW-PUBSET-CONFIGURATION command.
The MODIFY-PUBSET-DEFINITION-FILE command is also supported for shared pubsets. In a shared-pubset network the command can be issued on the master system or on a slave system. A system message refers to the system issuing the command, unless preceded by message DMS136D. The latter includes the name of the system (master or slave) on which the error has occurred. If the command is entered on a slave system, the system name may also be the local system name.
Format
MODIFY-PUBSET-DEFINITION-FILE | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
Operands
PUBSET = <cat-id 1..4>
Catalog ID of the pubset which is to have its configuration modified.
VOLUME-SET-ENTRY = *UNCHANGED / *ADD(...) / *MODIFY(...) / *REMOVE(...)
Specifies which operation is involved: defining the attributes of a new volume set, modifying those of an existing volume set, or deleting a volume set entry. The attributes of a volume set are stored in the form of an entry in the pubset configuration file.
VOLUME-SET-ENTRY = *ADD(...)
A new volume set is defined for the pubset. A new entry with the following attributes is added to the configuration file:
VOLUME-SET = <cat-id 1..4>
Identifies the volume set and hence the entry for it in the configuration file.
USAGE = *STD / *WORK / *HSMS-CONTROLLED
Specifies a usage mode for the volume set.
USAGE = *STD
The volume set is to be used as a storage location for normal files. Work files (file attribute WORK) must not be stored there.
USAGE = *WORK
The volume set is to be used as a storage location for work files only (file attribute WORK). These files may be deleted by systems support at freely selectable times. That makes it easier to remove the volume set from the pubset.
USAGE = *HSMS-CONTROLLED
The volume set is used by the HSMS subsystem to implement storage level S1 and the backup volume set of an SM pubset. Users are not allowed to store files there.
AVAILABILITY = *STD / *HIGH
Governs the level of availability for files, in terms of the availability of the volume set.
AVAILABILITY = *STD
The volume set does not offer enhanced availability.
AVAILABILITY = *HIGH
The volume set offers enhanced availability.
PERFORMANCE-ATTR = *STD / *PARAMETERS(...)
Governs the performance attributes of the volume set relative to file access. These are logical attributes which are taken into account in the allocation of storage space. The hardware (e.g. cache) which is being used is not taken into account.
PERFORMANCE-ATTR = *STD
No enhanced performance attributes are defined for the volume set.
PERFORMANCE-ATTR = *PARAMETERS(...)
The following enhanced performance attributes are defined for the volume set:
PERFORMANCE = list-poss(3): *STD / *HIGH / *VERY-HIGH
Determines the performance profile of the volume set with regard to I/O operations. Up to three values can be listed.
PERFORMANCE = *STD
The volume set does not offer enhanced performance.
PERFORMANCE = *HIGH
The volume set offers enhanced performance.
PERFORMANCE = *VERY-HIGH
The volume set offers very high performance.
WRITE-CONSISTENCY = *BY-CLOSE / *IMMEDIATE
Governs the point at which data consistency is required after write operations.
WRITE-CONSISTENCY = *BY-CLOSE
Data consistency is not required until after completion of CLOSE processing.
WRITE-CONSISTENCY = *IMMEDIATE
Data consistency is required immediately upon completion of the write operation.
VOLUME-SET-ENTRY = *MODIFY(...)
The attributes of an existing volume set are to be modified. The attributes specified next are modified in the entry in the configuration file. The default value of *UNCHANGED means that the existing setting is retained.
VOLUME-SET = <cat-id 1..4>
Identifies the volume set and hence the entry which is to be modified in the configuration file.
USAGE = *UNCHANGED / *STD / *WORK / *HSMS-CONTROLLED
Specifies a usage mode for the volume set. In order for the usage mode to be modified, the volume set must be in DEFINED-ONLY status.
USAGE = *STD
The volume set is to be used as a storage location for normal files. Work files (file attribute WORK) must not be stored there.
USAGE = *WORK
The volume set is to be used as a storage location for work files only (file attribute WORK). These files may be deleted by systems support at freely selectable times. That makes it easier to remove the volume set from the pubset.
USAGE = *HSMS-CONTROLLED
The volume set is used by the HSMS subsystem to implement storage level S1 and the backup volume set of an SM pubset. Users are not allowed to store files there.
AVAILABILITY = *UNCHANGED / *STD / *HIGH
Governs the level of availability for files, in terms of the availability of the volume set.
AVAILABILITY = *STD
The volume set does not offer enhanced availability. Changing *HIGH to *STD is possible only if the volume set is in DEFINED-ONLY status or does not contain any files which require high availability.
AVAILABILITY = *HIGH
The volume set offers enhanced availability. It is always possible to change *STD to *HIGH. The files, however, are not implicitly relocated to a volume set offering enhanced availability.
PERFORMANCE-ATTR = *UNCHANGED / *PARAMETERS(...)
Governs the performance attributes of the volume set relative to file access. These are logical attributes which are taken into account in the allocation of storage space. The hardware (e.g. cache) which is being used is not taken into account.
PERFORMANCE-ATTR = *PARAMETERS(...)
The following enhanced performance attributes are modified for the volume set:
PERFORMANCE = *UNCHANGED / list-poss(3): *STD / *HIGH / *VERY-HIGH
Determines the performance profile of the volume set with regard to I/O operations. Up to three values can be listed.
PERFORMANCE = *STD
The volume set does not offer enhanced performance.
PERFORMANCE = *HIGH
The volume set offers enhanced performance.
PERFORMANCE = *VERY-HIGH
The volume set offers very high performance.
WRITE-CONSISTENCY = *UNCHANGED / *BY-CLOSE / *IMMEDIATE
Governs the point at which data consistency is required after write operations.
WRITE-CONSISTENCY = *BY-CLOSE
Data consistency is not required until after completion of CLOSE processing.
WRITE-CONSISTENCY = *IMMEDIATE
Data consistency is required immediately upon completion of the write operation.
VOLUME-SET-ENTRY = *REMOVE(...)
The entry for a volume set is to be removed from the configuration file. The volume set must at the time be in DEFINED-ONLY status.
VOLUME-SET = <cat-id 1..4>
Identifies the volume set and hence the entry which is to be removed.
Return codes
(SC2) | SC1 | Maincode | Meaning |
|---|---|---|---|
0 | CMD0001 | No errors | |
32 | CMD0221 | Internal system error | |
32 | DMS138A | Internal parameter error | |
32 | DMS1398 | Reconfiguration no longer possible | |
64 | CMD0216 | No authorization to issue command | |
64 | DMS1381 | Volume set conflict | |
64 | DMS1384 | Operand not modifiable | |
64 | DMS1385 | Control volume set cannot be removed | |
64 | DMS138B | Pubset does not exist | |
64 | DMS138C | Pubset not accessible | |
64 | DMS138D | Pubset type conflict | |
64 | DMS138E | Volume set not defined | |
64 | DMS1390 | Earlier reconfiguration job not yet completed | |
64 | DMS1395 | Maximum number of volume sets exceeded | |
64 | DMS1397 | Reconfiguration of partner system not supported | |
64 | DMS1399 | Maximum number of MRSCAT entries reached | |
64 | DMS139D | Volume not accessible | |
128 | DMS1386 | Not enough class 4/5 memory | |
128 | DMS1389 | Error in transmission to partner system | |
128 | DMS139A | Another pubset reconfiguration job is still in progress | |
128 | DMS139C | Pubset configuration file still locked |