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-DEFINITION-FILE

&pagelevel(3)&pagelevel

Display SM pubset definitions

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-DEFINITION-FILE command provides information on the volume set-specific configuration parameters of system-managed pubsets (SM pubsets). Information is supplied only for locally available (imported) pubsets.

The configuration parameters can be modified with the MODIFY-PUBSET-DEFINITION-FILE command.

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

The volume-set-specific configuration parameters are also contained in the output of the SHOW-PUBSET-PARAMETERS command.

Format

SHOW-PUBSET-DEFINITION-FILE                                                                                                          

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

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

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

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 pubsets imported exclusively are displayed.

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

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

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.

VOLUME-SET = <cat-id 1..4>
Catalog ID of the volume set for which the configuration parameters 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)


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. 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 volume-set-specific configuration parameters

Pubset-global summary information

The output block comprises one line showing the catalog ID, the pubset type (SM pubset), the number of associated volumes or volume sets and the default file format. 

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

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> 

Key to 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

Two further information blocks are output 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. 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 / YES

    • 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. Performance requirements

    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

Output in S variables

Output information

Name of the S variable        

T

Contents                  

Condition

Number of volume sets for system-managed pubsets

var(*LIST).COUNT

I

<integer 1..255>


Maximum I/O transfer length (HP) of the system-managed pubset

var(*LIST).MAX-IO-LEN

I

<integer>


Pubset catalog ID

var(*LIST).PUBSET-ID

S

FALSE=none


Pubset type

var(*LIST).PUBSET-TYPE

S

*SINGLE-FEATURE
*SYS-MANAGE


Current allocation unit

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

I

<integer>


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

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

S

*ADM-ONLY
*NOT-RESTRICT


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

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

S

*STD
*HIGH


Volume set contains the pubset management data

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

S

*NO
*YES


DRV attribute of the volume set

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

S

*NO
*YES


format of the volume set

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

S

*K
*NK2
*NK4
*UNDEF


Current maximum I/O transfer length

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

I

<integer>


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


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

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

S

*STD
*HIGH
*VERY-HIGH


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


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


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


Volume set ID

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

S

<vsid>


Example

/show-pubset-definition-file pubset=2os6,volume-set=6vs5

----------------------------------------------------------------------------
COMMAND: SHOW-PUBSET-DEFINITION-FILE
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
PUBSET 2OS6: TYPE = SYSTEM-MANAGED, VOLUMESETS = 6, DEFAULT FILE FORMAT = K
---- VOLUME-SET INFORMATION --------- + ------------------------------------
VOLUME-SET 6VS5: NORMAL-USE, WORK, K-FORMAT
---- GLOBAL ATTRIBUTES      --------- + ------------------------------------
 AVAILABILITY                         | STANDARD
 USAGE                                | WORK
 FORMAT                               | K-FORMAT
 MAXIMAL I/O LENGTH                   | 80                     HP
 ALLOCATION UNIT SIZE                 | 3                      HP
 DRV-VOLSET                           | NO
 GS-VOLSET                            | NO
 NEW FILE ALLOCATION                  | NOT RESTRICTED
 VOLUME SET ACCESS                    | NOT RESTRICTED
---- PERFORMANCE ATTRIBUTES --------- + ------------------------------------
 PERFORMANCE                          | STANDARD
 WRITE-CONSISTENCY                    | BY-CLOSE
----------------------------------------------------------------------------
Powered by Atlassian Confluence and Scroll Viewport.