SHOW-PUBSET-CATALOG-ALLOCATION

Display information on catalogs of a pubset

Component:	BS2000
Functional area:	Pubset and MRSCAT management
Domain:	MULTI-CATALOG-AND-PUBSET-MGMT
Privileges:	TSOS

Function

The SHOW-PUBSET-CATALOG-ALLOCATION command enables systems support to display information on the format of a pubset, its catalogs, the utilization level of these catalogs and how these catalogs can be extended.

Information on shared pubsets is only output on the master system.

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

Format

SHOW-PUBSET-CATALOG-ALLOCATION                                                                                                

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

Operands

PUBSET-ID = *ALL / <cat-id 1..4>
Designates the pubset for which the information is to be output. The default *ALL causes information to be output for all the pubsets which the local computer has imported exclusively or as master.

Return codes

(SC2)	SC1	Maincode	Meaning/Guaranteed messages
	0	CMD0001	Command executed without error
	32	CMD0221	Internal error
	32	CMD2009	Error when generating S variables
	64	DMS0301	Catalog not available
	64	DMS0312	Catalog not known in system
	64	DMS134C	MRSCAT cannot be determined
	64	DMS13BF	Pubset is not master
	130	DMS0594	Not enough virtual memory available
	130	OPS0001	Lack of memory when outputting in S variables

Format of the output

Output for an SM pubset:

===========================================================================
PUBSET-ID:  XXXX        TYPE: SM-PUBSET      CATALOG-FORMAT: XXXX
===========================================================================
CATALOG      | USED |   EXTENSION                           |   REMARK
---------------------------------------------------------------------------
 INDEX       | nn % | <text>                                | <remark-text>
 NAME-LIST   | nn % | <text>                                | <remark-text>
 NL-COPY     | nn % | <text>                                | <remark-text>
 JV          | nn % | <text>                                | <remark-text>
 MIGRATED    | nn % | <text>                                | <remark-text>
 PRIVATE     | nn % | <text>                                | <remark-text>
 Volset-ID 1 | nn % | <text>                                | <remark-text>
 ...         |      |                                       |
 Volset-ID n | nn % | <text>                                | <remark-text>

Output for an SF pubset:

===========================================================================
PUBSET-ID:  XXXX        TYPE: SF-PUBSET      CATALOG-FORMAT: XXXX
===========================================================================
CATALOG      | USED |    EXTENSION                          |   REMARK
---------------------------------------------------------------------------
 XXXX        | nn % | <text>                                | <remark-text> 

Explanation of the output

Field/column and possible values	Meaning
PUBSET-ID	Pubset identification (catalog ID)
TYPE SM-PUBSET SF-PUBSET	Pubset type
CATALOG-FORMAT NORMAL LARGE EXTRA LARGE	Catalog format
CATALOG	Name of the catalog to which the information line belongs:
INDEX	Information on the catalog index file TSOSCAT.$PFI
NAME-LIST	Information on the name list file TSOSCAT.$NLO
NL-COPY	Information on the name list copy file TSOSCAT.$NLC
JV	Information on the catalog for the job variables. With the “extra large” format the catalog consists of several files and the information is combined for these files.
MIGRATED	Information on the catalog for the migrated and no-space files. With the “extra large” format the catalog consists of several files and the information is combined for these files.
PRIVATE	Information on the catalog for the private disk and tape files. With the “extra large” format the catalog consists of several files and the information is combined for these files.
<Volset-ID i>	Information on the catalog of volume set i.
<catid>	SF pubset only: Information on the TSOSCAT catalog
USED	Specification of the utilization level in percent. In the case of a volume set in the IN-HOLD status this field is empty.
EXTENSION	Proposal for extending the catalog if it has reached the maximum value. In the case of a volume set in the IN-HOLD status this field is empty.
REMARK	Field for general comments. Usually empty:
IN HOLD	This volume set is in the IN-HOLD status.
Catalog-ID	As in the “extra large” format certain catalogs (JV, MIGRATE, PRIVATE) consist of multiple catalog files, and in this case precisely that catalog file is described to which the file extension proposal refers.

Table 140: Information on pubset catalogs

Output in S variables

Output information	Name of the S variable	T	Contents	Condition
Pubset ID	var(*list).PUBSET-ID	S	<cat-id>
Pubset type	var(*list).TYPE	S	*SM-PUBSET *SF-PUBSET
Catalog format	var(*list).FORMAT	S	*NORMAL *LARGE *EXTRA-LARGE
Catalog name INDEX: Catalog index file NAME-LIST:Name list file NL-COPY: Name list copy file JV: Catalog for the job variables MIGRATED: Catalog for the migrated and no-space files. PRIVATE: Catalog for the private disk and tape files volset-id: Catalog of a volume set	var(*list).CATALOG(*list).NAME	S	INDEX NAME-LIST NL-COPY JV MIGRATED PRIVATE <volset-id> <cat-id>
Utilization level in percent	var(*list).CATALOG(*list).USED	S	’’ <integer 1..100>
Information on the options for extending the catalog	var(*list).CATALOG(*list).EXTENSION	S	’’ * FILE-EXTENSION-(AUTOMATIC) *CHANGE-TO-LARGE-CATALOG *CHANGE-TO-LARGE-CATALOG-OR-ADD-VOLSET *CHANGE-TO-EXTRA-LARGE-CATALOG *CHANGE-TO-EXTRA-LARGE-CATALOG-OR-ADD-VOLSET *ADD-CATALOG-FILE-(AUTOMATIC) *ADD-VOLSET *CHANGE-TO-SM-PUBSET *LIMIT-REACHED