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

&pagelevel(3)&pagelevel

Show current pubset configuration

Component:

BS2000

Functional area:

Pubset and MRSCAT management

Domain:

MULTI-CATALOG-AND-PUBSET-MGMT

Privileges:

TSOS
OPERATING
STD-PROCESSING

Routing code:

@

Function

The SHOW-PUBSET-CONFIGURATION command supplies information relating to the physical composition of pubsets which are available locally (imported). The information possible depends on the pubset type:

  • In the case of SM pubsets both cross-pubset and volume-set-specific configuration parameters are displayed (see also the MODIFY-PUBSET-DEFINITION-FILE command).

  • With regard to SF pubsets, the output is restricted to the summary information and information on the physical pubset configuration. The SHOW-MASTER-CATALOG-ENTRY command must be used to request any other information.

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

You also obtain some of the information of the SHOW-PUBSET-CONFIGURATION command with the following SHOW commands which exist as a counterpart to the corresponding MODIFY command:

Command                                                 

Corresponding operands in
SHOW-PUBSET-CONFIGURATION

SHOW-PUBSET-DEFINITION-FILE

INFORMATION=*VOLUME-SET-PARAMETERS(
    SELECT-VOLUME-SET=*ALL,
    VOLUME-SET-INFO=*ALL)

SHOW-PUBSET-PROCESSING

INFORMATION=*PHYSICAL-CONFIGURATION

SHOW-PUBSET-RESTRICTION

INFORMATION=*PHYSICAL-CONFIGURATION

Format

SHOW-PUBSET-CONFIGURATION

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

,SELECT-PUBSET = *ALL / *EXCLUSIVE / *SHARED / *HSMS-SUPPORTED

,INFORMATION = *SUMMARY / *VOLUME-SET-PARAMETERS(...) /

list-poss(2): *PHYSICAL-CONFIGURATION / *PUBSET-FEATURES


*VOLUME-SET-PARAMETERS(...)



|


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



|


,SELECT-VOLUME-SET = *ALL / *NORMAL-USE / *IN-HOLD / *DEFECT / *DEFINED-ONLY



|


,VOLUME-SET-INFO = *SUMMARY / *ALL / list-poss(2): *GLOBAL-ATTRIBUTES /



|


*PERFORMANCE-ATTRIBUTES

Operands

PUBSET = *ALL / <cat-id 1..4>
Identifies the locally available pubsets for which the configuration parameters are to be displayed.

PUBSET = *ALL
The configuration parameters of all locally available pubsets are to be displayed. The SELECT-PUBSET operand can be used to restrict the selection to specific pubsets.

PUBSET = <cat-id 1..4>
Catalog ID of the pubset for which the configuration parameters are to be displayed.

SELECT-PUBSET = *ALL / *EXCLUSIVE / *SHARED / *HSMS-SUPPORTED
Defines criteria for selecting specific pubsets from the set of all locally available pubsets (see PUBSET=*ALL). The default is *ALL, i.e. the configuration parameters of all pubsets are displayed.

SELECT-PUBSET = *EXCLUSIVE
The configuration parameters of all exclusive imported pubsets are displayed.

SELECT-PUBSET = *SHARED
The configuration parameters of all shared imported pubsets are displayed.

SELECT-PUBSET = *HSMS-SUPPORTED
The configuration parameters of all SM pubsets which are supported by the HSMS subsystem are displayed.

INFORMATION = *SUMMARY / *VOLUME-SET-PARAMETERS(...) / list-poss(2): *PHYSICAL-CONFIGURATION / *PUBSET-FEATURES
Specifies the configuration parameters which are to be displayed and the scope of the information.

INFORMATION = *SUMMARY
Only summary information relating to the pubset configuration is displayed. This comprises the pubset type and the number of volumes (in SF pubsets) or the number of volume sets and the default file format (in SM pubsets).

INFORMATION = *VOLUME-SET-PARAMETERS(...)
In the case of SM pubsets, the configuration parameters are shown relative to volume sets. The following operands select the volume sets and the scope of the information.

VOLUME-SET = *ALL / <cat-id 1..4>
Identifies the volume sets for which the configuration parameters are to be displayed.

