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-VOLUME-SET-LIST

&pagelevel(3)&pagelevel

Show volume set list definitions

Component:

BS2000

Functional area:

Pubset and MRSCAT management

Domain:

MULTI-CATALOG-AND-PUBSET-MGMT

Privileges:

TSOS

Function

The SHOW-VOLUME-SET-LIST command provides systems support staff with information on the composition of volume set lists defined for a system-managed (SM) pubset. If the definitions of more than one volume set list or of all volume set lists are requested, the set of volume set lists to be output can be restricted to specific volume sets by means of the SELECT operand.
Output can be directed either to SYSOUT or to SYSLST.

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

Format

SHOW-VOLUME-SET-LIST                                                                                                                        

VOLUME-SET-LIST-NAME = *ALL / <composed-name 1..8 with-wild>

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

,INFORMATION = *SUMMARY / *ALL

,SELECT = *ALL / *BY-VOLUME-SET(...)


*BY-VOLUME-SET(...)



|


ENTRY = list-poss(255): <cat-id 1..4>

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


*SYSLST(...)



|


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

Operands

VOLUME-SET-LIST-NAME = *ALL / <composed-name 1..8 with-wild>
Specifies the volume set lists for which information is required.

VOLUME-SET-LIST-NAME = *ALL
Information is required for all volume set lists which are assigned to the pubset specified in the PUBSET operand and also meet the selection criteria given in the SELECT operand. 

VOLUME-SET-LIST-NAME = <composed-name 1..8 with-wild>
Name of the volume set list for which information is required. Wildcards can be used to identify more than one volume set list.
Information is required for all specified volume set lists which are assigned to the pubset specified in the PUBSET operand and also meet the selection criteria given in the SELECT operand.

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 / *ALL
Specifies how much of the available information is to be output (see also section "Output format").

INFORMATION = *SUMMARY
For each volume set list specified, the name of the volume set list, the catalog ID of the SM pubset and the number of associated volume sets are output.

INFORMATION = *ALL
Output is as for INFORMATION=*SUMMARY, with the addition of a list of the associated volume sets and the brief descriptive text for each volume set list specified.

SELECT = *ALL / *BY-VOLUME-SET(...)
Specifies whether the set identified in the VOLUME-SET-LIST-NAME operand is to be restricted by selection criteria.

SELECT = *BY-VOLUME-SET(...)
Only volume set lists which contain one of the volume sets specified next are output.

ENTRY = list-poss(255): <cat-id 1..4>
Volume set ID.
Up to 255 volume sets can be listed.

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/Guaranteed messages


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 to use command


64

DMS1482

Error accessing volume set list catalog


64

DMS1484

Volume set list catalog invalid


64

DMS1485

Pubset not known


64

DMS1486

Pubset is not a system-managed pubset


64

DMS1487

Pubset not available


64

DMS148B

Volume set list not defined


64

DMS1490

Storage class management not available for this pubset


64

DMS149B

No volume set lists meet the selection criteria


64

DMS149D

No volume set list exists for the specified pubset


129

DMS148D

Not enough class 4/5 memory


129

DMS148E

Error on MSCF connection to master


129

DMS149E

Output error: SYSLST file cannot be extended


129

DMS148F

GCF subsystem not ready

Output format

The output information for each volume set list selected breaks down into the following three blocks:

  1. Information header

  2. List of the volume sets which belong to the volume set list

  3. Brief description of the volume set list

Which information blocks are output is governed by the value of the INFORMATION operand. With INFORMATION=*SUMMARY (default value), only the first block of information, i.e. the information header, is output. With INFORMATION=*ALL, the three blocks are output in succession. 

Information header

The information header consists of the following line of values.

NAME: <vslname>  PUBSET: <catid>  NUMBER-OF-VOLUME-SETS: <count>

Key:


<vslname>

Name of the volume set list

<catid>

Catalog ID of the SM pubset for which the volume set list is defined

<count>

Number of volume sets on the list


Listing of volume sets

This information block is output only with INFORMATION=*ALL.
The listing is preceded by the header:


------------------------ VOLUME-SETS ---------------------------


This is followed by up to 17 lines of values consisting of the IDs of the volume sets.
The number of lines of values depends on the number of volume sets defined in the volume set list. Each line can include up to 15 volume sets.
If there are no volume sets defined in the volume set list, a single line giving the value *NONE is output.

Brief description of the volume set list

This information block is output only with INFORMATION=*ALL.
The brief description is preceded by the header:


-------------------- VOLUME-SET-LIST-INFO ----------------------


This is followed by up to 10 lines showing the brief description text for the volume set list. The number of lines of values depends on the length of the brief description. Each line can include up to 74 characters.
If no brief description has been defined for the volume set list, a single line giving the value *NONE is output.

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 = *ALL

1

INFORMATION = *SUMMARY

2

Output information

Name of the S variable                        

T

Contents                

Condition

Number of volume sets belonging to the list

var(*LIST).COUNT

I

<integer 0..255>

1,2

Catalog ID of the pubset for which the volume set list is defined

var(*LIST).PUBSET

S

<cat-id 1..4>

1,2

Name of the volume set list

var(*LIST).VOL-SET-LIST

S

<comp.-name 1..8>

1,2

Free text formulated by the system administrator

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

S

"
<c-string 1..720>

1

ID of the volume set (output only for var(*LIST).COUNT > 0)

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

S

<cat-id 1..4>

1

Example

/show-volume-set-list volume-set-list-name = vsl1,
                       pubset = abcd, information = *all

NAME: VSL1          PUBSET: ABCD          NUMBER-OF-VOLUME-SETS: 6

------------------------- VOLUME-SETS ----------------------------

VST1 VST2 VST3 VST4 VST5 VST6

--------------------- VOLUME-SET-LIST-INFO -----------------------

Liste fuer high available Volume-Sets
Powered by Atlassian Confluence and Scroll Viewport.