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-PUBSET-DEFINITION-FILE

&pagelevel(3)&pagelevel

Definitionen eines SM-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-DEFINITION-FILE informiert über die Volume-Setspezifischen Konfigurationsparameter von System-Managed-Pubsets (SM-Pubsets). Informationen werden nur für lokal verfügbare (importierte) Pubsets ausgegeben.

Die Konfigurationsparameter können mit dem Kommando MODIFY-PUBSET-DEFINITION-FILE geändert werden.

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

Die Volume-Set-spezifischen Konfigurationsparameter sind auch in der Ausgabe des Kommandos SHOW-PUBSET-PARAMETERS enthalten.

Format

SHOW-PUBSET-DEFINITION-FILE                                                                                                           

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

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

,VOLUME-SET = *ALL / <cat-id 1..4>

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.

VOLUME-SET = *ALL / <cat-id 1..4>
Bestimmt die Volume-Sets, deren Konfigurationsparameter angezeigt werden sollen.

VOLUME-SET = *ALL
Es sollen die Konfigurationsparameter aller Volume-Sets angezeigt werden.

VOLUME-SET = <cat-id 1..4>
Kennung des Volume-Sets, dessen Konfigurationsparameter ausgegeben werden sollen.

Kommando-Returncode

(SC2)

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:

  1. der Ausgabeblock mit pubset-globalen Grundinformationen

  2. der Ausgabeblock mit Informationen über die volumeset-spezifischen Konfigurationsparameter

Pubset-globale Grundinformationen

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

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

Informationen über die volumeset-spezifischen Konfigurationsparameter

Der Ausgabeblock wird mit der folgenden Überschriftszeile eingeleitet:

--- VOLUME-SET INFORMATION  --------------------------------------

Für jedes Volume-Set wird die volumeset-spezifische Grundinformation ausgegeben:

VOLUME-SET <catid>:  [CONTROL-VOLSET] <status>,<usage>,<format>,<avail>

Bedeutung der Ausgabewerte

<catid>

Kennung des Volume-Sets

CONTROL-VOLSET

Ausgabe nur für Control-Volume-Set. Dieser Volume-Set enthält die Verwaltungsdaten des SM-Pubsets.

<status>

Betriebszustand des Volume-Sets:

  • NORMAL-USE

  • Der Volume-Set ist in Betrieb und damit zugreifbar.

  • IN-HOLD

  • Der Volume-Set ist temporär nicht in Betrieb.

  • DEFECT

  • Der Volume-Set ist defekt.

  • DEFINED-ONLY

  • Der Volume-Set ist nur definiert, aber nicht zugreifbar.

<usage>

Nutzungsart (Ausgabe nur bei Abweichung vom Standardwert)

  • WORK                         

  • Ablageort für Arbeitsdateien

  • HSMS

  • Nutzung durch das Subsystem HSMS

<format>

Dateiformat

  • K-FORMAT

  • Ablageort von K-Dateien

  • NK2-FORMAT

  • Ablageort von NK2-Dateien

  • NK4-FORMAT

  • Ablageort von NK4-Dateien

<avail>

Verfügbarkeit (Ausgabe nur bei Abweichung vom Standardwert)

  • HIGH-AVAIL

  • hohe Verfügbarkeit

Zusätzlich zur Grundinformation werden zwei weitere Informationsblöcke ausgegeben. Die Informationen werden jeweils von einer Überschriftszeile eingeleitet und danach tabellarisch ausgegeben. Die linke Spalte bezeichnet den Parameter, die rechte Spalte die möglichen Werte. Die Angabe list-poss(n): bedeutet, dass bis zu n Werte (jeweils in einer eigenen Zeile) angezeigt werden können.

  1. Globale Attribute

    Die Ausgabe wird mit der folgenden Überschrift eingeleitet:

    --- GLOBAL ATTRIBUTES     ---- + ---------------------------------

    Danach folgen die einzelnen Informationen:

    • Information bezüglich der Verfügbarkeits-Eigenschaften des Volume-Sets:

      AVAILABILITY                  | STANDARD
                                    | HIGH
    • Information bezüglich der Nutzungsarten der Volume-Sets:

      USAGE                         | STANDARD
                                    | WORK
                                    | HSMS-CONTROLLED
      
    • Information bezüglich des Volume-Set-Formats:

      FORMAT                        | UNDEFINED 
                                    | K-FORMAT
                                    | NK2-FORMAT
                                    | NK4-FORMAT
      
    • Information über die maximale Ein-/Ausgabelänge (in PAM-Seiten).

      MAXIMAL I/O LENGTH            | <n> HP
    • Information über die kleinste Allokierungseinheit (in PAM-Seiten).

      ALLOCATION UNIT SIZE          | <n> HP
    • Information über Platteneigenschaften bezüglich DRV

      DRV-VOLSET                    | NO / YES
    • Information bezüglich Einschränkungen beim erstmaliger Allokierung:

      NEW FILE ALLOCATION           | NOT RESTRICTED
                                    | PHYSICAL ONLY
                                    | NOT ALLOWED
      
    • Information bezüglich des Zugriffs auf den Volume-Set

      VOLUME SET ACCESS             | NOT RESTRICTED
                                    | ADMIN ONLY
  2. Performance-Attribute

    Die Ausgabe wird mit der folgenden Überschrift eingeleitet:

    PERFORMANCE-ATTRIBUTES        |

    Danach folgen die einzelnen Informationen:

    • Information zum Profil der Performance-Eigenschaften:

      PERFORMANCE:                 | NO VALUES 
                                   | or list-poss(3):
                                   | STANDARD
                                   | HIGH
                                   | VERY-HIGH
      
    • Information bezüglich des Zeitpunkts, zu dem Datenkonsistenz bestehen soll:

      WRITE-CONSISTENCY:           | IMMEDIATE
                                   | BY-CLOSE
      