VOLUME-SET = *ALL
The configuration parameters of all volume sets are to be shown. The SELECT-VOLUME-SET operand can be used to restrict the selection to specific volume sets.

VOLUME-SET = <cat-id 1..4>
Catalog ID of the volume set for which the configuration parameters are to be displayed.

SELECT-VOLUME-SET = *ALL / *NORMAL-USE / *IN-HOLD / *DEFECT / *DEFINED-ONLY
Defines criteria for selecting specific volume sets from the set of all volume sets (see VOLUME-SET=*ALL). The default is *ALL, i.e. the configuration parameters of all volume sets are displayed.

SELECT-VOLUME-SET = *NORMAL-USE
The configuration parameters of all accessible volume sets are displayed.

SELECT-VOLUME-SET = *IN-HOLD
The configuration parameters of all temporarily inoperable volume sets are displayed.

SELECT-VOLUME-SET = *DEFECT
The configuration parameters of all defective volume sets are displayed.

SELECT-VOLUME-SET = *DEFINED-ONLY
The configuration parameters of all defined but inaccessible volume sets are displayed.

VOLUME-SET-INFO = *SUMMARY / *ALL / list-poss(2): *GLOBAL-ATTRIBUTES / *PERFORMANCE-ATTRIBUTES
Specifies the configuration parameters which are to be displayed and the scope of the information.

VOLUME-SET-INFO = *SUMMARY
Only summary information relating to the volume set-specific configuration parameters is displayed. This comprises the volume set ID and the operating status of the volume set. The summary information is also included with all the other operand values. *SUMMARY, in addition, shows the format, the usage mode if it differs from the default and the availability.

VOLUME-SET-INFO = *ALL
The output consists of the summary information, the global attributes and the performance attributes of the volume set.

VOLUME-SET-INFO = *GLOBAL-ATTRIBUTES
In addition to the summary, information on the following configuration parameters is supplied:

  • availability of the volume set

  • usage mode of the volume set

  • format of the volume set

  • maximum I/O length

  • allocation unit

  • DRV attributes

  • restrictions on file creation and volume set access

VOLUME-SET-INFO = *PERFORMANCE-ATTRIBUTES
In addition to the summary, information on the volume set-specific profile of the performance attributes is supplied.

INFORMATION = *PHYSICAL-CONFIGURATION
In addition to the summary (see INFORMATION=*SUMMARY), detailed information on the physical pubset configuration is supplied. This comprises the name, device type and allocation capabilities of the volumes (in SF pubsets) or of the volume sets and their volumes (in SM pubsets).

INFORMATION = *PUBSET-FEATURES
In addition to the summary (see INFORMATION=*SUMMARY), the following pubset attributes are shown for SF pubsets:

  • format attributes

  • maximum I/O length

  • allocation unit

  • DRV attributes

Return codes

(SC2)

SC1

Maincode

Meaning


0

CMD0001

No errors


32

CMD0221

Internal system error


32

CMD2009

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


32

DMS138A

Internal parameter error


64

DMS1381

Volume set conflict


64

DMS138B

Pubset does not exist or not with specified attribute


64

DMS138C

Pubset not accessible


64

DMS138E

Volume set does not exist


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 four groups of output blocks:

  1. output block giving pubset-global summary information (INFORMATION=*SUMMARY)

  2. output block giving information on the physical pubset configuration (INFORMATION=*PHYSICAL-CONFIGURATION)

  3. output block giving information on the pubset-global configuration parameters (INFORMATION=*PUBSET-FEATURES); output for SF pubsets only

  4. output block giving information on the volume set-specific configuration parameters (INFORMATION=*VOLUME-SET-PARAMETERS)

If information is supplied for a number of pubsets, SF pubsets are listed before SM pubsets.

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. In more detailed information output, this line is also displayed as a header before each pubset information block.

Output for an SF pubset:

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

Output for an SM pubset:

PUBSET <catid>: TYPE = SYSTEM-MANAGED, VOLUME-SETS = <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>

Meaning of 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

Information on the pubset-global configuration parameters

This information is output for SF pubsets only. The output block is introduced by the following header line:

