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-STORAGE-CLASS

&pagelevel(3)&pagelevel

Show storage class definitions

Component:

BS2000

Functional area:

File processing
Pubset and MRSCAT management

Domain:

MULTI-CATALOG-AND-PUBSET-MGMT

Privileges:

TSOS
STD-PROCESSING

Function

The SHOW-STORAGE-CLASS command outputs the definitions of the storage classes of a system-managed (SM) pubset. If the definitions of more than one storage classes are requested, the set of storage classes to be output can be restricted by means of the SELECT operand to storage classes with specific attributes. Output can be directed either to SYSOUT or to SYSLST.

Storage classes protected by a guard are shown only to users who are authorized to use them.
The user can either request just general information on the storage class or also view the file attributes and the brief description for the storage class.

The SM pubset must have been imported to the local system (in exclusive or shared mode).

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

Privileged functions

Systems support staff (TSOS privilege) can request information on all storage classes. They can use INFORMATION=*VOLUME-SET-LIST to find out about the volume set list assigned to a storage class. If they request all information with INFORMATION=*ALL, in addition to the file attributes and the brief description they are shown information on the protection attributes of a storage class and on the assigned volume set list. 

Format

SHOW-STORAGE-CLASS

STORAGE-CLASS-NAME = *ALL / <composed-name 1..8 with-wild>

,PUBSET = <cat-id 1..4>

,INFORMATION = *SUMMARY / *VOLUME-SET-LIST / *ALL

,SELECT = *ALL / *PARAMETERS(...)


*PARAMETERS(...)



|


FILE-ATTRIBUTES = *ANY / *PARAMETERS(...)



|



*PARAMETERS(...)



|




|


IO-ATTRIBUTES = *ANY / *PARAMETERS(...)



|




|



*PARAMETERS(...)



|




|




|


PERFORMANCE = *ANY / list-poss(3): *STD / *HIGH / *VERY-HIGH



|




|




|


,USAGE = *ANY / list-poss(3): *READ-WRITE / *WRITE / *READ



|




|


,DISK-WRITE = *ANY / list-poss(3): *STD / *IMMEDIATE / *BY-CLOSE



|




|


,AVAILABILITY = *ANY / list-poss(2): *STD / *HIGH



|




|


,FILE-PREFORMAT = *ANY / list-poss(4): *BY-PUBSET-DEFAULT / *K / *NK2 / *NK4



|




|


,WORK-FILE = *ANY / list-poss(2): *NO / *YES



|


,VOLUME-SET-LIST = *ANY / *NONE / <composed-name 1..8>

,OUTPUT = *SYSOUT / *SYSLST(...)


*SYSLST(...)



|


SYSLST-NUMBER = *STD / <integer 1..99>

Operands

STORAGE-CLASS-NAME = *ALL / <composed-name 1..8 with-wild>
Specifies the storage classes for which information is required.

STORAGE-CLASS-NAME = *ALL
Information is required for all storage classes which are assigned to the pubset specified in the PUBSET operand and also meet the selection criteria given in the SELECT operand.

STORAGE-CLASS-NAME = <composed-name 1..8 with-wild>
Name of the storage class for which information is required. Wildcards can be used to identify more than one storage class.

PUBSET = <cat-id 1..4>
Identifies the associated SM pubset. The pubset must have been imported to the local system (in exclusive or shared mode).

INFORMATION = *SUMMARY / *VOLUME-SET-LIST / *ALL
Specifies how much of the available information is to be output for each selected storage class.

INFORMATION = *SUMMARY
Only the name of the storage class and the catalog ID of the assigned pubset are output.

INFORMATION = *VOLUME-SET-LIST
Only allowed for users with TSOS privilege.
Output is as for INFORMATION=*SUMMARY, with the addition of the name of the assigned volume set list.

INFORMATION = *ALL
Output is as for INFORMATION=*SUMMARY, with the addition of the file attributes defined for the storage class and the brief description.
Users with TSOS privilege are also shown information on the protection attributes of the storage class and the name of the volume set list assigned to it.

SELECT = *ALL / *PARAMETERS(...)
Specifies whether the set of storage classes identified in the STORAGE-CLASS-NAME operand is to be restricted by selection criteria.

SELECT = *ALL
There is no restriction on the set of storage classes identified in the STORAGE-CLASS-NAME operand.

SELECT = *PARAMETERS(...)
Defines selection criteria restricting the set of storage classes identified in the STORAGE-CLASS-NAME operand. Only those storage classes which possess all the attributes specified next are to be output.
The default value, *ANY, means that the attribute in question is not a selection criterion.

