Your Browser is not longer supported

Please use Google Chrome, Mozilla Firefox or Microsoft Edge to view the page correctly
Loading...

{{viewport.spaceProperty.prod}}

SHOW-SPACE-SATURATION-LEVELS

&pagelevel(3)&pagelevel

Display space saturation thresholds

Component:

BS2000

Functional area:

Pubset and MRSCAT management

Domain:

MULTI-CATALOG-AND-PUBSET-MGMT

Privileges:

TSOS
OPERATING
SW-MONITOR-ADMINISTRATION

Routing code:

@

Function

The SHOW-SPACE-SATURATION-LEVELS command provides system support with information for monitoring space saturation on pubsets.
In the case of an SF pubset these attributes are cross-pubset attributes, and in the case of an SM pubset the attributes are defined specifically for each volume set.

The thresholds for monitoring space saturation can be modified using the MODIFY-SPACE-SATURATION-LEVELS command.

The command supports structured output in S variables (see "Output in S Variable").

The thresholds for space saturation are also contained in the output of the SHOW-PUBSET-PARAMETERS command.
Restrictions

In the case of SF pubsets in a shared pubset network, only the information displayed on the pubset master is valid. The information displayed on a pubset slave becomes valid if that slave is made the pubset master.

Format

SHOW-SPACE-SATURATION-LEVELS

PUBSET = *ALL / <cat-id 1..4>

,SELECT-PUBSET = *ALL / *EXCLUSIVE / *SHARED / *LOCAL / *REMOTE / *ACCESSIBLE /

*LOCAL-ACCESSIBLE / *REMOTE-ACCESSIBLE / *HSMS-SUPPORTED /

*SPEEDCAT / *PAGING / *SINGLE-FEATURE / *SYSTEM-MANAGED /

*INACCESSIBLE / *QUIET / *DEFINED-XCS-CONFIGURATED /

*XCS-CONFIGURATED

,VOLUME-SET = *ALL / <cat-id 1..4>

Operands

PUBSET = *ALL / <cat-id 1..4>
Specifies the pubsets for which the space saturation values are to be displayed.

PUBSET = *ALL
The space saturation values for all pubsets are displayed. The SELECT-PUBSET operand can be used to restrict the selection to pubsets with specific attributes.

PUBSET = <cat-id 1..4>
ID of the pubset whose space saturation values are to be displayed.

SELECT-PUBSET = *ALL / *EXCLUSIVE / *SHARED / *LOCAL / *REMOTE / *ACCESSIBLE /
 *LOCAL-ACCESSIBLE / *REMOTE-ACCESSIBLE / *HSMS-SUPPORTED / *SPEEDCAT / *PAGING /
*SINGLE-FEATURE / *SYSTEM-MANAGED / *INACCESSIBLE / *QUIET / *DEFINED-XCS-CONFIGURATED /
*XCS-CONFIGURATED
Specifies whether information is required only for specific pubsets. This restriction is useful if *ALL is used in the PUBSET operand to select all pubsets.

SELECT-PUBSET = *ALL
The space saturation values for all the pubsets specified in the PUBSET operand are displayed.

SELECT-PUBSET = *EXCLUSIVE
The space saturation values for all pubsets imported exclusively are displayed.

SELECT-PUBSET = *SHARED
The space saturation values for all pubsets imported as shared are displayed.

SELECT-PUBSET = *LOCAL
The space saturation values for all locally imported pubsets are displayed. The space saturation values for the pubsets which cannot be accessed are also displayed.

SELECT-PUBSET = *REMOTE
The space saturation values for all pubsets for which the *LOCAL attribute does not apply are displayed.

SELECT-PUBSET = *ACCESSIBLE
The space saturation values for all pubsets which can be accessed are displayed.

SELECT-PUBSET = *LOCAL-ACCESSIBLE
The space saturation values for all locally accessible, i.e. imported, pubsets are displayed.

SELECT-PUBSET = *REMOTE-ACCESSIBLE
The space saturation values for all pubsets which have not been imported locally but whose file catalog can be accessed over an MSCF connection are displayed.

SELECT-PUBSET = *HSMS-SUPPORTED
The space saturation values for all pubsets which are supported by the HSMS subsystem are displayed.