--- PUBSET FEATURES       ---- + ---------------------------------

This is followed by the information in table form. The left-hand column identifies the parameter, the right-hand its possible values.

  • Information on pubset format:

    PUBSET-FORMAT                 | K-FORMAT
                              | NK2-FORMAT
                              | NK4-FORMAT

  • Information on maximum I/O length (in PAM pages)

    MAXIMAL I/O LENGTH            | <n> HP

  • Information on the smallest allocation unit (in PAM pages)

    ALLOCATION UNIT SIZE          | <n> HP

  • Information on disk attributes with regard to DRV:

    DRV-PUBSET                    | NO
                              | YES

Information on volume set-specific configuration parameters

The output block is introduced by the following header line:

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

The volume set-specific summary information is output for each volume set:

VOLUME-SET <catid>:  [CONTROL-VOLSET] <status>,<usage>,<format>,<avail> 

Meaning of the output values:

<catid>

Volume set ID

CONTROL-VOLSET

Output for the control volume set only. This volume set contains the SM pubset control data.

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

<usage>

Usage mode (output only if the default does not apply)

  • WORK

  • Storage location for work files

  • HSMS

  • Supported by the HSMS subsystem

<format>

File format

  • K-FORMAT

  • Storage location for K files

  • NK2-FORMAT

  • Storage location for NK2 files

  • NK4-FORMAT

  • Storage location for NK4 files

<avail>

Availability (output only if the default does not apply)

  • HIGH-AVAIL

  • High availability

The VOLUME-SET-INFO operand enables two other information blocks to be requested in addition to the summary information. These items of information are each preceded by a header line and are then displayed in table form. The left-hand column identifies the parameter, the right-hand its possible values. A value of list-poss(n): means that up to n values can be displayed, each on a separate line. 

  1. Output with VOLUME-SET-INFO = *GLOBAL-ATTRIBUTES

    The output begins with the following header line:

    --- GLOBAL ATTRIBUTES     ---- + ---------------------------------

    Then come the individual items of information:

    • Information on the availability attributes of the volume set:

      AVAILABILITY                  | STANDARD
                              | HIGH

    • Information on the usage modes of the volume set:

      USAGE                         | STANDARD
                              | WORK
                              | HSMS-CONTROLLED

    • Information on the volume set format:

      FORMAT                        | UNDEFINED 
                              | K-FORMAT
                              | NK2-FORMAT
                              | NK4-FORMAT

    • Information on the maximum I/O length (in PAM pages).

      MAXIMAL I/O LENGTH            | <n> HP

    • Information on the smallest allocation unit (in PAM pages).

      ALLOCATION UNIT SIZE          | <n> HP

    • Information on disk attributes with regard to DRV:

      DRV-VOLSET                    | NO

    • Information on restrictions on new file allocation:

      NEW FILE ALLOCATION           | NOT RESTRICTED
                              | PHYSICAL ONLY
                              | NOT ALLOWED

    • Information on volume set access:

      VOLUME SET ACCESS             | NOT RESTRICTED
                              | ADMIN ONLY

  2. Output with VOLUME-SET-INFO = *PERFORMANCE-ATTRIBUTES

    The output begins with the following header line:

    PERFORMANCE-ATTRIBUTES        |

    Then come the individual items of information:

    • Information on the performance attribute profile:

      PERFORMANCE:                 | NO VALUES 
                             | or list-poss(3):
                             | STANDARD
                             | HIGH
                             | VERY-HIGH

    • Information on the time at which data consistency is required:

      WRITE-CONSISTENCY:           | IMMEDIATE
                             | BY-CLOSE

The output for VOLUME-SET-INFO=*ALL includes both these additional information blocks. 

Output in S variables

The INFORMATION operand identifies the S variables which are to be created. The following specifications are possible for INFORMATION:

Notation used in command

Abbreviated form used in table

INFORMATION = *PHYSICAL-CONFIGURATION

1

INFORMATION = *PUBSET-FEATURES (SF-Pubsets only)

2

INFORMATION = *SUMMARY

3

INFORMATION = *VOLUME-SET-PARAMETERS(VOLUME-SET-INFO=*GLOBAL-ATTRIBUTES)

