Betriebssystem BS2000 OS DX V1.0B (de)

&pagelevel(3)&pagelevel

Nutzungseinschränkungen eines Pubsets ausgeben

Komponente:	BS2000
Funktionsbereich:	Pubset- und MRSCAT-Verwaltung
Anwendungsbereich:	MULTI-CATALOG-AND-PUBSET-MGMT
Privilegierung:	TSOS OPERATING STD-PROCESSING
Berechtigungsschlüssel:	@

Funktionsbeschreibung

Das Kommando SHOW-PUBSET-RESTRICTION informiert über die physikalische Pubset-Konfiguration und die darin festgelegten Nutzungseinschränkungen. Ausgegeben werden Name, Gerätetyp und Allokierungsmöglichkeit der Volumes (bei SF-Pubsets) bzw. der Volume-Sets und ihrer Volumes (bei SM-Pubsets). Informationen werden nur für lokal verfügbare (importierte) Pubsets ausgegeben.

Nutzungseinschränkungen werden mit dem Kommando MODIFY-PUBSET-RESTRICTION eingestellt bzw. aufgehoben.

Das Kommando unterstützt die strukturierte Ausgabe in S-Variable (siehe „Ausgabe in S-Variable").

Das Kommando entspricht dem Kommando SHOW-PUBSET-PROCESSING. Die Informationen über die physikalische Konfiguration des Pubsets sind auch in der Ausgabe des Kommandos SHOW-PUBSET-PARAMETERS enthalten.

Format

SHOW-PUBSET-RESTRICTION

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

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

Operandenbeschreibung

PUBSET = *ALL / <cat-id 1..4>
Bestimmt die lokal verfügbaren Pubsets, deren Konfigurationsparameter angezeigt werden sollen.

PUBSET = *ALL
Es sollen die Konfigurationsparameter aller lokal verfügbaren Pubsets angezeigt werden. Mit dem Operanden SELECT-PUBSET kann die Auswahl auf bestimmte Pubsets beschränkt werden.

PUBSET = <cat-id 1..4>
Kennung des Pubsets, dessen Konfigurationsparameter ausgegeben werden sollen.

SELECT-PUBSET = *ALL / *EXCLUSIVE / *SHARED / *HSMS-SUPPORTED
Bestimmt Auswahlkriterien für die Auswahl bestimmer Pubsets aus der Menge aller lokal verfügbaren Pubsets (siehe PUBSET=*ALL).
Voreinstellung ist *ALL, d.h. die Konfigurationsparameter aller Pubsets werden angezeigt.

SELECT-PUBSET = *EXCLUSIVE
Die Konfigurationsparameter aller exklusiv importierten Pubsets werden angezeigt.

SELECT-PUBSET = *SHARED
Die Konfigurationsparameter aller shared importierten Pubsets werden angezeigt.

SELECT-PUBSET = *HSMS-SUPPORTED
Die Konfigurationsparameter aller SM-Pubsets, die durch das Subsystem HSMS bedient werden können, werden angezeigt.

Kommando-Returncode

SC1	Maincode	Bedeutung
0	CMD0001	Ohne Fehler
32	CMD0221	Interner Systemfehler
32	CMD2009	Fehler bei Ausgabe in S-Variable (z.B. Subsystem nicht verfügbar)
32	DMS138A	Interner Parameterfehler
64	DMS1381	Volume-Set-Konflikt
64	DMS138B	Pubset nicht vorhanden oder nicht mit angegebener Eigenschaft
64	DMS138C	Pubset nicht zugreifbar
64	DMS138E	Volume-Set nicht vorhanden
128	DMS1386	Klasse-4/5-Speichermangel

Ausgabeformat

Als Kopfzeile wird der Kommandoname ausgegeben. Danach folgen pro Pubset:

der Ausgabeblock mit Pubset-globalen Grundinformationen
der Ausgabeblock mit Informationen über die physikalische Pubset-Konfiguration und die Nutzungseinschränkungen

Pubset-globale Grundinformationen

Der Ausgabeblock besteht aus einer Zeile und enthält die Katalogkennung, den Pubset-Typ (SF- oder SM-Pubset) und die Anzahl der zugehörigen Volumes bzw. Volume-Sets. Bei SM-Pubsets wird zusätzlich das Standard-Dateiformat ausgegeben.

Ausgabe für ein SF-Pubset:

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

Ausgabe für ein SM-Pubset:

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

Informationen über die physikalische Pubset-Konfiguration

Der Ausgabeblock wird mit der folgenden Überschriftszeile eingeleitet:

--- PHYSICAL CONFIGURATION ---------------------------------------

Für ein SF-Pubset werden die Informationen zu den Volumes in einer bzw. mehreren Wertezeilen unter der folgenden Überschrift ausgegeben:

VOLUME-CONFIGURATION:
VOLUME   DEVICE    ALLOCATION    VOLUME   DEVICE    ALLOCATION
<vsn>    <type>    <alloc>       <vsn>    <type>    <alloc>

Für jedes Volume-Set eines SM-Pubsets wird die Volume-Set-Kennung und die Anzahl der zugehörigen Volumes angezeigt. Anschließend werden die Informationen zu den Volumes in einer bzw. mehreren Wertezeilen unter der folgenden Überschrift ausgegeben:

--- VOLUME SET INFORMATION  --------------------------------------
 VOLUME-SET <catid>: VOLUMES = <n>
 VOLUME CONFIGURATION:
 VOLUME   DEVICE    ALLOCATION    VOLUME   DEVICE    ALLOCATION
 <vsn>    <type>    <alloc>       <vsn>    <type>    <alloc>

Bedeutung der Ausgabewerte

<catid>	Kennung des Pubsets bzw. Volume-Sets
<n>	Anzahl der zugehörigen Volumes
<vsn>	Datenträgerkennzeichen des Volumes
<type>	Gerätetyp, der dem Volume zugeordnet ist
<alloc>	Allokierungsmöglichkeit des Volumes: NOT RESTR: Allokierung möglich NOT ALLOWED: Allokierung nicht möglich PHYSICAL: Volume kann nur physikalisch allokiert werden

Ausgabe in S-Variable

Einige S-Variablen werden abhängig vom Pubset-Typ erzeugt. Sie sind in folgender Tabelle in der Spalte Bedingung mit „1“ (SF-Pubset) bzw. „2“ (SM-Pubset) gekennzeichnet.

Ausgabe-Information	Name der S-Variablen	T	Inhalt	Bedingung
Anzahl der Volumes bei SF-Pubsets Anzahl der Volume-Sets bei SM-Pubsets	var(*LIST).COUNT	I	<integer 1..255>
Maximale I/O-Transferlänge (HP) des SM-Pubsets	var(*LIST).MAX-IO-LEN	I	<integer>	2
Katalogkennung des Pubsets	var(*LIST).PUBSET-ID	S	<cat-id>
Pubsettyp	var(*LIST).PUBSET-TYPE	S	SINGLE-FEATURE SYS-MANAGE
Allokierungssperre des Single Feature-Pubsets ALLOW=keine Sperre NOT-ALLOW=gegen Allokierung gesperrt *PHYS-ONLY=nur physikalisch allokierbar	var(LIST).VOL(LIST).ALLOC	S	ALLOW NOT-ALLOW *PHYS-ONLY	1
Gerätetypen der Volumes des SF-Pubsets	var(LIST).VOL(LIST).DEV	S	<device>	1
VSNs der Volumes des SF-Pubsets	var(LIST).VOL(LIST).VOL	S	<vsn>	1
Kennung des Volume-Sets	var(LIST).VOLSET(LIST).VOLSET	S	<vsid>	2
Anzahl der Volumes pro Volume-Set	var(LIST).VOLSET(LIST).VOL-COUNT	I	<integer 1..255>	2
Allokierungssperre des Volume-Sets ALLOW=keine Sperre NOT-ALLOW=gegen Allokierung gesperrt *PHYS-ONLY=nur physikalisch allokierbar	var(LIST).VOLSET(LIST).VOL(*LIST).ALLOC	S	ALLOC NOT-ALLOW *PHYS-ONLY	2
Gerätetypen der Volumes pro Volume-Set	var(LIST).VOLSET(LIST).VOL(*LIST).DEV	S	<device>	2
VSNs der Volumes pro Volume-Set	var(LIST).VOLSET(LIST).VOL(*LIST).VOL		<vsn>	2

Beispiel

/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