SHOW-SHARED-PUBSET Informationen über Shared-Pubsets anfordern

Beschreibungsstand: Funktionsbereich: Anwendungsbereich: Privilegierung:	MSCF V21.0A Pubset- und MRSCAT-Verwaltung MULTI-CATALOG-AND-PUBSET-MGMT STD-PROCESSING TSOS OPERATING
Berechtigungsschlüssel:	E

Funktionsbeschreibung

Mit dem Kommando SHOW-SHARED-PUBSET können die wichtigsten Kenndaten der sog. „Sharer“ für Shared-Pubsets ermittelt werden.
„Sharer“ sind die Rechner, die einen bestimmten Pubset gleichzeitig importiert haben.

Steht kein Shared-Pubset zur Verfügung, wird die Meldung MCA0201 PUBSET(S) NOT SHARED ausgegeben.

Das Kommando unterstützt die strukturierte Ausgabe in S-Variable.

Format

SHOW-SHARED-PUBSET

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

Operandenbeschreibung

PUBSET =
Kennung des Pubsets, über dessen Shared-Teilnehmer Informationen angefordert werden.

PUBSET = *ALL
Default-Wert: Über alle importierte Shared-Pubsets sollen Informationen geliefert werden.

PUBSET = <cat-id 1..4>
Kennung des Pubsets, über den allein die Informationen bereitgestellt werden sollen.

PUBSET = *XCS
Es sollen Informationen über alle Shared-Pubsets geliefert werden, die als XCS-Pubsets importiert sind.

PUBSET = *CCS
Es sollen Informationen über alle Shared-Pubsets geliefert werden, die als reine CCS-Pubsets (also nicht als XCS-Pubsets) importiert sind.

Ausgabeformat

Pro Shared-Pubset werden folgende Daten ausgegeben:

SHARER CONFIGURATION OF SHARED PUBSET :<catid>:
  PARTNER   HOME   HOME   SHARER  SHARER   BS2000
   NAME     CATID  SYSID  TYPE    STATE    VERSION
  @@@@@@@@  @@@@   @@@    @@@@@@  @@@@@@@  @@@@@

Beispiel

SHARER CONFIGURATION OF SHARED PUBSET :M1D1:
%   PARTNER   HOME   HOME   SHARER  SHARER   BS2000 
%    NAME     CATID  SYSID  TYPE    STATE    VERSION 
%   D016ZE07  1OSH   152    SLAVE   IMCAT    V21.0 
%   SQHAV101  C3H1   176    SLAVE   SHUTD    V21.0 
%   D016ZE10  2OV1   157    SLAVE   IMCAT    V20.0 
%   D016ZE04  2OSH   163    SLAVE   IMCAT    V21.0 
%   D016ZE00  2OV0   155    MASTER  IMCAT    V19.0 

Erläuterung der Ausgabe

Ausgabefeld	Bedeutung / Information
BS2000 VERSION	BS2000-Version des Shared-Pubset-Sharers (z.B. V19.0, V20.0, V21.0)
HOME CATID	Home-Catid des Shared-Pubset-Sharers
HOME SYSID	Systemidentifikation des Shared-Pubset-Sharers
PARTNER NAME	Host-Name des Shared-Pubset-Sharers
SHARER STATE	Partnerstatus aus lokaler Sicht. Die einzelnen Werte beziehen sich jeweils auf den unter PARTNER-NAME angegebenen Rechner. Bedeutung: CHECK: Das Plattenprotokoll ist ausgefallen. Die Überwachung läuft nur noch über die MSCF-Verbindungen CRASH: Der Partner-Rechner ist ausgefallen EXCAT: Der Partner-Rechner hat den Pubset ordnungsgemäß exportiert IMCAT: Der Pubset wurde von dem Rechner importiert MCHANGE: Es läuft zurzeit ein Masterwechsel für den Pubset READERR: Ein permanenter Lesefehler ist auf der Platte aufgetreten SHUTDOWN Der Partner-Rechner hat den Pubset beim Beenden von MSCF oder bei der BS2000-Shutdown-Verarbeitung ordnungsgemäß exportiert WRTERR: Ein permanenter Schreibfehler ist auf der Platte aufgetreten
SHARER TYPE	Sharer-Typ des Shared-Pubset-Sharers: BACKUP: Ein Master-Wechsel wird durchgeführt; der Sharer ist der Backup-Master des Shared Pubset. MASTER: Der Sharer ist der Master des Shared Pubset SLAVE: Der Sharer ist Slave des Shared Pubset

Kommando-Returncode

(SC2)	SC1	Maincode	Bedeutung
	0	CMD0001	Kommando ohne Fehler ausgeführt
	1	CMD2201	Parameterfehler
	2	CMD2202	Subsystem MSCF nicht definiert
	3	CMD2203	Installationsfehler
	32	MCS0025	Interner Fehler (Börsenaufruf, Speicheranforderung)
	32	MCA0204	Fehler bei Ausgabe nach SYSOUT
	64	MCA0201	Pubset nicht mehrfach benutzbar
	64	MCA0202	Auf Pubset kann nicht zugegriffen werden
	66	CMD2242	keine Verbindung zum Subsystem MSCF
	128	CMD2280	Subsystem MSCF kurzzeitig nicht verfügbar
	129	CMD2281	Subsystem MSCF für längere Zeit nicht verfügbar
	130	CMD2282	Subsystem MSCF für unbestimmte Zeit nicht verfügbar