FILE-ATTRIBUTES = *ANY / *PARAMETERS(...)
Specifies whether the selection of storage classes to be output is to be based on the file attributes defined in them.

FILE-ATTRIBUTES = *ANY
The file attributes are not a selection criterion.

FILE-ATTRIBUTES = *PARAMETERS(...)
The storage classes which are to be output are selected on the basis of the file attributes specified next.

IO-ATTRIBUTES = *ANY / *PARAMETERS(...)
Specifies whether the performance attributes are to be a selection criterion.

IO-ATTRIBUTES = *PARAMETERS(...)
The storage classes which are to be output must have definitions containing the performance attributes specified next.

PERFORMANCE = *ANY / list-poss(3): *STD / *HIGH / *VERY-HIGH
Selects all storage classes which possess one of the specified performance attributes.

PERFORMANCE = *ANY
The performance attribute is not a selection criterion.

PERFORMANCE = *STD
Selects only those storage classes which have their performance attribute set to *STD (no special performance requirement).

PERFORMANCE = *HIGH
Selects only those storage classes which have their performance attribute set to *HIGH (high performance requirement).

PERFORMANCE = *VERY-HIGH
Selects only those storage classes which have their performance attribute set to *VERY-HIGH (very high performance requirement).

USAGE = *ANY / list-poss(3): *READ-WRITE / *WRITE / *READ
Selects all storage classes which have the performance attribute set for one of the specified I/O operations.

USAGE = *ANY
The I/O operation mode is not a selection criterion.

USAGE = *READ-WRITE
Selects only those storage classes which have the performance attribute for read/write operations set.

USAGE = *WRITE
Selects only those storage classes which have the performance attribute for write operations set.

USAGE = *READ
Selects only those storage classes which have the performance attribute for read operations set.

DISK-WRITE = *ANY / list-poss(3): *STD / *IMMEDIATE / *BY-CLOSE
Specifies whether the attribute governing the time when data consistency is required after write operations is to be a selection criterion.

DISK-WRITE = *ANY
The point at which data consistency is required is not a selection criterion.

DISK-WRITE =*STD
Selects only those storage classes which have their consistency point defined as DISK-WRITE=*STD.

DISK-WRITE = *IMMEDIATE
Selects only those storage classes which have their consistency point defined as immediately after completion of write operations.

DISK-WRITE = *BY-CLOSE
Selects only those storage classes which have their consistency point defined as only after CLOSE processing.

AVAILABILITY = *ANY / list-poss(2): *STD / *HIGH
Specifies whether the availability attribute is to be a selection criterion.

AVAILABILITY = *ANY
The required availability is not to be a selection criterion.

AVAILABILITY = *STD
Selects only those storage classes for which no special availability requirements are defined.

AVAILABILITY = *HIGH
Selects only those storage classes for which high availability requirements are defined.

FILE-PREFORMAT = *ANY / list-poss(4): *BY-PUBSET-DEFAULT / *K / *NK2 / *NK4
Specifies whether the attribute for preferred file format is to be a selection criterion.

FILE-PREFORMAT = *ANY
The preferred file format is not to be a selection criterion.

FILE-PREFORMAT = *BY-PUBSET-DEFAULT
Selects only those storage classes for which the preferred file format is defined as the pubset-global default.

FILE-PREFORMAT = *K
Selects only those storage classes in which files are set to be created as K files.

FILE-PREFORMAT = *NK2
Selects only those storage classes in which files are set to be created as NK2 files.

FILE-PREFORMAT = *NK4
Selects only those storage classes in which files are set to be created as NK4 files.

WORK-FILE = *ANY / list-poss(2): *NO / *YES
Specifies whether the work file attribute is to be a selection criterion.

WORK-FILE = *ANY
The work file attribute is not to be a selection criterion.

WORK-FILE = *NO
Selects only those storage classes in which files are created as normal files.

WORK-FILE = *YES
Selects only those storage classes in which files are created as work files.

VOLUME-SET-LIST = *ANY / *NONE / <composed-name 1..8>
Specifies whether the storage classes are to be selected on the basis of volume set list assignment.

VOLUME-SET-LIST = *ANY
Volume set list assignment is not to be a selection criterion.

VOLUME-SET-LIST = *NONE
Selects only those storage classes to which no volume set list is assigned.

VOLUME-SET-LIST = <composed-name 1..8>
Selects only those storage classes to which the specified volume set list is assigned.