SELECT-PUBSET = *SPEEDCAT
The space saturation values for all SF pubsets whose file catalog can be accessed in the local system via SPEEDCAT are displayed.

SELECT-PUBSET = *PAGING
The space saturation values for all pubsets with paging areas which are used locally are displayed.

SELECT-PUBSET = *SINGLE-FEATURE
The space saturation values for all SF pubsets are displayed.

SELECT-PUBSET = *SYSTEM-MANAGED
The space saturation values for all SM pubsets are displayed.

SELECT-PUBSET = *INACCESSIBLE
The space saturation values for all pubsets which cannot be accessed are displayed.

SELECT-PUBSET = *QUIET
The space saturation values for all pubsets whose MSCF connections no longer exist are displayed.

SELECT-PUBSET = *DEFINED-XCS-CONFIGURATED
The space saturation values for all pubsets which are defined as XCS pubsets in the MRS catalog are displayed.

SELECT-PUBSET = *XCS-CONFIGURATED
The space saturation values for all XCS pubsets are displayed.

VOLUME-SET = *ALL / <cat-id 1..4>
Identifies the volume sets whose space saturation values are to be displayed.

VOLUME-SET = *ALL
The space saturation values for all volume sets are displayed.

VOLUME-SET = <cat-id 1..4>
ID of the volume set for which the space saturation values are to be displayed.

Return codes

(SC2)

SC1

Maincode

Meaning


0

CMD0001

No errors


32

CMD0221

Internal system error


32

CMD2009

Error during output in S variables (e.g. subsystem not available)


64

CMD0216

Privilege error


64

DMS1381

Volume set conflict


64

DMS138B

Pubset does not exist or not with specified attribute


64

DMS138E

Volume set does not exist


64

DMS1396

Invalid host name


128

DMS1386

Not enough class 4/5 memory

Output format

The output starts with a header line consisting of the command name. The output information per pubset breaks down into three groups of output blocks:

  1. output block for pubset-global summary information

  2. output blocks for pubset-global detailed information

  3. output blocks for volume set-specific detailed information 

Pubset-global summary information

The output block for pubset-global summary information consists of a row of values which at the same time acts as a header line introducing the information output for a pubset. The summary information has the following layout:

PUBSET <catid>: <type>, CTL-SET = (<ctlid>, <type>), <status>, <hsms>

Key to the output values

<catid>

Pubset ID

<type>

Pubset type; possible values: SINGLE-FEATURE or SYSTEM-MANAGED

<ctlid>

Control volume set ID (for SM pubsets)

<type>

Device type of control volume set’s system disk (for SM pubsets)

<status>

Pubset accessibility; possible values:

  • ACC: Pubset is locally accessible.

  • INACC: Pubset is not locally accessible.

<hsms>

HSMS subsystem support (for SM pubsets); possible values:

  • HSMS-SUP: Pubset is supported by HSMS.

  • NO-HSMS-SUP: Pubset is not supported by HSMS.

Pubset-global detailed information

Information on the space saturation thresholds and on space reserved for a ZIP startup is displayed only for SF pubsets (for SM pubsets see "Volume set-specific Information").

The header line divides the subsequent rows of values into a three-column table. Each row of values contains the parameter name in the first column, the defined pubset-global values (DEFINED) in the second and the currently set values (CURRENT) in the third.

The output block is introduced by the following header line:

--- SPACE SATURATION       --- + --- DEFINED --- + --- CURRENT ---

Then the following rows of values are displayed:

SPACE SATURATION LEVEL 1      | BY SYSTEM       | <number> HP
                              | <number> HP     |
SPACE SATURATION LEVEL 2      | BY SYSTEM       | <number> HP
                              | <number> HP     |
SPACE SATURATION LEVEL 3      | BY SYSTEM       | <number> HP
                              | <number> HP     |
SPACE SATURATION LEVEL 4      | BY SYSTEM       | <number> HP
                              | <number> HP     |
SPACE SATURATION LEVEL 5      | BY SYSTEM       | <number> HP
                              | <number> HP     |
ZIP LEVEL                     | BY SYSTEM       | <number> HP
                              | <number> HP     |

Volume set-specific information

In the case of an SM pubset the information on the space saturation thresholds and on space reserved for a ZIP startup is displayed for each volume set. The information on a volume set is preceded by the following header line:

The volume set-specific information begins with the following header line:

--- VOLUME SET INFORMATION  --------------------------------------

This is followed by the output information for all volume sets of the SM pubset or for the volume set specified explicitly. The output information for each volume set begins with the volume set summary:

VOLUME-SET <catid>:  <type> <status>

Meaning of the output values:

<catid>

Volume set ID

<type>

VOLRES device type

<status>

Volume operating status:

  • NORMAL-USE: The volume set is in operation and therefore accessible.

  • IN-HOLD: The volume set is temporarily not in operation.

  • DEFECT: The volume set is defective.

  • DEFINED-ONLY: The volume set is defined but not accessible.

Information on space saturation thresholds and on space reserved for a ZIP startup is then provided. 

The header line divides the subsequent rows of values into a three-column table. Each row of values contains the parameter name in the first column, the defined volume-set-specific values (DEFINED) in the second and the currently set values (CURRENT) in the third.

--- SPACE SATURATION       --- + --- DEFINED --- + --- CURRENT ---
 SPACE SATURATION LEVEL 1      | BY SYSTEM       | <number> HP
                               | <number> HP     |
 SPACE SATURATION LEVEL 2      | BY SYSTEM       | <number> HP
                               | <number> HP     |
 SPACE SATURATION LEVEL 3      | BY SYSTEM       | <number> HP
                               | <number> HP     |
 SPACE SATURATION LEVEL 4      | BY SYSTEM       | <number> HP
                               | <number> HP     |
 SPACE SATURATION LEVEL 5      | BY SYSTEM       | <number> HP
                               | <number> HP     |
 ZIP LEVEL                     | BY SYSTEM       | <number> HP
                               | <number> HP     |

Output in S variables

Some S variables are generated only for the volume-set-specific information of an SM pubset. These are labeled with “1” in the Condition column of the table below.

Output information

Name of the S variable       

T

Contents                          

Condition

Current value of saturation level 1 *UNDEF=no definition (always this value for SM pubset)

var(*LIST).ALLOC-CURR.SAT-LEVEL1

S

*UNDEF
<integer 1..2147483647>


Current value of saturation level 2 *UNDEF=no definition (always this value for SM pubset)

var(*LIST).ALLOC-CURR.SAT-LEVEL2

S

*UNDEF
<integer 1..2147483647>


Current value of saturation level 3 *UNDEF=no definition (always this value for SM pubset)

var(*LIST).ALLOC-CURR.SAT-LEVEL3

S

*UNDEF
<integer 1..2147483647>


Current value of saturation level 4 *UNDEF=no definition (always this value for SM pubset)

var(*LIST).ALLOC-CURR.SAT-LEVEL4

S

*UNDEF
<integer 1..2147483647>


Current value of saturation level 5 *UNDEF=no definition (always this value for SM pubset)

var(*LIST).ALLOC-CURR.SAT-LEVEL5

S

*UNDEF
<integer 1..2147483647>


Current ZIP level *UNDEF=no definition (always this value for SM pubset)

var(*LIST).ALLOC-CURR.ZIP-LEVEL

S

*UNDEF
<integer 0..2147483647>


Defined saturation level 1

var(*LIST).ALLOC-DEFI.SAT-LEVEL1

S

*BY-SYS
<integer 1..2147483647>


Defined saturation level 2

var(*LIST).ALLOC-DEFI.SAT-LEVEL2

S

*BY-SYS
<integer 1..2147483647>


Defined saturation level 3

var(*LIST).ALLOC-DEFI.SAT-LEVEL3

S

*BY-SYS
<integer 1..2147483647>


Defined saturation level 4

var(*LIST).ALLOC-DEFI.SAT-LEVEL4

S

*BY-SYS
<integer 1..2147483647>


Defined saturation level 5

var(*LIST).ALLOC-DEFI.SAT-LEVEL5

S

*BY-SYS
<integer 1..2147483647>


Defined ZIP level (*UNDEF for SM pubset)

var(*LIST).ALLOC-DEFI.ZIP-LEVEL

S

*BY-SYS
<integer 0..2147483647>


Device type of the system disk of the control volume set;
*NO for SF pubsets

var(*LIST).CONTR-DEV-TYPE

S

*NO
<c-string 1..8>


ID of the control volume set;
*NO for SF pubsets

var(*LIST).CONTR-VOLSET

S

*NO
FALSE=none