Ausgabe in S-Variable

Ausgabe-Information	Name der S-Variablen	T	Inhalt	Bedingung
Katalogkennung des HOME-Pubsets	var(*LIST).LIST(*LIST).HOME-PUBSET	S	<cat-id 1..4>
Name der Partneranlage	var(*LIST).LIST(*LIST).PARTNER-NAME	S	<alphan.-name 1..8>
Katalogkennung des Shared-Pubsets	var(*LIST).SHARED-PUBSET	S	<cat-id 1..4>
Zustand der Partneranlage  *CHECK=Das Plattenprotokoll ist ausgefallen. Die Überwachung läuft nur noch über die MSCF- Verbindung.  *CRASH=Der Partner-Rechner ist ausgefallen. *EXP-PUBSET=Der Partner-Rechner hat den Pubset ordnungsgemäß exportiert. *IMP-PUBSET=Der Pubset wurde von dem Rechner importiert. *MASTER-CHA=Es läuft zur Zeit ein Master-Wechsel für den Pubset. *READ-ERROR=Ein permanenter Lesefehler ist auf der Platte aufgetreten. *SHUTDOWN=Der Partner-Rechner hat den Pubset beim Beenden von MSCF ordnungsgemäß exportiert. *WRITE-ERROR=Ein permanenter Schreibfehler ist auf der Platte aufgetreten.	var(*LIST).LIST(*LIST).SHARER-STA	S	*CHECK *CRASH *EXP-PUBSET *IMP-PUBSET *MASTER-CHA *READ-ERROR *SHUTDOWN *WRITE-ERROR
Art der Partneranlage  *BACKUP=Ein Master-Wechsel wird durchgeführt; der Sharer ist der Backup-Master des Shared-Pubsets. *MASTER=Der Sharer ist der Master des Shared-Pubsets. *SLAVE=Der Sharer ist Slave des Shared-Pubsets.	var(*LIST).LIST(*LIST).SHARER-TYPE	S	*BACKUP *MASTER *SLAVE
Systemidentifikation	var(*LIST).LIST(*LIST).SYS-ID	S	<alphan.-name 1..3>
Systemversion	var(*LIST).LIST(*LIST).SYS-VERSION	S	<version>

Beispiel

/declare-var var-name=var(type=*structure),multiple-elem=*list
/exec-cmd cmd=(show-shared-pubset swkl),text-output=*none,struct-output=var
/show-var var,inf=*par(list-index=*yes)
OUT#1.SHARED-PUBSET = SWKL
OUT#1.LIST#1.PARTNER-NAME = D016ZE07
OUT#1.LIST#1.HOME-PUBSET = 1OSH
OUT#1.LIST#1.SYS-ID = 152
OUT#1.LIST#1.SHARER-TYPE = *SLAVE
OUT#1.LIST#1.SHARER-STA = *IMP-PUBSET
OUT#1.LIST#1.SYS-VERSION = V21.0
OUT#1.LIST#2.PARTNER-NAME = SQHAV101
OUT#1.LIST#2.HOME-PUBSET = C3H1
OUT#1.LIST#2.SYS-ID = 176
OUT#1.LIST#2.SHARER-TYPE = *SLAVE
OUT#1.LIST#2.SHARER-STA = *SHUTDOWN
OUT#1.LIST#2.SYS-VERSION = V210
OUT#1.LIST#3.PARTNER-NAME = D016ZE10
OUT#1.LIST#3.HOME-PUBSET = 2OV1
OUT#1.LIST#3.SYS-ID = 157
OUT#1.LIST#3.SHARER-TYPE = *SLAVE
OUT#1.LIST#3.SHARER-STA = *IMP-PUBSET
OUT#1.LIST#3.SYS-VERSION = V20.0
OUT#1.LIST#4.PARTNER-NAME = D016ZE04
OUT#1.LIST#4.HOME-PUBSET = 2OSH
OUT#1.LIST#4.SYS-ID = 163
OUT#1.LIST#4.SHARER-TYPE = *SLAVE
OUT#1.LIST#4.SHARER-STA = *IMP-PUBSET
OUT#1.LIST#4.SYS-VERSION = V21.0
OUT#1.LIST#5.PARTNER-NAME = D016ZE00
OUT#1.LIST#5.HOME-PUBSET = 2OV0
OUT#1.LIST#5.SYS-ID = 155
OUT#1.LIST#5.SHARER-TYPE = *MASTER
OUT#1.LIST#5.SHARER-STA = *IMP-PUBSET
OUT#1.LIST#5.SYS-VERSION = V19.0

Hinweis

Der aktuelle Stand der Shared-Pubset-Konfiguration wird am Master-Rechner geführt. An den Slave-Rechnern werden die aktuellen Werte mit einer zeitlichen Verzögerung (abhängig vom eingestellten FAIL-DETECTION-LIMIT) aktualisiert.