4

INFORMATION = *VOLUME-SET-PARAMETERS(VOLUME-SET-INFO=*PERFORMANCE-ATTRIBUTES)

5

INFORMATION = *VOLUME-SET-PARAMETERS(VOLUME-SET-INFO=*SUMMARY)

6

Output information

Name of the S variable   

T

Contents                

Condition

Number of volume sets for single-feature pubsets
Number of volume sets for SM pubsets

var(*LIST).COUNT

I

<integer 1..255>

1,2,3,4,5,6

Maximum I/O transfer length (HP) of the SM pubset

var(*LIST).MAX-IO-LEN

I

<integer>

1,2,3,4,5,6

allocation unit

var(*LIST).PUBSET.ALLOC-UNIT-SIZE

I

<integer>

2

DRV attribute of the pubset

var(*LIST).PUBSET.DRV

S

*NO
*YES

2

Format of the SF pubset

var(*LIST).PUBSET.FORM

S

*K
*NK2
*NK4

2

Maximum I/O transfer length (HP)

var(*LIST).PUBSET.MAX-IO-LEN

I

<integer>

2

Pubset catalog ID

var(*LIST).PUBSET-ID

S

FALSE=none

1,2,3,4,5,6

Pubset type

var(*LIST).PUBSET-TYPE

S

*SINGLE-FEATURE
*SYS-MANAGE

1,2,3,4,5,6

Allocation lock for the SF pubset
*NOT-RESTRICT=no lock
*NOT-ALLOW=locked against allocation
*PHYS-ONLY=can only be allocated physically

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

S

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

1

Device types of the SF pubset volumes

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

S

<device>

1

VSNs of the SF pubset volumes

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

S

<vsn>

1

Current allocation unit

var(*LIST).VOLSET(*LIST).ALLOC-UNIT-SIZE

I

<integer>

4

Access to volume set
*ADM-ONLY=for system support only
*NOT-RESTRICT=not restricted

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

S

*ADM-ONLY
*NOT-RESTRICT

4

Current availability status
*STD=no increased data availability
*HIGH=increased data availability

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

S

*STD
*HIGH

4 

Volume set contains the pubset management data

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

S

*NO
*YES

4,5,6

DRV attribute of the volume set

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

S

*NO
*YES 

4

Format of the volume set

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

S

*K
*NK2
*NK4
*UNDEF

4

Current maximum I/O transfer length

var(*LIST).VOLSET(*LIST).MAX-IO-LEN

I

<integer>

4

Current allocation restrictions
*NOT-RESTRICT=no restrictions
*PHYS-ONLY=can only be allocated physically
*NOT-ALLOW=allocation not permitted

var(*LIST).VOLSET(*LIST).NEW-FILE-ALLOC

S

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

4

I/O performance
*STD=not increased
*HIGH=high
*VERY-HIGH=highest

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

S

*STD
*HIGH
*VERY-HIGH

5

Data consistency in conjunction with increased I/O performance
*BY-CLOSE=no data consistency
*IMMED=data consistency

var(*LIST).VOLSET(*LIST).PERF.WRITE-CONSIST

S

*BY-CLOSE
*IMMED

5

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

4,5,6

Files belonging to the volume set
*HSMS-CONTR=HSMS files only
*STD=standard files only
*WORK=work files only

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

S

*HSMS-CONTR
*STD
*WORK

4

Volume set ID

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

S

<vsid>

1,4,5,6

Number of volumes for the volume

var(*LIST).VOLSET(*LIST).VOL-COUNT

I

<integer 0..255>

1

Allocation lock for the volume set
*NOT-RESTRICT=no lock
*NOT-ALLOW=locked against allocation
*PHYS-ONLY=can only be allocated physically 

var(*LIST).VOLSET(*LIST).VOL(*LIST).ALLOC

S

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

1

Device types of the volumes per volume set

var(*LIST).VOLSET(*LIST).VOL(*LIST).DEV

S

<device>

1

VSNs of the volumes per volume set

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


<vsn>

1

Powered by Atlassian Confluence and Scroll Viewport.