This statement initiates the declaration of the volume set to be set up. Together with the END-VOLUME-SET-DECLARATION statement which terminates the declaration it embraces a statement block which must be repeated for each volume set to be set up (see also the “Setting up a volume set” function on "Volume sets").
Notes
When defining the structure of the volume set, bear in mind that these settings cannot be modified later without the volume set being set up once more. This includes all settings specified by means of the FORMAT operand.
All logical attributes of the volume set which can be specified by means of the VOLUME-SET-ATTR operand can be modified during operation using the BS2000 command /MODIFY-PUBSET-DEFINITION-FILE.
BEGIN-VOLUME-SET-DECLARATION | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
VOLUME-SET=volume-set-id
Identifier for the volume set. This is a syntactic component of the VSN of all disks that belong to the volume set. The volume set identifier has two formats:
volume-set-id1:
The identifier is 1 character long (alphanumeric) and is the fourth character in the VSN of each disk that belongs to the volume set.
Format of the VSN:
PUBpxx where:
p | = volume-set-id1 |
| xx | = number of the disk in the volume set |
volume-set-id2:
The identifier is 2 to 4 characters long (alphanumeric) and is located at the beginning of the VSN. Format of the VSN:
pp.xyz or ppp.yz or pppp.z where:
p | = character from volume-set-id2 |
| x,y,z | = number of the disk in the volume set |
| Value range for allocation unit > 6 x,y,z: 0 - 9, A - Z. | |
| Value range for allocation unit = 6 | |
x,y: | The positions for x and y contain 0; |
z: | 0 - 9, A - V. |
Because the volume set can contain up to 32 disks, the values W to Z are not permissible. | |
volume-set-id2 must not begin with the string PUB.
ACTION
Specifies the processing mode for the volume set.
ACTION=*INSTALL(...)
The volume set specified with the volume set ID is to be created.
FORMAT
Defines the disk format and thus also the volume set mode with respect to PAM key use.
FORMAT=*K
The PAM key is made available. The volume set consists of K disks.
K files with BLKCTRL=PAMKEY are permitted.
FORMAT=*NK(...)
The disks of the volume set are formatted without a PAM key (NK disks). Only NK files with BLKCTRL=DATA / NO are possible.
PHYSICAL-BLOCK-SIZE
Defines the physical block size on the NK disks of the volume set.
PHYSICAL-BLOCK-SIZE=*2K(...)
NK2 disk (default value)
The minimum transfer unit between disk and memory is 2 Kb. This means a write or read job always moves 2 Kb (or a multiple thereof).
ALLOCATION-UNIT=6 / 8 / 64
Defines the unit size of the space allocated for files by DMS on the volume set disks. 6 Kb is the default for NK2 disks.
PHYSICAL-BLOCK-SIZE=*4K(...)
NK4 disk The minimum transfer unit is 4 Kb.
ALLOCATION-UNIT=8 / 64
Defines the unit size of the space allocated for files by DMS on the volume set disks. 8 Kb is the default value for NK4 disks.
AVAILABILITY
Defines the availability of the volume set.
AVAILABILITY=*NORMAL
No DRV disks are created (usual availability).
AVAILABILITY=*DRV
A volume set is set up with DUAL-RECORDING.
VOLUME-SET-ATTR=*PARAMETERS(...)
The logical attributes of the volume set are defined via parameters.
USAGE
Determines how the volume set is to be used as a file storage location.
USAGE=*STD
The volume set is to be used as the storage location for default files.
USAGE=*WORK
The volume set is to be used as the storage location for work files.
USAGE=*HSMS-CONTROLLED
The volume set is used by the HSMS subsystem to implement the S1 storage level and the backup volume set of an SM pubset.
AVAILABILITY
Determines the degree of file availability.
AVAILABILITY=*STD
The volume set offers no increased reliability.
AVAILABILITY=*HIGH
The volume set offers higher reliability.
PERFORMANCE-ATTR
Defines the performance attributes for the volume set.
PERFORMANCE-ATTR=*STD
The volume set has the standard performance attributes.
PERFORMANCE-ATTR=*PARAMETERS(...)
The performance attributes of the volume set are defined via parameters.
PERFORMANCE=list-poss(3):
More than one performance attribute (maximum: 3) can be specified.
PERFORMANCE=*STD
The volume set does not offer higher I/O performance.
PERFORMANCE=*HIGH
The volume set offers higher I/O performance.
PERFORMANCE=*VERY-HIGH
The volume set offers very high I/O performance.
WRITE-CONSISTENCY
Defines the consistency time for write accesses to a disk of the volume set.
WRITE-CONSISTENCY=*BY-CLOSE
The consistency of write accesses is not set up until the file is closed.
WRITE-CONSISTENCY=*IMMEDIATE
The consistency of write accesses is set up immediately.
ACTION=*ADD(...)
A “free” volume set, i.e. one that is empty and does not yet belong to a pubset, is to be included as it is in an SM pubset.
The operands of the substructures for ACTION=*ADD are described in the operand ACTION= *INSTALL.
ACTION=*EXTEND
The volume set specified by the volume set ID is to be extended.