SHOW-NET-CLIENT-ALTERNATE

Show net clients for high availability

Component:	BS2000
Functional area:	Net-Storage administration
Domain:	DEVICE STORAGE-MANAGEMENT
Privileges:	TSOS OPERATING
Routing code:	G

Function

The SHOW-NET-CLIENT-ALTERNATE provides information on the high availability of net clients on redundant HNCs. A net client is highly available when a second net client is assigned to it which takes over the existing Net-Storage connections if a failure occurs.

The assignment of net clients is set and canceled again with the SET-NET-CLIENT-ALTERNATE command.

Information is displayed only if an assignment exists. If no assignment exists, the message NKAN006 is issued.

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

Fundamental information on the use of Net-Storage in BS2000 is provided in the “Introduction to System Administration” [14]. How to work with files on Net-Storage is described in the "Introductory Guide to DMS" [13].

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>

Operands

CLIENT =
Specifies the net client about which information on high availability is to be displayed.

CLIENT = *ALL
Information on all net clients is displayed.

CLIENT = <composed-name 1..8 with-under> / <c-string 1..8>
Internal BCAM name of the net client.

CLIENT = *DNS(...)
Domain name of the net client.

DNS-NAME = <c-string 1..256 with-low>
Specifies the fully qualified domain name of the net client.

CLIENT = *IP-ADDRESS(...)
IP address of the net client.

IP-ADDRESS = <composed-name 7..15> / <c-string 2..39>
Specifies the IP address of the net client in IPv4 or IPv6 format.

Return codes

(SC2)	SC1	Maincode	Meaning/Guaranteed messages
	0	CMD0001	Command executed without error
	1	NKAN003	Syntax error in the input
	32	NKAN004	Error in command execution
	32	NKAN008	Error in S variable format
	64	NKAN006	No assignment exists

CLIENT =
Specifies the net client to which an alternative net client is to be assigned.

CLIENT = <composed-name 1..8 with-under> / <c-string 1..8>
Internal BCAM name of the net client.

CLIENT = *DNS(...)
Domain name of the net client.

DNS-NAME = <c-string 1..256 with-low>
Specifies the fully qualified domain name of the net client.

CLIENT = *IP-ADDRESS(...)
IP address of the net client.

IP-ADDRESS = <composed-name 7..15> / <c-string 2..39>
Specifies the IP address of the net client in IPv4 or IPv6 format.

Output format

/show-net-client-alternate

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

Meanings of the output fields

Output field	Possible values	Meaning
NET-CLIENT	See CLIENT operand	Name of the net client
ALTERNATE	See CLIENT operand	Name of the assigned net client

Table 132: Output fields of the SHOW-NET-CLIENT-ALTERNATE command

Output in S variable

The output to S variable takes place only if an assignment exists. If no assignment exists, the message NKAN006 is issued. Only the S variables for the known names of the net client or of the assigned net client are supplied with values. In the case of an unknown name, the S variable contains an empty string

Output information	Name of the S variable	T	Contents	Condition
Name of the net client	var(*LIST).ACL(*LIST).CLIENT.NAME	S	'' <name 1..8>
DNS name of the net client	var(*LIST).ACL(*LIST).CLIENT.DNS	S	'' <name 1..256>
IPv4 address of the net client.	var(*LIST).ACL(*LIST).CLIENT.IPV4	S	'' <name 7..15>
IPv6 address of the net client.	var(*LIST).ACL(*LIST).CLIENT.IPV6	S	'' <name 15..39>
Name of the assigned net client	var(*LIST).ACL(*LIST).ALTCLI.NAME	S	'' <name 1..8>
DNS name of the assigned net client	var(*LIST).ACL(*LIST).ALTCLI.DNS	S	'' <name 1..256>
IPv4 address of the assigned net client	var(*LIST).ACL(*LIST).ALTCLI.IPV4	S	'' <name 7..15>
IPv6 address of the assigned net client	var(*LIST).ACL(*LIST).ALTCLI.IPV6	S	'' <name 15..39>