SHOW-NET-CLIENT-ALTERNATE

Net-Clients für Hochverfügbarkeit anzeigen

Komponente:	BS2000
Funktionsbereich:	Net-Storage administrieren
Anwendungsbereich:	DEVICE STORAGE-MANAGEMENT
Privilegierung:	TSOS                                                                                                          OPERATING
Berechtigungsschlüssel:	G

Funktionsbeschreibung

Das Kommando SHOW-NET-CLIENT-ALTERNATE informiert über die Hochverfügbarkeit von Net-Clients auf redundanten HNCs. Ein Net-Client ist hochverfügbar, wenn ihm ein zweiter Net-Client zugeordnet ist, der bei einem Ausfall die bestehenden Net-Storage-Verbindungen übernimmt.

Die Zuordnung von Net-Clients wird mit dem Kommando SET-NET-CLIENT-ALTERNATE eingestellt oder wieder aufgehoben.

Es werden nur Informationen ausgegeben, wenn eine Zuordnung besteht. Wenn keine Zuordnung besteht, wird die Meldung NKAN006 ausgegeben.

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

Grundlegende Informationen zum Einsatz von Net-Storage in BS2000 finden Sie im Handbuch „Einführung in die Systembetreuung“ [14]. Das Arbeiten mit Dateien auf Net-Storage ist im Handbuch „DVS Einführung“ [13] beschrieben.

Format

SHOW-NET-CLIENT-ALTERNATE

CLIENT = *ALL / <composed-name 1..8 with-under> / <c-string 1..8> / *DNS(...) / *IP-ADDRESS(...)
	*DNS(...)
		|	DNS-NAME = <c-string 1..256 with-low>
	*IP-ADDRESS(...)
		|	IP-ADDRESS = <composed-name 7..15> / <c-string 2..39>

Operandenbeschreibung

CLIENT =
Gibt den Net-Client an, über den die Informationen zur Hochfügbarkeit ausgegeben werden sollen.

CLIENT = *ALL
Es werden Informationen über alle Net-Clients ausgegeben.

CLIENT = <composed-name 1..8 with-under> / <c-string 1..8>
Interner BCAM-Name des Net-Clients.

CLIENT = *DNS(...)
Domänenname des Net-Clients.

DNS-NAME = <c-string 1..256 with-low>
Gibt den vollqualifizierten Domänennamen des Net-Clients an.

CLIENT = *IP-ADDRESS(...)
IP-Adresse des Net-Clients.

IP-ADDRESS = <composed-name 7..15> / <c-string 2..39>
Gibt die IP-Adresse des Net-Clients im IPv4- oder IPv6-Format an.

Kommando-Returncode

(SC2)	SC1	Maincode	Bedeutung / garantierte Meldungen
	0	CMD0001	Kommando fehlerfrei ausgeführt
	1	NKAN003	Syntaktischer Fehler in der Eingabe
	32	NKAN004	Fehler bei der Kommandoausführung
	32	NKAN008	Fehler beim Aufbau der S-Variablen
	64	NKAN006	Es besteht keine Zuordnung

Ausgabeformat

/show-net-client-alternate

************************************************************************
-   NET-CLIENT: CLIENT_1
-   ALTERNATE : CLIENT_2
************************************************************************

Bedeutung der Ausgabefelder

Ausgabefeld	mögliche Werte	Bedeutung
NET-CLIENT	siehe Operand CLIENT	Bezeichnung des Net-Clients
ALTERNATE	siehe Operand CLIENT	Bezeichnung des zugeordneten Net-Clients.

Tabelle 131: Ausgabefelder des Kommandos SHOW-NET-CLIENT-ALTERNATE

Ausgabe in S-Variable

Die Ausgabe in S-Variable erfolgt nur, wenn eine Zuordnung besteht. Wenn keine Zuordnung besteht, wird die Meldung NKAN006 ausgegeben. Es werden nur die S-Variablen für die bekannten Bezeichnungen des Net-Clients bzw. des zugeordneten Net-Clients versorgt. Bei einer nicht bekannten Bezeichnung enthält die S-Variable einen Leerstring

Ausgabe-Information	Name der S-Variablen	T	Inhalt	Bedingung
Bezeichnung des Net-Clients	var(*LIST).ACL(*LIST).CLIENT.NAME	S	'' <name 1..8>
DNS-Name des Net-Clients	var(*LIST).ACL(*LIST).CLIENT.DNS	S	'' <name 1..256>
IPv4-Adresse des Net-Clients	var(*LIST).ACL(*LIST).CLIENT.IPV4	S	'' <name 7..15>
IPv6-Adresse des Net-Clients	var(*LIST).ACL(*LIST).CLIENT.IPV6	S	'' <name 15..39>
Bezeichnung des zugeordneten Net-Clients	var(*LIST).ACL(*LIST).ALTCLI.NAME	S	'' <name 1..8>
DNS-Name des zugeordneten Net-Clients	var(*LIST).ACL(*LIST).ALTCLI.DNS	S	'' <name 1..256>
IPv4-Adresse des zugeordneten Net-Clients	var(*LIST).ACL(*LIST).ALTCLI.IPV4	S	'' <name 7..15>
IPv6-Adresse des zugeordneten Net-Clients	var(*LIST).ACL(*LIST).ALTCLI.IPV6	S	'' <name 15..39>