INCLUDE-DEVICE-CONNECTION

Attach virtual connections

Component:	BS2000
Functional area:	Device management
Domain:	DEVICE
Privileges:	OPERATING
Routing code:	G

Function

This command enables the operator to attach virtual connections between the hardware units (CHN, CTL, DVC), i.e. permit the operating system to use these connections.

Effect of the INCLUDE-DEVICE-CONNECTION command:

1. If the connections specified were in the state “removed explicitly”, they assume the state “included”. The connections can be used again.

2. If the outer units associated with this connection were in the state “detached implicitly”, they assume the state “attached”. These hardware units can be used again.

3. In the outer hardware units which have assumed the state “attached” as per point 2, the outward connections are checked: if the connections were in the state “removed implicitly”, they assume the state “included”. These connections can be used again.

4. In the case of disk and tape devices which are capable of forming path groups, the newly attached paths are included in the path group. 

Format

INCLUDE-DEVICE-CONNECTION

FROM = *CHANNEL(...) / *CONTROLLER(...) / list-poss(8): <alphanum-name 2..2> / <x-text 4..4>
	*CHANNEL(...)
		|	CHANNEL-PATH-ID = list-poss(8): <x-text 2..2>
	*CONTROLLER(...)
		|	CONTROLLER-UNIT = list-poss(8): <alphanum-name 2..2> / <x-text 4..4>
,TO = *CHANNEL(...) / *CONTROLLER(...) / list-poss(8): <alphanum-name 2..2> / <x-text 4..4>
	*CHANNEL(...)
		|	CHANNEL-PATH-ID = list-poss(8): <x-text 2..2>
	*CONTROLLER(...)
		|	CONTROLLER-UNIT = list-poss(8): <alphanum-name 2..2> / <x-text 4..4>
,SCOPE = *OWN-SYSTEM-ONLY / *VM2000-GLOBAL

Operands

FROM =
Defines the virtual connection to be attached in terms of one of the delimiting hardware units. The direction in which the virtual connection is attached is not prescribed. FROM therefore does not have to be the inner and TO the outer unit.

FROM = *CHANNEL(...)
Defines the virtual connection to be attached in terms of a specific channel.

CHANNEL-PATH-ID = list-poss(8): <x-text 2..2>
Specifies the channel path ID of the channel that delimits the virtual connection. A maximum of 8 channels can be specified.

FROM = *CONTROLLER(...)
Defines the virtual connection to be attached in terms of a specific controller.

CONTROLLER-UNIT = list-poss(8): <alphanum-name 2..2> / <x-text 4..4>
Specifies the mnemonic device code (MN) of the controller that delimits the virtual connection. A maximum of 8 controllers can be specified.

FROM = list-poss(8): <alphanum-name 2..2> / <x-text 4..4>
Defines the virtual connection to be attached in terms of a specific device. A maximum of 8 devices (mnemonic device codes) can be specified.

TO = *CHANNEL(...) / *CONTROLLER(...) / list-poss(8): <alphanum-name 2..2> / <x-text 4..4>
Defines the virtual connection to be attached in terms of the other delimiting hardware unit. This unit represents the second element of the pair and is specified according to the FROM operand. A maximum of 8 units can be specified.

SCOPE = 
Specifies how the command is to be executed in VM2000 operating mode.

SCOPE = *OWN-SYSTEM-ONLY
The command is only executed in the local system.

SCOPE = *VM2000-GLOBAL
If entered in the VM Monitor System (VM1) the command is executed in all the guest systems.

Return codes

(SC2)	SC1	Maincode	Meaning
	0	CMD0001	No error
4	64	NKR0...	Path already attached
12	64	NKR0...	Internal check negative
16	64	NKR0...	Caller error
20	64	NKR0...	Software error

Note

If there is an error in command termination, the maincode contains the message code of the message output during command processing.

Example

Attach the connection between device L1 and channel 12:

/INCLUDE-DEVICE-CONNECTION FROM=L1,TO=*CHANNEL(12) or
/INCL-DEV-CONN FROM=L1,TO=*CH(12)