Stop dynamic I/O configuration change
Component: | BS2000 |
Functional area: | Device management |
Domain: | DEVICE |
Privileges: | OPERATING |
Routing code: | G |
Function
With the STOP-CONFIGURATION-UPDATE command, systems support terminates the dynamic I/O configuration changes that was started with the START-CONFIGURATION-UPDATE command.
Configuration modifications made in the course of a dynamic I/O configuration changes are first performed in the active IORSF (Input/Output Resource File). In order to have the modified input/output configuration available for the next session, the current IORSF can be saved on the SVP hard disk using the IORSF-UPDATE operand. The DEVICE-RESERVE operand can be used to ensure that a free reserve area is created for later extensions when the data is written back. By default, the size of the active IORSF is not changed when writing back (an IORSF created with IOGEN creates a reserve area for 512 entries).
If the system crashes before this has been done, any modifications made to the configuration will not be lost in the next IPL, since the BS2000 input/output tables are derived from the active IORSF when the system is started.
The command can be entered more than once, i.e. if the user forgets to back up the active IORSF at a particular level on entry then the backup can be performed subsequently by entering a further, corrected STOP-CONFIGURATION-UPDATE command.
When the dynamic I/O configuration change has been concluded successfully, the ADD-IO-UNIT, REMOVE-IO-UNIT and MODIFY-IO-UNIT reconfiguration commands are no longer accepted.
Format
STOP-CONFIGURATION-UPDATE | ||||||||||||||||
| ||||||||||||||||
Operands
IORSF-UPDATE = *NO / *YES(...)
Specifies whether the IORSF is to be updated on the SVP hard disk.
IORSF-UPDATE = *YES(...)
The active IORSF is to be updated on the SVP hard disk.
LEVEL = <integer 0..15>
Defines the level for the IORSF to be written back.
DEVICE-RESERVE = *UNCHANGED / <integer 16..2048>
Number of devices for which a reserve area for later extensions is to be created in the IORSF.
Return codes
(SC2) | SC1 | Maincode | Meaning |
|---|---|---|---|
0 | CMD0001 | No error | |
1 | NKR0006 | Syntax error | |
64 | CMD0216 | User does not have authorization | |
1 | 64 | NKR0169 | System error |
4 | 64 | NKR0169 | Dynamic I/O configuration change is not supported |
12 | 64 | NKR0169 | Dynamic I/O configuration change was not started |