Operating System BS2000 OS DX V1.0 (en)

&pagelevel(3)&pagelevel

Display usage restrictions of a pubset

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-RESTRICTION command provides information on the physical pubset configuration and the usage restrictions defined in it. The name, device type and allocation capabilities of the volumes (in SF pubsets) or of the volume sets and their volumes (in SM pubsets) are displayed. Information is supplied only for locally available (imported) pubsets.

Usage restrictions are set or canceled using the MODIFY-PUBSET-RESTRICTION command.

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

This command corresponds to the SHOW-PUBSET-PROCESSING command. The information on the physical configuration of the pubset is also contained in the output of the SHOW-PUBSET-PARAMETERS command.

Format

SHOW-PUBSET-RESTRICTION

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

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

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.

Return codes

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:

the output block with cross-pubset summary information
the output block with information on the physical pubset configuration and the usage restrictions

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.

Output for an SF pubset:

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

Output for an SM pubset:

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

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

Output in S variables

Some S variables are generated in accordance with the pubset type. These are shown in the Condition column of the table below, with "1" meaning SF pubset and "2" meaning SM pubset.

Output information	Name of the S variable	T	Contents	Condition
Number of volume sets for single-feature pubsets Number of volume sets for SM pubset	var(*LIST).COUNT	I	<integer 1..255>
Maximum I/O transfer length (HP) of the SM pubset	var(*LIST).MAX-IO-LEN	I	<integer>	2
Pubset catalog ID	var(*LIST).PUBSET-ID	S	FALSE=none
Pubset type	var(*LIST).PUBSET-TYPE	S	SINGLE-FEATURE SYS-MANAGE
Allocation lock for the single-feature pubset ALLOW=no lock NOT-ALLOW=locked against allocation *PHYS-ONLY=can only be allocated physically	var(LIST).VOL(LIST).ALLOC	S	ALLOW NOT-ALLOW *PHYS-ONLY	1
Device types of the SF pubset	var(LIST).VOL(LIST).DEV	S	<device>	1
VSNs of the SF pubset volumes	var(LIST).VOL(LIST).VOL	S	<vsn>	1
Volume set ID	var(LIST).VOLSET(LIST).VOLSET	S	<vsid>	2
Number of volumes per volume set	var(LIST).VOLSET(LIST).VOL-COUNT	I	<integer 1..255>	2
Allocation lock for the volume set ALLOW=no lock NOT-ALLOW=locked against allocation *PHYS-ONLY=can only be allocated physically	var(LIST).VOLSET(LIST).VOL(*LIST). ALLOC	S	ALLOC NOT-ALLOW *PHYS-ONLY	2
Device types of the volumes per volume set	var(LIST).VOLSET(LIST).VOL(*LIST).DEV	S	<device>	2
VSNs of the volumes per volume set	var(LIST).VOLSET(LIST).VOL(*LIST).VOL		<vsn>	2

Example

/show-pubset-restriction pubset=2os6

%----------------------------------------------------------------------------
%COMMAND: SHOW-PUBSET-RESTRICTION
%- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
%PUBSET 2OS6: TYPE = SYSTEM-MANAGED, VOLUMESETS = 6, DEFAULT FILE FORMAT = K
%---- PHYSICAL CONFIGURATION --------- + ------------------------------------
%---- VOLUME-SET INFORMATION --------- + ------------------------------------
%VOLUME-SET 6CV1: VOLUMES = 2
% VOLUME CONFIGURATION:
%  VOLUME    DEVICE     ALLOCATION       VOLUME    DEVICE     ALLOCATION
%  6CV1.0    D3435      NOT RESTR        6CV1.1    D3435      NOT RESTR
%VOLUME-SET 6VS1: VOLUMES = 2
% VOLUME CONFIGURATION:
%  VOLUME    DEVICE     ALLOCATION       VOLUME    DEVICE     ALLOCATION
%  6VS1.0    D3435      NOT RESTR        6VS1.1    D3435      NOT RESTR
%VOLUME-SET 6VS2: VOLUMES = 2
% VOLUME CONFIGURATION:
%  VOLUME    DEVICE     ALLOCATION       VOLUME    DEVICE     ALLOCATION
%  6VS2.0    D3435      NOT RESTR        6VS2.1    D3435      NOT RESTR
%VOLUME-SET 6VS3: VOLUMES = 2
% VOLUME CONFIGURATION:
%  VOLUME    DEVICE     ALLOCATION       VOLUME    DEVICE     ALLOCATION
%  6VS3.0    D3435      NOT RESTR        6VS3.1    D3435      NOT RESTR
%VOLUME-SET 6VS4: VOLUMES = 2
% VOLUME CONFIGURATION:
%  VOLUME    DEVICE     ALLOCATION       VOLUME    DEVICE     ALLOCATION
%  6VS4.0    D3435      NOT RESTR        6VS4.1    D3435      NOT RESTR
%VOLUME-SET 6VS5: VOLUMES = 2
% VOLUME CONFIGURATION:
%  VOLUME    DEVICE     ALLOCATION       VOLUME    DEVICE     ALLOCATION
%  6VS5.0    D3435      NOT RESTR        6VS5.1    D3435      NOT RESTR
%----------------------------------------------------------------------------

Your Browser is not longer supported

Please use Google Chrome, Mozilla Firefox or Microsoft Edge to view the page correctly

SHOW-PUBSET-RESTRICTION