OUTPUT = *SYSOUT / *SYSLST(...)
Specifies where the information is to be output.

OUTPUT = *SYSOUT
The information is output to the system file SYSOUT.

OUTPUT = *SYSLST(...)
The information is output to the system file SYSLST.

SYSLST-NUMBER = *STD / <integer 1..99>
Specifies whether the information is to be output to the system file SYSLST or to a SYSLST file from the set SYSLST01 through SYSLST99.
The default is *STD, i.e. output is directed to the system file SYSLST. 

Return codes

(SC2)

SC1

Maincode

Meaning


0

CMD0001

No errors


1

CMD0202

Syntax error in command


32

CMD0221

Internal system error


32

CMD2009

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


64

CMD0216

No authorization for some command parameters


64

DMS1481

Error accessing storage class catalog


64

DMS1483

Storage class catalog invalid


64

DMS1485

Pubset not known


64

DMS1486

Pubset is not a system-managed pubset


64

DMS1487

Pubset not available


64

DMS148A

Storage class not defined


64

DMS1490

Storage class management not available for this pubset


64

DMS149A

No storage classes meet the selection criteria


64

DMS149C

No storage class exists for the specified pubset


64

DMS149F

No access right for storage class


129

DMS148D

Not enough class 4/5 memory


129

DMS148E

Error on MSCF connection to master


129

DMS148F

GCF subsystem not ready


129

DMS1498

GUARDS subsystem not ready


129

DMS149E

Output error: SYSLST file cannot be extended

Output format

The output information for each storage class selected breaks down into the following five blocks:

  1. General information on the storage class

  2. File attributes defined in the storage class

  3. Protection attributes of the storage class (for privileged users only)

  4. Information on the assigned volume set list (for privileged users only)

  5. Brief description of the storage class

Information blocks 3 and 4 are shown to privileged users only. 

Which information blocks are output is governed by the privilege that the calling user has and by the value of the INFORMATION operand. The following table shows which information blocks (identified by number) are output and the order in which they appear.

Value of INFORMATION operand

Privilege

TSOS

STD-PROCESSING

*SUMMARY

1

1

*VOLUME-SET-LIST

1 + 4

Combination not allowed

*ALL

1 + 2 + 3 + 4 + 5

1 + 2 + 5

Table 156: Scope of SHOW-STORAGE-CLASS command output
General information on the storage class

The following line of general information is output:

NAME: <scname>      PUBSET: <catid>

Key:

<scname>

Name of the storage class

<catid>

ID of the SM pubset for which the storage class is defined

File attributes of the storage class

The information block begins with the header line “FILE-ATTRIBUTES” and has the following layout:

---------------------- FILE-ATTRIBUTES -------------------------
  PERFORMANCE:       USAGE:             DISK-WRITE:
    <perf>             <usage>            <diskw>
  AVAILABILITY:      FILE-PREFORMAT:    WORK-FILE:
    <avail>            <format>           <work>

The output fields and the values shown correspond to the file attributes selected for the storage class definition in the CREATE-STORAGE-CLASS command. 

Output field

Values

Meaning

PERFORMANCE


Performance attribute:

STANDARD

no special performance requirement

HIGH

high performance priority

VERY-HIGH

very high performance priority

USAGE


I/O operation mode in conjunction with performance requirement:

READ-WRITE

read and write operations

WRITE

write operations only

READ

read operations only

DISK-WRITE


Time when data consistency is required

STANDARD

For permanent files = IMMEDIATE, for temporary files = BY-CLOSE.

IMMEDIATE

The file is to be in a consistent state immediately after write operations.

BY-CLOSE

The file does not need to be in a consistent state until after CLOSE processing.

AVAILABILITY


Availability:

STANDARD

no special availability requirements

HIGH

high availability

FILE-PREFORMAT


Preferred file format:

BY-PUBSET-DEFAULT

the pubset-global default applies.

K-FORMAT

files are to be created as K files.

NK2-FORMAT

files are to be created as NK2 files.

NK4-FORMAT

files are to be created as NK4 files.

WORK-FILE


Work file attribute:

NO

normal files are created.

YES

only work files are created.

Table 157: Output fields for file attributes with the SHOW-STORAGE-CLASS command

Protection attributes of the storage class (for privileged users only)

The information block begins with the header line “PROTECTION” and has the following layout:

------------------------- PROTECTION ---------------------------
*NONE

or

GUARD-NAME: <profile>

If the storage class is not protected by a guard, *NONE is output on the value line. If it is, the value line shows the name of the guard in place of <profile>.

