BCGEN: Modify processor names and addresses

Using this command, you modify the name of a computer system.
The command is only executed if the system being addressed has not yet been activated using BCIN or shut down using BCOUT.

BS2000 console	BS2000 SDF command	Command/ SOF file	SNMP management	Parameter service
x		x	x

List of valid command sources

BCGEN

CHANGE = (...)
	(...)
		|		PROCESSOR = <processor-name 1 .. 8>
		|		,NEWNAME = *unchanged / <processor-name 1 .. 8>
		|		,SOKHOST = *unchanged / <sockethost-name 1 .. 32>
		|		,LANADR = *unchanged / <x-string 1 .. 12>
		|			,...
		|				|		OLD-LANADR = *none / <x-string 1 .. 12>
		|		,INTADR = *unchanged / <x-string 1 .. 40>
		|			,...
		|				|		OLD-INTADR = *none / <x-string 1 .. 40>
		|		,IPADR = *unchanged / <composed-name 7..15> / <x-string 1 .. 8> / list-poss (4): <integer 0 .. 255>
		|			,...
		|				|		OLD-IPADR = *none / <composed-name 7..15> / <x-string 1 .. 8> /
		|				|			list-poss (4): <integer 0 .. 255>
		|		,I6-ADDRESS = *unchanged / <c-string 1 .. 45>
		|			,...
		|				|		OLD-I6-ADDRESS = *none / <c-string 1 .. 45>

CHANGE=(...)

PROCESSOR=<processor-name 1..8>
Existing processor name for which the configuration modification is to be made.

NEWNAME=>
New processor name

NEWNAME= *unchanged
The processor name remains unchanged.

NEWNAME=<processor-name 1..8>
Specification of new processor.

SOKHOST=...
New processor socket host name

SOKHOST= *unchanged
The processor socket host name remains unchanged.

SOKHOST=<sockethost-name 1..32>
Specification of new socket host name.

LANADR=...
Denotes the Ethernet address of the processor

LANADR= *unchanged
The Ethernet address of the processor remains unchanged.

LANADR=<x-string 1..12>
Hexadecimal value, 6 bytes, is issued left-justified, and extended with X’00’.
The X’00’ entry is not permitted.

OLD-LANADR=...
The old Ethernet address to be replaced for the system.
This specification is only necessary if the processor has more than one Ethernet address.

OLD-LANADR= *none
The processor has only one old Ethernet address.

OLD-LANADR=<x-string 1..12>
Hexadecimal value, 6 bytes, is issued left-justified, and extended with X’00’.
The X’00’ entry is not permitted.

INTADR=...
Denotes the Internet address of the processor

INTADR= *unchanged
The Internet address of the processor remains unchanged.

INTADR=<x-string 1..40>
New Internet address of the processor
Hexadecimal value, 1 - 20 byte

OLD-INTADR=...
The old Internet address to be replaced for the processor.
This specification is always necessary if the processor has more than one Internet address.

OLD-INTADR= *none
The processor has only one old Internet address.

OLD-INTADR=<x-string 1..40>
Hexadecimal value, 1 - 20 b

IPADR=...
Denotes the IP address of the processor

IPADR= *unchanged
The IP address of the processor remains unchanged.

IPADR=<composed-name 7..15> /<x-string 1..8> / list-poss (4): <integer 0..255>
Hexadecimal value, 4 bytes, is issued left-justified, and extended with X’00’.
Specification in the form (n,n,n,n) is also possible, where n is a number between 0 and 255.

OLD-IPADR=...
The old IP address to be replaced for the processor.
This specification is always necessary if the processor has more than one IP address.

OLD-IPADR= *none
The processor has only one old IP address.

OLD-IPADR=<composed-name 7..15> / <x-string 1..8> / listposs(4): <integer 0..255>
Hexadecimal, 4 bytes, issued left-justified, and extended with X’00’.
Specification in the form (n,n,n,n) is also possible, where n is a number between 0 and 255.

I6-ADDRESS=...
Designates the processor’s IPv6 address

I6-ADDRESS= *unchanged
The processor’s IPv6 address remains unchanged.

I6-ADDRESS=<c-string 1..45>
The processor’s IPv6 address.

OLD-I6-ADDRESS=...
The processor’s old IPv6 address that is to be replaced.
This specification is necessary whenever the processor possesses more than one IPv6 address.

OLD-I6-ADDRESS= *none
The processor possesses only an old IPv6 address.

OLD-I6-ADDRESS=<c-string 1..45>
The processor’s old IPv6 address that is to be replaced.

Command logging

For reasons of compatibility the processing acknowledgment is supplied in news BCA0763 if it is positive and in news BCA0762 if it is negative.
A description of the error messages that can be issued during command processing is provided in the table below. 

Command return codes

(SC2)      SC1	Maincode	Meaning
0        0	CMD0001	Command successfully processed
0        0	BCA0643	Name/address not modified
0        1	BCA0768	Syntax error in command
0        1	BCA0770	Parameter is invalid. Cause:
0       64	BCA07A8	Computer is not shut down
0       64	BCA07A9	Route is not shut down
0       64	BCA0833	Name already defined
0      128	BCA0814	BCAM is being terminated abnormally
0      128	BCA0816	BCAM is terminating
0      130	BCA0766	BCAM is not active