Show IO settings of input/output devices
Component: | BS2000 |
Functional area: | Device management |
Domain: | DEVICE |
Privileges: | OPERATING |
Routing Code: | G |
Function
The SHOW-IO-OPTIONS command provides information about following IO settings of the input/output devices:
- Timeout values for IO monitoring.
- FastDPAV settings, if FastDPAV is supported in the system.
Using the command /MODIFY-IO-OPTIONS these settings can be modified.
Format
SHOW-IO-OPTIONS |
Operands
UNIT = *ALL -MODIFIED/alphanum-name_2..2 / x-text_4..4 / *CONTROLLER(...) / *DEVICE-RANGE(...)
Specifies the devices, for which the settings shall be shown.
If FastDPAV is supported in the system, the setting is always shown, independently of the value of the UNIT operand.
UNIT = *ALL-MODIFIED
Shows all settings of timeout values, that differ from the system default value.
UNIT =alphanum-name_2..2 / x-text_4..4
2- or 4-character mnemonic device code of the device.
UNIT = *CONTROLLER(...)
The timeout values shall be shown for all devices of a controller.
NAME = <alphanum-name 2..2> / <x-text 4..4>
2- or 4-character mnemonic device code of the controller.
UNIT = *DEVICE-RANGE(...)
The timeout values shall be shown for a group of devices.
The mnemonic device codes specified in this range must not allover belong to generated devices. If the device does not exist, the processing continues with the following mnemonic. Based on the mnemonic of the first device (FROM operand), the mnemonics of the following devices are determined by adding 1 for 4-character (hexadecimal) mnemonics until the mnemonic of the TO operand is reached. In the case of 2-character (alphanumeric) mnemonics, the subsequent mnemonics are created in ascending lexicographical order, that means letters before digits (A, B, ...,Z, 0, 1, ..., 9). The range is limited to 256 mnemonics. The range may not exceed the highest mnemonic FFFF or 99 respectively.
FROM = <alphanum-name 2..2> / <x-text 4..4>
2- or 4-character mnemonic device code of the first device.
TO = <alphanum-name 2..2> / <x-text 4..4>
2- or 4-character mnemonic device code of the last device.
Command Return Codes
(SC2) | SC1 | Maincode | Meaning |
|---|---|---|---|
| 0 | CMD001 | Command processed successfully |
| 64 | NDI0711 | UNIT not found |
| 64 | NDI0715 | Device Range invalid |
| 32 | NDI0713 | Internal error |
Output format
The output starts with the title for the timeout values, followed by lines with the values of the requested units.
If Fast-DPAV is supported, the actual settings are shown behind.
The output columns of the timeout informations have the following meaning:
| Output column | Meaning |
|---|---|
| DVC-MN | mnemonic device code of the device |
| CTL-MN | mnemonic device code of the controller |
| SYS-VAL | system default timeout value in seconds of the device(s) |
| MOD-VAL | the modified timeout value in seconds |
| MOD-VAL-MIN | the lowest modifed timeout value for the devices at the specified controller |
| MOD-VAL-MAX | the highest modifed timeout value for the devices at the specified controller |
Examples
/SHOW-IO-OPTIONS *ALL-MODIFIED
------------------------------- TIMEOUT -------------------------------- NO MODIFICATIONS ------------------------------ FAST-DPAV ------------------------------- FAST-DPAV PREFERRED DEVICE: BASE-DEVICE
FastDPAV is supported, PREFERRED-DEVICE is „BASE-DEVICE“
/SHOW-IO-OPTIONS A500
------------------------------- TIMEOUT -------------------------------- DVC-MN SYS-VAL MOD-VAL A500 00064 00504 ------------------------------ FAST-DPAV ------------------------------- FAST-DPAV PREFERRED DEVICE: BASE-DEVICE
The timeout values for device A500 are shown. Currently the value is modified with /MODIFY-IO-UNIT.
/SHO-IO-OPT
------------------------------- TIMEOUT -------------------------------- CTL-MN SYS-VAL MOD-VAL-MIN MOD-VAL-MAX AK 00064 00504 - AL 00064 00504 - ------------------------------ FAST-DPAV ------------------------------- FAST-DPAV PREFERRED DEVICE: ALIAS-DEVICE
If UNIT=*ALL-MODIFIED (default value) is given, all controller are shown, which have at least one device with a modified timeout value. The system default value is shown (which is identical for all devices at the controller) and the lowest and highest currently modified timeout value of the devices at this controller.
In this example only the value of the device A500 is modified. As A500 has paths to controller AK and AL, both controller are shown.
Special output at X86 server:
In a X86 server the BS2000 has no controller units. With the command /SHOW-IO-OPTIONS UNIT=*ALL-MODIFIED therefore all devices are shown, which timeout values have been modified..The output is limited to 256 devices.