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

&pagelevel(3)&pagelevel

Show space allocation on pubset

Component:

BS2000

Functional area:

Pubset and MRSCAT management

Domain:

MULTI-CATALOG-AND-PUBSET-MGMT

Privileges:

TSOS
OPERATING

Routing code:

@

Function

The SHOW-PUBSET-SPACE-ALLOCATION command provides systems support with information on space allocation on a pubset which is currently in service. Information can be requested globally for the pubset or in detail for all the volumes within the pubset. In the case of an SM pubset the information is output for each volume set, and the output can be restricted to specific volume sets.

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

Format

SHOW-PUBSET-SPACE-ALLOCATION

PUBSET = <cat-id 1..4>

,INFORMATION = *SUMMARY / *ALL

,SELECT-VOLUME-SET = *ALL / *STD / *WORK / *HSMS-CONTROLLED / list-poss(255): <cat-id 1..4>

Operands

PUBSET = <cat-id 1..4>
Identifies the pubset for which the space allocation is to be displayed.

INFORMATION = *SUMMARY / *ALL
Specifies how much information to display.

INFORMATION = *SUMMARY
Displays global information about space allocation on the entire pubset. With an SM pubset, the information is shown for each volume set selected in the SELECT-VOLUME-SET operand.

INFORMATION = *ALL
Displays global information about space allocation on the entire pubset (see INFORMATION=*SUMMARY).
Also, displays space allocation on all the volumes in an SF pubset or on the selected volume set of an SM pubset. 

SELECT-VOLUME-SET = *ALL / *STD / *WORK / *HSMS-CONTROLLED / list-poss(255): <cat-id 1..4>
This operand value is evaluated for SM pubsets only.
Identifies those volume sets in the SM pubset for which the space allocation is to be displayed. Volume sets can be selected by usage mode (see the USAGE operand of the MODIFY-PUBSET-DEFINITION-FILE command) or explicitly by catalog ID.

SELECT-VOLUME-SET = *ALL
Space allocation is shown for all volume sets.

SELECT-VOLUME-SET = *STD
Space allocation is shown only for volume sets which can be used as the storage location for ordinary files.

SELECT-VOLUME-SET = *WORK
Space allocation is shown only for volume sets which can be used as the storage location for work files.

SELECT-VOLUME-SET = *HSMS-CONTROLLED
Space allocation is shown only for volume sets which are used exclusively by the HSMS subsystem.

SELECT-VOLUME-SET = list-poss(255): <cat-id 1..4>
Catalog ID of the volume set for which the space allocation is to be displayed. Up to 255 volume sets can be listed.

Return codes

(SC2)

SC1

Maincode

Meaning


0

CMD0001

No errors


1

CMD0202

Syntax error


32

CMD0221

Internal system error


32

CMD2009

Error on output to S variables (e.g. subsystem not available)


64

CMD0216

User does not have necessary authorization


64

DMS140B

Pubset not available


130

DMS140F

Not enough class 4/5 memory

Output format

The output starts with a header line consisting of the command name. This is then followed for each pubset by:

  1. the output block with cross-pubset summary information

  2. the output block with information on the physical pubset configuration and the usage restrictions

Pubset-global summary information

The output block comprises one line showing the catalog ID, the pubset type (SF or SM) and the number of volumes or volume sets which belong to the pubset. With SM pubsets the default file format is shown as well.

Output for an SF pubset:

PUBSET <catid>: TYPE = SINGLE-FEATURE, VOLUMES = <n>

Output for an SM pubset:

PUBSET <catid>: TYPE = SYSTEM-MANAGED, VOLUMESETS = <m>,
               DEFAULT-FILE-FORMAT = <f> 

Information on the physical pubset configuration

The output block is introduced by the following header line:

--- PHYSICAL CONFIGURATION ---------------------------------------

For an SF pubset, the information about the volumes is displayed on one or more lines of values beneath the following header:

VOLUME-CONFIGURATION:
VOLUME   DEVICE    ALLOCATION    VOLUME   DEVICE    ALLOCATION
<vsn>    <type>    <alloc>       <vsn>    <type>    <alloc>

For each volume set of an SM pubset, the volume set ID and the number of volumes in the set are displayed. This is followed by information about the volumes one or more lines of values beneath the following header:

--- VOLUME SET INFORMATION  --------------------------------------
 VOLUME-SET <catid>: VOLUMES = <n>
 VOLUME CONFIGURATION:
 VOLUME   DEVICE    ALLOCATION    VOLUME   DEVICE    ALLOCATION
 <vsn>    <type>    <alloc>       <vsn>    <type>    <alloc>
Key to the output values

<catid>

pubset or volume set ID

<n>

number of volumes in the pubset/volume set

<vsn>

volume serial number of the volume

<type>

device type assigned to the volume

<alloc>