Information on the assigned volume set list (for privileged users only)

The information block begins with the header line “ASSIGNED VOLUME-SET-LIST” and has the following layout:

------------------ ASSIGNED VOLUME-SET-LIST --------------------
*NONE

or

<list>

If the storage class is not assigned a volume set list, *NONE is output on the value line. If it is, the value line shows the name of the volume set list in place of <list>.

Brief description of the storage class

The information block begins with the header line “STORAGE-CLASS-INFO” and has the following layout:

---------------------- STORAGE-CLASS-INFO ----------------------
*NONE

or

<text>

If no brief description has been defined for the storage class, *NONE is output on the value line.
If there is a brief description, the value line shows the defined text in place of <text>. The line holds a maximum of 74 characters. If the text is longer, it is split across the appropriate number of lines (no more than 10). 

Output in S variables

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

Notation used in command

Abbreviated form used in table

INFORMATION = *ALL

1

INFORMATION = *SUMMARY

2

INFORMATION = *VOLUME-SET-LIST (only for privileged users)

3

Output information

Name of the S variable  

T

Contents                 

Condition

Requirements with regard to failsafe capability *STD=no particular requirements *HIGH=increased failsafe capability required

var(*LIST).F-ATTR.AVAIL

S

*STD
*HIGH

1

Requested file consistency time
*STD=permanent files: as with *IMMED; temporary files: as with *BY-CLOSE
*IMMED=immediately after terminating the write operation
*BY-CLOSE=after CLOSE processing

var(*LIST).F-ATTR.DISK-WRITE

S

*STD
*IMMED
*BY-CLOSE

1

Intended file format for initial allocation
*BY-PUBSET-DEF=default format of the pubset
*K=K format
*NK2=NK2 format
*NK4=NK4 format

var(*LIST).F-ATTR.F-PREFORM

S

*BY-PUBSET-DEF
*K
*NK2
*NK4

1

Performance requirements
*STD=no particular requirements
*HIGH=high performance requirements
*VERY-HIGH=very high performance requirements

var(*LIST).F-ATTR.IO-ATTR.PERF

S

*STD
*HIGH
*VERY-HIGH

1

Type of file accesses for which the performance requirement *HIGH or *VERY-HIGH applies
*READ-WRITE=for read and write operations
*WRITE=for write operations only
*READ=for read operations only

var(*LIST).F-ATTR.IO-ATTR.USAGE

S

*READ-WRITE
*WRITE
*READ

1 

Indicator relating to work files
*NO=storage class for normal files
*YES=storage class for work files 

var(*LIST).F-ATTR.WORK-F

S

*NO
*YES

1

GUARDS protection for the storage class (privileged users only)
*NONE=no protection
<profile>=name of a GUARDS profile

var(*LIST).PROT-GUARD

S

*NONE
<filename 1..18>

1

Catalog ID of the pubset for which the storage class is defined

var(*LIST).PUBSET

S

<cat-id>

1,2,3

Name of the storage class

var(*LIST).STOR-CLASS

S

<comp.-name 1..8>

1,2,3

Free text selected by the system administrator

var(*LIST).STOR-CLASS-INFO

S

"
<c-string 1..720>

1

Name of the volume set list assigned to this storage class (for privileged users only)

var(*LIST).VOL-SET-LIST

S

<comp.-name 1..8>
*NONE

1,3

Example

/show-storage-class storage-class-name = stc1,
                    pubset = abcd,
                    information = *all

NAME: STC1          PUBSET: ABCD

---------------------- FILE-ATTRIBUTES -------------------------

  PERFORMANCE:       USAGE:             DISK-WRITE:
    VERY-HIGH          READ-WRITE         IMMEDIATE
  AVAILABILITY:      FILE-PREFORMAT:    WORK-FILE:
    STANDARD           BY-PUBSET-DEFAULT  NO

------------------------- PROTECTION ---------------------------

GUARD-NAME: $TSOS.STC.GUARD

------------------ ASSIGNED VOLUME-SET-LIST --------------------

VSL1

---------------------- STORAGE-CLASS-INFO ----------------------

      Apart from the pubset service requirements that can be
      represented in the form of attributes, the following
      additional requirement is defined for this storage class:
      Files are to be stored on an SSD volume set.

In this case, systems support used the SHOW-STORAGE-CLASS command to request all the available information about storage class STC1, which has been defined for SM pubset ABCD.

Powered by Atlassian Confluence and Scroll Viewport.