Ausgabe in S-Variable

Ausgabe-Information

Name der S-Variablen

T

Inhalt

Bedingung

Anzahl der Volume-Sets bei System-Managed-Pubsets

var(*LIST).COUNT

I

<integer 1..255>


Maximale I/O-Transferlänge (HP) des System-Managed-Pubsets

var(*LIST).MAX-IO-LEN

I

<integer>


Katalogkennung des Pubsets

var(*LIST).PUBSET-ID

S

<cat-id>


Pubsettyp

var(*LIST).PUBSET-TYPE

S

*SINGLE-FEATURE
*SYS-MANAGE


Aktuelle Allokierungseinheit

var(*LIST).VOLSET(*LIST).ALLOC-UNIT-SIZE

I

<integer>


Zugang zum Volume-Set
*ADM-ONLY=nur für die Systembetreuung
*NOT-RESTRICT=nicht eingeschränkt

var(*LIST).VOLSET(*LIST).ACCESS

S

*ADM-ONLY
*NOT-RESTRICT


Aktuell eingestellte Verfügbarkeit
*STD=keine erhöhte Datenverfügbarkeit
*HIGH=erhöhte Datenverfügbarkeit

var(*LIST).VOLSET(*LIST).AVAIL

S

*STD
*HIGH


Volume-Set enthält die Verwaltungsdaten des Pubsets

var(*LIST).VOLSET(*LIST).CONTR

S

*NO
*YES


DRV-Eigenschaft des Volume-Sets

var(*LIST).VOLSET(*LIST).DRV

S

*NO
*YES


Format des Volume-Sets

var(*LIST).VOLSET(*LIST).FORM

S

*K
*NK2
*NK4
*UNDEF


Ohne Bedeutung (Ausgabe nur aus Kompatibilitätsgründen)

var(*LIST).VOLSET(*LIST).GS

S



Aktuelle maximale I/O-Transferlänge

var(*LIST).VOLSET(*LIST).MAX-IO-LEN

I

<integer>


Aktuelle Allokierungsrestriktionen
*NOT-RESTRICT=keine Restriktionen
*PHYS-ONLY=nur physikalisch allokierbar
*NOT-ALLOW=keine Allokierungen erlaubt

var(*LIST).VOLSET(*LIST).NEW-FILE-ALLOC

S

*NOT-RESTRICT
*PHYS-ONLY
*NOT-ALLOW


I/O-Performance
*STD=nicht erhöht
*HIGH=hoch
*VERY-HIGH=am höchsten

var(*LIST).VOLSET(*LIST).PERF.PERF(*LIST)

S

*STD
*HIGH
*VERY-HIGH


Datenkonsistenz bei erhöhter I/O-Performance
*BY-CLOSE=keine Datenkonsistenz
*IMMED=Datenkonsistenz

var(*LIST).VOLSET(*LIST).PERF.WRITE-CONSIST

S

*BY-CLOSE
*IMMED


Status des Volume-Sets
*DEFECT=permanent nicht zugreifbar (defekt)
*DEFINED=nicht verfügbar, es existiert nur ein Eintrag in der Konfigurationsdatei
*IN-HOLD=temporär nicht zugreifbar (eingefroren)
*NORMAL= verfügbar

var(*LIST).VOLSET(*LIST).STA

S

*DEFECT
*DEFINED
*IN-HOLD
*NORMAL


Dateien des Volume-Sets
*HSMS-CONTR=nur HSMS-Dateien
*STD=nur Standarddateien
*WORK=nur Arbeitsdateien

var(*LIST).VOLSET(*LIST).USAGE

S

*HSMS-CONTR
*STD
*WORK


Kennung des Volume-Sets

var(*LIST).VOLSET(*LIST).VOLSET

S

<vsid>


Beispiel

/show-pubset-definition-file pubset=2os6,volume-set=6vs5

----------------------------------------------------------------------------
COMMAND: SHOW-PUBSET-DEFINITION-FILE 
- - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - 
PUBSET 2OS6: TYPE = SYSTEM-MANAGED, VOLUMESETS = 6, DEFAULT FILE FORMAT = K
---- VOLUME-SET INFORMATION --------- + ------------------------------------ 
VOLUME-SET 6VS5: NORMAL-USE, WORK, K-FORMAT
---- GLOBAL ATTRIBUTES      --------- + ------------------------------------ 
 AVAILABILITY                         | STANDARD 
 USAGE                                | WORK 
 FORMAT                               | K-FORMAT 
 MAXIMAL I/O LENGTH                   | 80                     HP 
 ALLOCATION UNIT SIZE                 | 3                      HP 
 DRV-VOLSET                           | NO 
 GS-VOLSET                            | NO 
 NEW FILE ALLOCATION                  | NOT RESTRICTED 
 VOLUME SET ACCESS                    | NOT RESTRICTED 
---- PERFORMANCE ATTRIBUTES --------- + ------------------------------------ 
 PERFORMANCE                          | STANDARD 
 WRITE-CONSISTENCY                    | BY-CLOSE
----------------------------------------------------------------------------