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-PUBSET-SPACE-DEFAULTS

&pagelevel(3)&pagelevel

Display disk space management defaults

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-PUBSET-SPACE-DEFAULTS command provides system support with information on the pubset-specific default values of the disk space management. The command supplies information both for single-feature (SF) pubsets and for system-managed (SM) pubsets.

The pubset-specific disk space management defaults are modified using the MODIFY-PUBSET-SPACE-DEFAULTS command.

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

The pubset-specific disk space management defaults are also contained in the output of the SHOW-PUBSET-PARAMETERS command.
Restrictions

In the case of SF pubsets in a shared pubset network, a pubset slave shows the locally set values in the output column DEFINED. This only change when the local system becomes the pubset master.

The currently valid values set on the pubset master are contained in the output column CURRENT.

I

Format

SHOW-PUBSET-SPACE-DEFAULTS                                                                                                           

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

Operands

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

PUBSET = *ALL
The defaults of all volume sets are to be 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 defaults 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 defaults of all the pubsets specified in the PUBSET operand are displayed.

SELECT-PUBSET = *EXCLUSIVE
The defaults of all pubsets imported exclusively are displayed.

SELECT-PUBSET = *SHARED
The defaults of all pubsets imported as shared are displayed.

SELECT-PUBSET = *LOCAL
The defaults of all locally imported pubsets are displayed. The defaults of the pubsets which cannot be accessed are also displayed.

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

SELECT-PUBSET = *ACCESSIBLE
The defaults of all pubsets which can be accessed are displayed.

SELECT-PUBSET = *LOCAL-ACCESSIBLE
The defaults of all locally accessible, i.e. imported, pubsets are displayed.

SELECT-PUBSET = *REMOTE-ACCESSIBLE
The defaults of 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 defaults of all pubsets which are supported by the HSMS subsystem are displayed.

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

SELECT-PUBSET = *PAGING
The defaults of all pubsets with paging areas which are used locally are displayed.

SELECT-PUBSET = *SINGLE-FEATURE
The defaults of all SF pubsets are displayed.

SELECT-PUBSET = *SYSTEM-MANAGED
The defaults of all SM pubsets are displayed.

SELECT-PUBSET = *INACCESSIBLE
The defaults of all pubsets which are not available are displayed.

SELECT-PUBSET = *QUIET
The defaults of all pubsets whose file catalog can be accessed over an MSCF connection are displayed.

SELECT-PUBSET = *DEFINED-XCS-CONFIGURATED
The defaults of all pubsets which are defined as XCS pubsets in the MRS catalog are displayed.

SELECT-PUBSET = *XCS-CONFIGURATED
The defaults of all XCS pubsets are 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 two groups of output blocks:

  1. output block for pubset-global summary information

  2. output blocks for pubset-global 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

The defaults for storage space allocation are displayed for the pubsets.

The output block is introduced by the following header line:

--- SPACE ALLOCATION      ---- + --- DEFINED --- + --- CURRENT ---

Then the following rows of values are displayed:

  • Default values (in PAM pages) for space allocation for files. Values with invalid definitions (<= 0) are replaced by the system with suitable current values.

    PRIMARY ALLOCATION            | <number> HP     | <number> HP
SECONDARY ALLOCATION          | <number> HP     | <number> HP
MAXIMAL ALLOCATION            | <number> HP     | <number> HP

  • For SM pubsets the next section gives information on the default file format:

    DEFAULT FILE FORMAT           | PAMKEY          | PAMKEY
                              | NK2             | NK2
                              | NK4             | NK4
                              | UNDEFINED       | NK4

  • For SF pubsets the next section gives information on whether absolute (physical) space allocation is allowed for nonprivileged users or only for systems support:

    PHYSICAL ALLOCATION           | BY ADMINISTRATOR| BY ADMINISTRATOR
                              | USER ALLOWED    | USER ALLOWED

Output in S variables

Output information

Name of the S variable            

T

Contents                      

Condition

Current standard file format

(*UNDEF for SF pubset)

var(*LIST).ALLOC-CURR.FILE-FORM

S

*K
*NK2
*NK4
*UNDEF


Current secondary allocation limit

var(*LIST).ALLOC-CURR.MAX-ALLOC

S

*UNDEF
<integer 1..32767>


Physical allocation possible

(FALSE for SM pubset)

var(*LIST).ALLOC-CURR.PHYS-ALLOC

B

FALSE
TRUE


Current primary allocation standard

var(*LIST).ALLOC-CURR.PRIMARY-ALLOC

S

*UNDEF
<integer 1..16777215>


Current secondary allocation standard
*UNDEF=no definition (always this value for SM pubset)

var(*LIST).ALLOC-CURR.SECONDARY-ALLOC

S

*UNDEF
<integer 1..32767>


Defined standard file format (*UNDEF always this value for SF pubset)

var(*LIST).ALLOC-DEFI.FILE-FORM

S

*K
*NK2
*NK4
*UNDEF


Defined secondary allocation limit

var(*LIST).ALLOC-DEFI.MAX-ALLOC

S

<integer 1..32767>


Defined possibility for physical allocation

(FALSE for SM pubset)

var(*LIST).ALLOC-DEFI.PHYS-ALLOC

B

FALSE
TRUE


Defined primary allocation standard

var(*LIST).ALLOC-DEFI.PRIMARY-ALLOC

S

<integer 1..16777215>


Defined secondary allocation standard

var(*LIST).ALLOC-DEFI.SECONDARY-ALLOC

S

<integer 1..32767>


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 SF 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


Example

/show-pubset-space-defaults pubset=x

%----------------------------------------------------------------------------
%COMMAND: SHOW-PUBSET-SPACE-DEFAULTS
%- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
%PUBSET DATA: SYSTEM-MANAGED, CTL-SET=(KEY, STDDISK), INACC, NO-HSMS-SUP
%---- SPACE ALLOCATION --------- + ---- DEFINED ---- + ---- CURRENT ---
% PRIMARY ALLOCATION             | 3              HP |
% SECONDARY ALLOCATION           | 3              HP |
% MAXIMAL ALLOCATION             | 24             HP |
% DEFAULT FILE FORMAT            | UNDEFINED         |
%----------------------------------------------------------------------------
Powered by Atlassian Confluence and Scroll Viewport.