allocation capability of the volume

  • NOT RESTR: allocation possible

  • NOT ALLOWED: allocation not possible

  • PHYSICAL: volume can only be physically allocated

Output in S variables

The scope of the output varies depending on the type of pubset (SF or SM) and on the value of the INFORMATION operand. The following combinations are of importance:

Notation used in command

Abbreviated form used in table

Any pubset type, INFORMATION = any value

1

SF pubset, INFORMATION = any value

2

SF pubset, INFORMATION = *ALL

3

SM pubset, INFORMATION = any value

4

SM pubset, INFORMATION = *ALL

5

Output information

Name of the S variable       

T

Contents                           

Condition

Actual saturation level of the pubset; 6 stands for the ZIP level

var(*LIST).ACTUAL-SATUR-LEV

I

<integer 0..6>

2

Number of PAM pages available for occupation on the pubset

var(*LIST).AVAIL-SPACE

I

<integer 0..2147483647>

2

Number of disks on the pubset not affected by allocation restrictions

var(*LIST).NOT-RESTRICT-VOL

I

<integer 0..255>

2

Pubset ID

var(*LIST).PUBSET

S

<cat-id>

1

Pubset type

var(*LIST).PUBSET-TYPE

S

*SINGLE-FEATURE
*SYS-MANAGE

1

Number of disks on the pubset affected by allocation restrictions

var(*LIST).RESTRICT-VOL

I

<integer 0..255>

2

Total amount of free and occupied space on the pubset disks not affected by allocation restrictions (number of PAM pages)

var(*LIST).TOTAL-SPACE

I

<integer 0..2147483647>

2

Restrictions when occupying space on the disk
*NOT-RESTRICT=no restrictions
*PHYS-ONLY=can only be physically allocated
*NOT-ALLOW=no space can be occupied on the specified disk

var(*LIST).VOL(*LIST).ALLOC-MODE

S

*NOT-RESTRICT
*PHYS-ONLY
*NOT-ALLOW

3

Available space on a disk belonging to the pubset

var(*LIST).VOL(*LIST).AVAIL-SPACE

I

<integer 0..2147483647>

3

Occupied space on a disk belonging to a pubset

var(*LIST).VOL(*LIST).USED-SPACE 

I

<integer 0..2147483647>

3

VSN of the disk

var(*LIST).VOL(*LIST).VOL

S

<vsn>

3

Actual saturation level of the volume set; 6 stands for the ZIP level

var(*LIST).VOL-SET(*LIST).ACTUAL-SATUR-LEV

I

<integer 0..6>

4

Number of PAM pages available for allocation on the volume set

var(*LIST).VOL-SET(*LIST).AVAIL-SPACE

I

<integer 0..2147483647>

4

Restrictions concerning the creation of new files on the volume set
*NOT-RESTRICT=no restrictions
*PHYS-ONLY=can only be physically allocated
*NOT-ALLOW=no new files may be created on the volume set

var(*LIST).VOL-SET(*LIST).NEW-FILE-ALLOC


*NOT-RESTRICT
*PHYS-ONLY
*NOT-ALLOW

4

Number of disks belonging to the volume set that are not affected by allocation restrictions

var(*LIST).VOL-SET(*LIST).NOT-RESTRICT-
VOL

I

<integer 0..255>

4

Number of disks belonging to the volume set that are affected by allocation restrictions

var(*LIST).VOL-SET(*LIST).RESTRICT-VOL

I

<integer 0..255>

4

Total amount of free and occupied space on the volume set disks not affected by allocation restrictions (number of PAM pages)

var(*LIST).VOL-SET(*LIST).TOTAL-SPACE

I

<integer 0..2147483647>

4

Way in which the volume set is used

var(*LIST).VOL-SET(*LIST).USAGE

S

*STD
*WORK
*HSMS-CONTR

4

ID of the volume set

var(*LIST).VOL-SET(*LIST).VOL-SET

S

<cat-id>

4

Restrictions when occupying space on the individual disks of the volume set
*NOT-RESTRICT=no restrictions
*PHYS-ONLY=can only be physically allocated
*NOT-ALLOW=no space may be occupied on the specified disk

var(*LIST).VOL-SET(*LIST).VOL(*LIST).ALLOC-MODE

S

*NOT-RESTRICT
*PHYS-ONLY
*NOT-ALLOW

5

Available space on a disk of a volume set

var(*LIST).VOL-SET(*LIST).VOL(*LIST).
AVAIL-SPACE

I

<integer 0..2147483647>

5

Occupied space on a disk of a volume set

var(*LIST).VOL-SET(*LIST).VOL(*LIST).USED-SPACE 

I

<integer 0..2147483647>

5

VSN of the disk of a volume set

var(*LIST).VOL-SET(*LIST).VOL(*LIST).VOLUME

S

<vsn>

5

Powered by Atlassian Confluence and Scroll Viewport.