Modify disk space management defaults
Component: | BS2000 |
Functional area: | Pubset and MRSCAT management |
Domain: | MULTI-CATALOG-AND-PUBSET-MGMT |
Privileges: | TSOS |
Function
The MODIFY-PUBSET-SPACE-DEFAULTS command enables systems support to modify pubset-specific defaults for disk space management. The defaults that are set are for primary and secondary allocation, the maximum value for secondary allocation doubling, and the default file format for SM pubsets.
The pubset for which the defaults are to be modified generally has to be in service. In the case of SF pubsets, though, changes to values which are not to come into effect until the next startup can also be made when the pubset is not in service.
The SCOPE operand governs when modifications take effect and how long the effect lasts. With SF pubsets, a permanent change applies only to the system on which it was made. An exception is made when both immediate changes (with SCOPE=*TEMPORARY) and permanent changes (SCOPE=*PERMANENT) are made to SF pubsets requested by a slave system, in which case they apply only to the current master system.
In the case of a SM pubset which does not yet have any permanently configured values, suitable values are established when the pubset is taken into service. The settings of the DMPRALL, DMSCALL, and DMMAXSC system parameters are taken into account. Permanent settings of these values for an SF pubset can also be defined with the ADD-MASTER-CATALOG-ENTRY command.
Systems support can use the SHOW-PUBSET-SPACE-DEFAULTS command to find out which pubset-specific space management defaults are set. This information is also contained in the output of the SHOW-PUBSET-PARAMETERS command.
Format
MODIFY-PUBSET-SPACE-DEFAULTS | ||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||
Operands
PUBSET = <cat-id 1..4>
Identifies the pubset which is to have its space management defaults modified.
PUBSET-TYPE = *ANY / *SYSTEM-MANAGED(...)
Specifies the pubset type. The default is *ANY, which means that the pubset type is irrelevant because only the defaults governing the size of the space allocation are to be changed.
PUBSET-TYPE = *SYSTEM-MANAGED(...)
The pubset is explicitly an SM pubset. This is the only case in which the default file format can also be changed.
FILE-FORMAT = *UNCHANGED / *K / *NK2 / *NK4
Governs the default file format. The system uses this value if the user does not explicitly specify a file format or specifies *BY-PUBSET-DEFAULT (see the FILE-PREFORMAT operand in the CREATE-FILE command). The default is *UNCHANGED, which means that the existing setting is left unchanged.
FILE-FORMAT = *K
If no file format is specified, files are created as K files.
FILE-FORMAT = *NK2
If no file format is specified, files are created as NK files in 2K format.
FILE-FORMAT = *NK4
If no file format is specified, files are created as NK files in 4K format.
PRIMARY-ALLOCATION = *UNCHANGED / *STD / <integer 1..16777215 2Kbyte>
Governs the default primary allocation for storage space requests. The system uses this value if the user does not specify a value explicitly or specifies *STD (see the operand SPACE=*STD in the CREATE-FILE command). The default is *UNCHANGED, which means that the existing setting is left unchanged.
PRIMARY-ALLOCATION = *STD
The value of the DMPRALL system parameter is used as the primary allocation default.
PRIMARY-ALLOCATION = <integer 1..16777215 2Kbyte>
Number of PAM pages to be set as the primary allocation default.
SECONDARY-ALLOCATION = *UNCHANGED / *STD / <integer 1..32767 2Kbyte>
Governs the default secondary allocation for storage space requests. The system uses this value if the user does not specify a value explicitly or specifies *STD (see the SPACE=*STD or SECONDARY-ALLOCATION=*STD operand in the CREATE-FILE or MODIFY-FILE-ATTRIBUTES command). The default is *UNCHANGED, which means that the existing setting is left unchanged.
SECONDARY-ALLOCATION = *STD
The value of the DMSCALL system parameter is used as the secondary allocation default.
SECONDARY-ALLOCATION = <integer 1..32767 2Kbyte>
Number of PAM pages to be set as the secondary allocation default.
MAXIMAL-ALLOCATION = *UNCHANGED / *STD / <integer 1..32767 2Kbyte>
Governs the maximum value for secondary allocation doubling. The value of the secondary allocation for a file is doubled each time the reserved space is extended until the maximum value specified here is reached. The default is *UNCHANGED, which means that the existing setting is left unchanged.
MAXIMAL-ALLOCATION = *STD
The value of the DMMAXSC system parameter is used as the maximum allocation default.
MAXIMAL-ALLOCATION = <integer 1..327672 2Kbyte>
Number of PAM pages to be set as the maximum allocation default.
SCOPE = *PERMANENT / *TEMPORARY / *NEXT-PUBSET-SESSION
Defines how long the setting applies and when it comes into effect.
SCOPE = *PERMANENT
The setting takes immediate effect and applies until the next modification.
SCOPE = *TEMPORARY
The setting takes immediate effect and applies only for the duration of the current pubset session, i.e. until the pubset is taken out of service.
SCOPE = *NEXT-PUBSET-SESSION
The setting applies until the next permanent modification. However, the setting does not take effect until the start of the next pubset session.
Return codes
(SC2) | SC1 | Maincode | Meaning |
|---|---|---|---|
0 | CMD0001 | No errors | |
2 | 0 | DMS1402 | Action only partly successful |
1 | CMD0202 | Syntax error | |
32 | CMD0221 | Internal system error | |
64 | CMD0216 | Required authorization not available | |
64 | DMS1401 | File format not supported | |
64 | DMS140B | Pubset not available | |
64 | DMS140C | Pubset type conflict | |
130 | DMS140F | Not enough class 4/5 memory |