HSMS support for the pubset
*NO=pubset is not supported
*STD=for single-feature pubsets
*YES=pubset is supported

var(*LIST).HSMS-SUP

S

*NO
*STD
*YES


Pubset ID

var(*LIST).PUBSET-ID

S

FALSE=none


Pubset type

var(*LIST).PUBSET-TYPE

S

*SINGLE-FEATURE
*SYS-MANAGE


Availability of the pubset
*ACCESSIBLE=locally accessible
*INACCESSIBLE=not locally accessible

var(*LIST).STA

S

*ACCESSIBLE
*INACCESSIBLE


Device type of the system disk of the volume set

var(*LIST).VOLSET(*LIST).DEV-TYPE

S

*UNKNOWN
<device>

1

Current value of saturation level 1

var(*LIST).VOLSET(*LIST).SAT-CURR.SAT-LEVEL1

S

*UNDEF
<integer 1..2147483647>

1

Current value of saturation level 2

var(*LIST).VOLSET(*LIST).SAT-CURR.SAT-LEVEL2

S

*UNDEF
<integer 1..2147483647>

1

Current value of saturation level 3

var(*LIST).VOLSET(*LIST).SAT-CURR.SAT-LEVEL3

S

*UNDEF
<integer 1..2147483647>

1

Current value of saturation level 4

var(*LIST).VOLSET(*LIST).SAT-CURR.SAT-LEVEL4

S

*UNDEF
<integer 1..2147483647>

1

Current value of saturation level 5

var(*LIST).VOLSET(*LIST).SAT-CURR.SAT-LEVEL5

S

*UNDEF
<integer 1..2147483647>

1

Current ZIP level

var(*LIST).VOLSET(*LIST).SAT-CURR.ZIP-LEVEL

S

*UNDEF
<integer 0..2147483647>

1

Defined saturation level 1

var(*LIST).VOLSET(*LIST).SAT-DEFI.SAT-LEVEL1

S

*BY-SYS
<integer 1..2147483647>

1

Defined saturation level 2

var(*LIST).VOLSET(*LIST).SAT-DEFI.SAT-LEVEL2

S

*BY-SYS
<integer 1..2147483647>

1

Defined saturation level 3

var(*LIST).VOLSET(*LIST).SAT-DEFI.SAT-LEVEL3

S

*BY-SYS
<integer 1..2147483647>

1

Defined saturation level 4

var(*LIST).VOLSET(*LIST).SAT-DEFI.SAT-LEVEL4

S

*BY-SYS
<integer
1..2147483647>

1

Defined saturation level 5

var(*LIST).VOLSET(*LIST).SAT-DEFI.SAT-LEVEL5

S

*BY-SYS
<integer
1..2147483647>

1

Defined ZIP level

var(*LIST).VOLSET(*LIST).SAT-DEFI.ZIP-LEVEL

S

*BY-SYS
<integer
0..2147483647>

1

Status of the volume set
*DEFECT=permanently inaccessible (defective)
*DEFINED=not available, all that exists is an entry in the configuration file
*IN-HOLD=temporarily not accessible (frozen)
*NORMAL=available

var(*LIST).VOLSET(*LIST).STA

S

*DEFECT
*DEFINED
*IN-HOLD
*NORMAL

1

Volume set ID

var(*LIST).VOLSET(*LIST).VOLSET

S

<vsid>

1

Example

/show-space-saturation-levels pubset=x

%---------------------------------------------------------------------------%COMMAND:
 SHOW-SPACE-SATURATION-LEVELS
%- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
PUBSET X   : SINGLE-FEATURE, ACC
---- SPACE SATURATION       --------- + ---- DEFINED ---- + ---- CURRENT ----
 SPACE SATURATION LEVEL 1             | BY SYSTEM         | 939           HP
 SPACE SATURATION LEVEL 2             | BY SYSTEM         | 473           HP
 SPACE SATURATION LEVEL 3             | BY SYSTEM         | 240           HP
 SPACE SATURATION LEVEL 4             | 6             HP  | 6             HP
 SPACE SATURATION LEVEL 5             | BY SYSTEM         | 6             HP
 ZIP LEVEL                            | BY SYSTEM         | 6             HP
-----------------------------------------------------------------------------
Powered by Atlassian Confluence and Scroll Viewport.