DECLARE-PUBSET - Define pubset and type of processing

This statement is used to define the pubset to be processed, as well as the type of SIR processing.

The definition covers the following elements:

• the pubset type
  This defines whether an SF pubset (single-feature pubset) or an SM pubset (systemmanaged pubset) is to be set up.

• the pubset identifier
  This identifies the pubset. All the pubsets of a particular system are recorded in the MRS catalog. In the case of SF pubsets, the pubset identifier is a syntactic component of the VSN of all disks belonging to that pubset.

• the system identifier
  This distinguishes the system from other systems when the SF pubset is being used as the home pubset.

• the operating mode of the SF pubset
  This determines whether PAM keys are used on the disks belonging to the SF pubset.

• the allocation unit
  This is the unit with which DMS allocates space for files on the disks of the SF pubset.

• the physical block size on all disks belonging to the SF pubset.

• whether disks and files with a capacity in excess of 32 Gbytes are permitted.

• the identifier of the control volume set of an SM pubset which contains administration information.

DECLARE-PUBSET                                                                                                                                       

PUBSET-TYPE=*SYSTEM-MANAGED(...) / *SINGLE-FEATURE(...)

*SYSTEM-MANAGED(...)

|

PUBSET=pubset-id

|

,ACTION= *INST ALL(...) / *EXTEND(...)

|

*INSTALL(...)

|

|

CONTROL-VOLUME-SET=catid

|

|

,LARGE-DISKS-ALLOWED= *NO / *YES(...)

|

|

*YES(...)

|

|

|

LARGE-FILES-ALLOWED= *NO / *YES

|

*EXTEND(...)

|

|

CONTROL-VOLUME-SET=catid

*SINGLE-FEATURE(...)

|

PUBSET=pubset-id

|

,ACTION= *INST ALL(...) / *EXTEND / *IPL

|

*INSTALL(...)

|

|

FORMAT= *K / *NK(...)

|

|

*NK(...)

|

|

|

PHYSICAL-BLOCK-SIZE= *2K (...) / *4K(...)

|

|

|

*2K(...)

|

|

|

|

ALLOCATION-UNIT= 6 / 8 / 64

|

|

|

*4K(...)

|

|

|

|

ALLOCATION-UNIT= 8 / 64

|

|

,AVAILABILITY= *NORM AL / *DRV

|

|

,LARGE-DISKS-ALLOWED= *NO / *YES(...)

|

|

*YES(...)

|

|

|

LARGE-FILES-ALLOWED= *NO / *YES

|

,SYS-ID=*STD / *CAT-ID / sys-id

 

PUBSET-TYPE
Defines the pubset type to be set up.

PUBSET-TYPE=*SYSTEM-MANAGED(...)
An SM pubset is to be set up.

PUBSET=pubset-id
Identifier of the pubset (1 to 4 alphanumeric characters, must not begin with the string PUB).

ACTION
Specifies the SIR operating mode.

ACTION=*INSTALL(...)
The pubset specified by pubset ID is to be created.

CONTROL-VOLUME-SET=catid
Specifies the catalog ID of the volume set to be created as the control volume set of the SM pubset. catid must be a valid catalog ID.

LARGE-DISKS-ALLOWED=*NO / *YES(...)
Specifies whether disks with a capacity in excess of 32 Gbytes may be added to a volume set of this pubset (*YES(...)) or not (*NO).

LARGE-FILES-ALLOWED=*NO / *YES
Specifies whether the files of a pubset with large disks, which exceed 32 Gbytes in length are permitted (*YES) or not (*NO).

ACTION=*EXTEND(...)
The pubset identified by the pubset ID is to be extended.

CONTROL-VOLUME-SET=catid
Specifies the catalog ID of the control volume set.
The control volume set can only have a valid catalog ID as its name.

 

PUBSET-TYPE=*SINGLE-FEATURE (...)
An SF pubset is to be set up.

PUBSET=pubset-id
Identifier of the pubset. The pubset identifier has two formats. For SF pubsets, this is an intrinsic part of the format of the VSN of all disks belonging to the pubset.

pubset-id1:
The identifier is 1 (alphanumeric) character long. If is the fourth character in the VSN of every disk belonging to the SF pubset. Format of the VSN:
PUBpxx where:

p	= pubset-id1
xx	= number of the disk in the pubset. Value range: 00 - 31

pubset-id2:
The identifier is 2 to 4 (alphanumeric) characters long. It is located at the beginning of the VSN. Format of the VSN:
pp.xyz or ppp.yz or pppp.z where:

p	= character from pubset-id2
x,y,z	= number of the disk in the pubset
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.

The values W through Z are not permitted for z, since a pubset is not allowed to contain more than 32 disks.

pubset-id2 must not begin with the string PUB.

 

ACTION
Specifies the SIR operating mode.

ACTION=*INSTALL(...)
The pubset specified by pubset ID is to be created.

FORMAT
Defines the disk format and thus the operating mode of the pubset with respect to the use of PAM keys.

FORMAT=*K
The PAM key is made available. The pubset consists of K disks.
K files with BLKCTRL=PAMKEY are permitted.

FORMAT=*NK(...)
The disks of the pubset are formatted without PAM keys (NK disks).
Only NK files with BLKCTRL=DATA / NO are possible.

PHYSICAL-BLOCK-SIZE
Specifies the physical block size on the NK disks of the pubset.

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).

PHYSICAL-BLOCK-SIZE=*4K(...)
NK4 disk The minimum transfer unit is 4 Kb.

ALLOCATION-UNIT
Specifies the size of the unit used by DMS for allocation of space for files on disks of the pubset.

ALLOCATION-UNIT=6
The unit (size of the smallest file) is 6 Kb. This may be specified only for pubsets with NK2 disks and is the default value for these disks.

ALLOCATION-UNIT=8 / 64
The unit (size of the smallest file) should be 8 or 64 Kb in size. This may be specified for pubsets with NK2 or NK4 disks. 8 Kb is the default value for NK4 disks.

AVAILABILITY
Defines the availability of the pubset.

AVAILABILITY=*NORMAL
No DRV disks are created (usual availability).

AVAILABILITY=*DRV
A pubset with DUAL-RECORDING is created.

LARGE-DISKS-ALLOWED=*NO / *YES(...)
Specifies whether disks with a capacity in excess of 32 Gbytes may be added to the pubset (*YES(...)) or not (*NO).

LARGE-FILES-ALLOWED=*NO / *YES
Specifies whether the files of a pubset with large disks, which exceed 32 Gbytes in length are permitted (*YES) or not (*NO).

ACTION=*EXTEND
The pubset identified by the pubset ID is to be extended.

ACTION=*IPL
IPL files are to be anchored in the SVL.

SYS-ID
System identifier used when a pubset is used as the home pubset of the system in order to distinguish it from other systems in connection with the allocation of shareable devices (MTC).

SYS-ID must be specified if ACTION=*INSTALL is specified. If ACTION=*EXTEND / *IPL applies, a corresponding message is output and SYS-ID is ignored.

SYS-ID=*STD
The default value is 250.
A pubset with the default value cannot be made bootstrappable.

SYS-ID=*CAT-ID
If the pubset-id1 format of the pubset identifier is used, SYS-ID=*CAT-ID must be specified. No other predefinition is possible here.

SYS-ID=sys-id
Numeric value in the range 65 - 192.

Notes

1. If only a private disk is to be turned into an IPL disk with SIR, no DECLARE-PUBSET statement may be specified.

2. Requirements that must be met if increased availability with DUAL-RECORDING (AVAILABILITY=*DRV) is to be achieved:

   In order to obtain mirror disks with identical contents during creation, the subsystem DRV must first be loaded and after this, the command
   /SET-DRV PUBSET=pubset-id,RECORDING-MODE=*DRV must be used to set DRV mode for the pubset.

   During initialization of the disks, two successive disks are in each case processed exclusively for the same VSN. The operator must respond with care to the MOUNT messages, in order to avoid confusion. After this, the disks are allocated only as shareable and all operations are executed in dual-recording mode.

Example

DECLARE-PUBSET PUBSET-TYPE=*S-F(030,*IPL)

DECLARE-PUBSET PUBSET-TYPE=*S-F(030,*INSTALL(*NK(*4K(64))),*STD)