SET-NET-CLIENT-ALTERNATE

Assign net clients for high availability

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

Function

The SET-NET-CLIENT-ALTERNATE command specifies an assignment of two net clients on redundant HNCs for high availability. This assignment is a symmetrical relationship between the two net clients. There can only ever be one alternative net client for a net client. When one of the two net clients fails, the other takes over the existing Net-Storage connections of the failed net client.

Another SET-NET-CLIENT-ALTERNATE for one of the two net clients has the following effect:

• ALTERNATE-CLIENT=*NONE cancels the existing assignment.

• ALTERNATE-CLIENT=<client> cancels the existing assignment and specifies a new assignment for the specified net clients.

Information on the high availability of net clients can be requested using the SHOW-NET-CLIENT-ALTERNATE command.

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

SET-NET-CLIENT-ALTERNATE

	CLIENT = <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>
,ALTERNATE-CLIENT = <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 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.

ALTERNATE-CLIENT =
Specifies the net client which is to be assigned as alternative net client.

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

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

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

ALTERNATE-CLIENT = *IP-ADDRESS(...)
IP address of the alternative 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	0	NKAN015	Alternate assignment already exists
	1	NKAN003	Syntax error in the input
	32	NKAN004	Error in command execution