Modify space saturation thresholds
Component: | BS2000 |
Functional area: | Pubset and MRSCAT management |
Domain: | MULTI-CATALOG-AND-PUBSET-MGMT |
Privileges: | TSOS |
Routing code: | $ |
Function
The MODIFY-SPACE-SATURATION-LEVELS command enables systems support to modify the threshold levels for storage space saturation monitoring on pubsets. The threshold settings are pubset-specific for single-feature pubsets (SF pubsets). With system-managed pubsets (SM pubsets) the thresholds are defined for each volume set.
A defined disk space saturation threshold is reached when the number of free PAM pages on an SF pubset or in a volume set on an SM pubset falls below the figure set for the saturation level. When a saturation level is reached, assigned console messages are output. From saturation level 4, requests for space from certain jobs are rejected. A system reserve (ZIP level) can be kept free for pubsets needed at system startup. The reserved space is not released for allocation until a ZIP start is performed (see the “Introduction to System Administration” [14]).
The pubset for which the saturation thresholds 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 the change is requested from a slave system, in which case it applies only to the current master system.
In the case of a pubset which does not yet have any permanently configured values, suitable values are calculated when the pubset is taken into service. The setting of the L4SPDEF system parameter and the current capacity of the SF pubset, or that of the individual volume sets in the case of an SM pubset, are taken into account.
When setting thresholds, make sure that the values for saturation levels 1 through 5 and the system reserve which is equivalent to saturation level 6 form a descending sequence; in other words, the following condition must be met:
LEVEL-1 >= LEVEL-2 >= LEVEL-3 >= LEVEL-4 >= LEVEL-5 >= ZIP-LEVEL
If threshold settings are to take immediate effect, the specified values must also not exceed the current capacity of the SF pubset or of the volume sets in the SM pubset.
Systems support can use the SHOW-SPACE-SATURATION-LEVELS command to find out which thresholds are currently set. This information is also contained in the output of the SHOW-PUBSET-PARAMETERS command. The SHOW-PUBSET-SPACE-ALLOCATION command provides information on how space is currently allocated.
Format
MODIFY-SPACE-SATURATION-LEVELS | ||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||
Operands
PUBSET = <cat-id 1..4>
Identifies the pubset which is to have its space saturation monitoring thresholds modified.
PUBSET-TYPE = *SINGLE-FEATURE / *SYSTEM-MANAGED(...)
Specifies whether the pubset is an SF or SM pubset.
PUBSET-TYPE = *SINGLE-FEATURE
The pubset is an SF pubset. The thresholds are defined on a pubset-global basis.
PUBSET-TYPE = *SYSTEM-MANAGED(...)
The pubset is an SM pubset. The thresholds are defined for the volume set specified next.
VOLUME-SET = <cat-id 1..4>
Identifies the volume set.
LEVEL-1 = *UNCHANGED / *STD / <integer 1..2147483647 2Kbyte >
Defines the threshold for saturation level 1. If the number of free PAM pages falls below the specified figure, saturation level 1 has been reached. The default is *UNCHANGED, which means that the existing setting is left unchanged.
LEVEL-1 = *STD
The threshold for saturation level 1 is calculated by the system.
LEVEL-2 = *UNCHANGED / *STD / <integer 1..2147483647 2Kbyte >
Defines the threshold for saturation level 2. If the number of free PAM pages falls below the specified figure, saturation level 2 has been reached. The default is *UNCHANGED, which means that the existing setting is left unchanged.
LEVEL-2 = *STD
The threshold for saturation level 2 is calculated by the system.
LEVEL-3 = *UNCHANGED / *STD / <integer 1..2147483647 2Kbyte >
Defines the threshold for saturation level 3. If the number of free PAM pages falls below the specified figure, saturation level 3 has been reached. The default is *UNCHANGED, which means that the existing setting is left unchanged.
LEVEL-3 = *STD
The threshold for saturation level 3 is calculated by the system.
LEVEL-4 = *UNCHANGED / *STD / <integer 1..2147483647 2Kbyte >
Defines the threshold for saturation level 4. If the number of free PAM pages falls below the specified figure, saturation level 4 has been reached. The default is *UNCHANGED, which means that the existing setting is left unchanged.
LEVEL-4 = *STD
The value of the L4SPDEF system parameter is set as the threshold for saturation level 4.
LEVEL-4 = <integer 1..2147483647 2Kbyte >
Number of nonreserved PAM pages.
LEVEL-5 = *UNCHANGED / *STD / <integer 1..2147483647 2Kbyte >
Defines the threshold for saturation level 5. If the number of free PAM pages falls below the specified figure, saturation level 5 has been reached. The default is *UNCHANGED, which means that the existing setting is left unchanged.
LEVEL-5 = *STD
The threshold for saturation level 5 is calculated by the system.
ZIP-LEVEL = *UNCHANGED / *STD / <integer 0..2147483647 2Kbyte >
Defines a system reserve of nonreserved space. This space can only be allocated if system startup takes the form of a ZIP start. The system reserve should be set to zero for pubsets which are never used at system startup. The default is *UNCHANGED, which means that the existing setting is left unchanged.
ZIP-LEVEL = *STD
A system reserve of 66 PAM pages is kept free for SF pubsets. No system reserve (equivalent to ZIP-LEVEL=0) is kept free for SM pubsets because they cannot be used at system startup.
ZIP-LEVEL = <integer 0..2147483647 2Kbyte >
Number of PAM pages to be kept free as a system reserve.
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 | User does not have the necessary privilege | |
64 | DMS140B | Pubset not available | |
64 | DMS140C | Pubset type conflict | |
64 | DMS140D | Volume set not available | |
64 | DMS140E | Specified values not in descending sequence | |
64 | DMS1403 | Level higher than capacity | |
64 | DMS1404 | Values do not match the previously set temporary values | |
64 | DMS1405 | Values do not match the previously set defined values | |
130 | DMS140F | Not enough class 4/5 memory |