Your Browser is not longer supported

Please use Google Chrome, Mozilla Firefox or Microsoft Edge to view the page correctly
Loading...

{{viewport.spaceProperty.prod}}

REMOVE-DEVICE-CONNECTION

&pagelevel(3)&pagelevel

Clear virtual connections

Component:

BS2000

Functional area:

Device management

Domain:

DEVICE

Privileges:

OPERATING

Routing code:

G

Function

This command enables the operator to clear virtual connections between the hardware units (CHN, CTL, DVC) from the system, i.e. to prevent the system from using these connections.

Information on existing connections is displayed by the SHOW-DEVICE-CONFIGURATION command.

Effect of the REMOVE-DEVICE-CONNECTION command

  1. If permitted, each of the specified connections changes to the status REMOVED EXPLICITLY. They cannot be used.

  2. Every outer unit affected which does not have an inner connection in the status INCLUDED changes to the status DETACHED IMPLICITLY. None of these units can be used.

  3. The connections of the outer hardware units which, as described in the preceding point, have the status DETACHED IMPLICITLY change to the status REMOVED IMPLICITLY. These connections cannot be used.

  4. In the case of disk or tape devices which are able to form path groups, the path group is cleared. 

Format

REMOVE-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

,FORCE = *STD / *YES / *NO(...)


*NO(...)



|

WAIT = *NO / *STD / <integer 1..32767>(...)



|


<integer 1..32767>(...)



|



|

DIM = *STD / *MIN / *SEC

Operands

FROM =
Identifies the virtual connection to be cleared via one of the delimiting hardware units. The direction in which the virtual connection is removed is not predefined. FROM therefore does not have to be the inner and TO the outer unit.

FROM = *CHANNEL(...)
Defines the virtual connection to be cleared 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 cleared 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 cleared 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 cleared in terms of the other delimiting hardware unit. This unit, the second element of the pair (virtual connection), is specified according to the FROM operand.

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 Monitor System (VM1), the command is executed inall guest systems.
If entered in another guest system, the command is rejected with message NKR0178.

FORCE =
Specifies the execution mode for REMOVE-DEVICE-CONNECTION.

FORCE = *STD
Immediate execution of the reconfiguration job is only required if the outer units involved are not being used. A wait time of up to 15 minutes may elapse for release of the units. During the wait time the connection is in the REMOVE-PENDING state. If the unit is released in under 15 minutes, the connection switches to the REMOVED state, otherwise it switches to the INCLUDED state.

FORCE = *YES
The reconfiguration job is to be executed immediately.

FORCE = *NO(...)
Immediate execution of the reconfiguration job is only required if the outer units involved are not being used. Otherwise, the time specified in the WAIT operand must elapse before the units are released, and the virtual connection then switches to the REMOVE-PENDING state. If the units are released within the specified period, the connection switches to the REMOVED state; if not, it switches to the INCLUDED state.

WAIT =
Specifies the maximum wait time for execution of the reconfiguration job in execution mode FORCE=*NO.

WAIT = *NO
No maximum wait time is specified for execution of the reconfiguration job.

WAIT = *STD
The maximum wait time for execution of the reconfiguration job is set to 15 minutes.

WAIT = <integer 1..32767>(...)
Specifies the maximum wait time.

DIM =
Specifies whether the value defined for the wait time is to interpreted in minutes or seconds.

DIM = *STD
Wait time as for DIM=*MIN.

DIM = *MIN
Specifies the maximum wait time in minutes.
Possible values: 1 <= <integer> <= 546

DIM = *SEC
Specifies the maximum wait time in seconds.
Possible values: 1 <= <integer> <= 32767

Return codes

(SC2)

SC1

Maincode

Meaning


0

CMD0001

No error

4

64

NKR0...

Path already detached

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.

Notes

  • If a reconfiguration job cannot be executed with FORCE=*NO within the specified wait time, it is rejected with the following message:

    NKR0037

    mn MAY CURRENTLY NOT BE DETACHED

    NKR0059

    mn1/mn3 REMOVE REJECTED

    In this case the operator should either:

    • ask for more detailed information using the SHOW command, terminate tasks which have reserved the device, or assign other devices,

    • or repeat the reconfiguration job in execution mode FORCE=*YES.

  • A reconfiguration job is not executed, regardless of the execution mode, if the last path to a unit absolutely essential for the system is affected (see DETACH-DEVICE, note 2).

  • The status REMOVE PENDING can be terminated by means of the appropriate command

    INCLUDE-DEVICE-CONNECTION or REMOVE-DEVICE-CONNECTION ...,FORCE=*YES

  • For magnetic tape controllers with two channel ports or for dual magnetic tape controllers, paths that are physically not available should also be logically removed. Otherwise, path handling by the system could cause an error. 

Examples

  1. Detach the connections between devices Y1, Y2, Y3 and the controller Z4, if permissible (default wait time)

    /REMOVE-DEVICE-CONNECTION FROM=(Y1,Y2,Y3),TO=*CONTROLLER(Z4),FORCE=*NO
    or
    /REM FROM=(Y1,Y2,Y3),TO=*CON(Z4)

  2. Clear the connection between device D1 and controller Z5 immediately

    /REMOVE-DEVICE-CONNECTION FROM=D1,TO=*CONTROLLER(Z5),FORCE=*YES
    or
    /REM FROM=D1,TO=*CON(Z5),FORCE=*Y

  3. Clear the connections between devices L1 and L2 and channels 10 and 40.

    /REMOVE-DEVICE-CONNECTION FROM=(L1,L2),TO=*CHANNEL((10,40)),FORCE=*YES
    or
    /REM FROM=(L1,L2),TO=*CH((10,40)),FORCE=*Y

Powered by Atlassian Confluence and Scroll Viewport.