Storage system: | ETERNUS DX/AF |
Domain: | DEVICE |
Privileges: | TSOS |
allows you to change the settings for SHC-OSD for maintenance and diagnostics. The initial settings are described in the example for
/MODIFY-SHC-PROCESSING/SHOW-SHC-PROCESSING on "SHOW-SHC-PROCESSING Displays settings of SHC-OSD".
The current settings can be displayed by means of /SHOW-SHC-PROCESSING.
Changes to security settings using the SYSTEM-ADMIN-SCOPE and TASK-ADMIN-SCOPE operands are logged on the console.
MODIFY-SHC-PROCESSING | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
TRACE = *UNCHANGED / *PARAMETERS(...)
Changes the trace and logging options.
EXTENDED-TRACE = *UNCHANGED / *OFF / *ON
Controls the size of the entries in the normal trace of SHC-OSD. If EXTENDED-TRACE=*ON is specified, additional information is recorded to facilitate diagnosis. The default setting is *OFF.
NEW-TRACE-SIZE =
Specifies whether the size of the trace area in class 4 memory is to be changed. If it is, the existing area is released and the new area requested.
NEW-TRACE-SIZE = *UNCHANGED
The previous setting remains unchanged.
NEW-TRACE-SIZE = <integer 64..4096 Kbyte >
New size of the trace area.
NEW-ERROR-TRACE-SIZE =
Specifies whether the size of the error trace area in class 4 memory is to be changed. If it is, the existing area is released and the new area requested.
NEW-ERROR-TRACE-SIZE = *UNCHANGED
The previous setting remains unchanged.
NEW-ERROR-TRACE-SIZE = <integer 64..4096 Kbyte >
New size of the error trace area.
RELEASE-TRACE-AT-UNLOAD =
Specifies whether the trace area is released if the /HOLD-SUBSYSTEM or /STOP-SUBSYSTEM SHC-OSD command was specified (see the “Commands” manual [1]).
RELEASE-TRACE-AT-UNLOAD = *UNCHANGED
The previous setting remains unchanged. The initial setting is *YES.
RELEASE-TRACE-AT-UNLOAD = *YES
Trace areas are released when SHC-OSD is unloaded.
RELEASE-TRACE-AT-UNLOAD = *NO /HOLD-SUBSYSTEM (see manual “Commands” [1]) allows diagnostic information to be generated on problems associated with subsystem termination by running NDMDAMP after /HOLD-SUBSYSTEM. The memory area in class 4 memory cannot be released.
SHC-OSD-LOG =
Switches SHC-OSD logging to the current log file in the POSIX file system (path: /var/shcosd/log) on or off. General SHC-OSD errors and messages for supporting ETERNUS DX/AF are logged. Information about SHC-OSD logging can be found in section "Diagnostic aids".
SHC-OSD-LOG = *UNCHANGED
The previous setting remains unchanged
SHC-OSD-LOG = *ON
SHC-OSD logging is switched on.
SHC-OSD-LOG = *OFF
The entire SHC-OSD logging is switched off.
SAVE-TRACES =
Starts the (one-off) backup of the SHC traces to a file /var/shcosd/log/dumptrac-yyyymmdd-hhmm.txt. This operand is used only to create diagnostic information.
SAVE-TRACES = *NO
Backup of the SHC traces is not started.
SAVE-TRACES = *YES
Backup of the SHC traces is started once.
SAVE-TABLES =
Starts the (one-off) backup of the SHC tables to a file /var/shcosd/log/dumptabl-yyyymmdd-hhmm.txt. This operand is used only to create diagnostic information.
SAVE-TABLES = *NO
Backup of the SHC tables is not started.
SAVE-TABLES = *YES
Backup of the SHC tables is started once.
SAVE-STORMAN-TRACES =
Starts on the current StorMan server the (one-off) backup of all StorMan traces to a file. This operand is used only to create diagnostic information.
SAVE-STORMAN-TRACES = *NO
Backup of the StorMan traces is not started.
SAVE-STORMAN-TRACES = *YES
Backup of the StorMan traces is started once.
LOCK-RETRY = *UNCHANGED / *PARAMETERS(...)
Changes the retry count and the wait time between retries when a lock conflict occurs in SHC-OSD.
WAIT-TIME = *UNCHANGED / <integer 1..10 seconds >
Wait time between retries.
RETRY-COUNT = *UNCHANGED / <integer 1..100>
Maximum number of retries (retry count).
SYNCH-WAIT-RETRY = *UNCHANGED / *PARAMETERS(...)
Changes the retry count and wait time between retries when WAIT=*UNTIL-SYNCHRONIZATION is issued with a command.
WAIT-TIME = *UNCHANGED / <integer 1..120 seconds >
Wait time between retries.
RETRY-COUNT = *UNCHANGED / <integer 1..100>
Maximum number of retries (retry count).
COMM-WAIT-RETRY = *UNCHANGED / *PARAMETERS(...)
Changes the retry count and wait time between retries for FITC communication of SHC-OSD.
WAIT-TIME = *UNCHANGED / <integer 10..100 seconds >
Wait time between retries.
RETRY-COUNT = *UNCHANGED / <integer 1..100>
Maximum number of retries (retry count).
STATE-CHANGE-POLLING = *UNCHANGED / *PARAMETERS(...)
Changes the polling interval for the periodic check of all units in the storage system after state changes. Specifies whether state changes are to be recorded for all devices or for attached devices only.
NORMAL-INTERVAL = *UNCHANGED / <integer 60..7200 seconds >
Polling interval for checking at normal intervals (i.e. no problems during last polling cycle).
SELECT-DEVICES = *UNCHANGED / *ALL / *ATTACHED
Specifies whether state changes found during polling or SHC-OSD commands are to be output for all devices or for the currently attached devices only.
OPERATOR-ORDERS = *UNCHANGED / *YES / *NO
Specifies whether operator orders that must be acknowledged or simple messages only are to be output in the event of state changes.
NEXT-CONFIG-UPDATE = *UNCHANGED / *DISCOVER
Specifies whether all configuration changes are to be discovered at the next update.
LOG-CHANGES =
Specifies whether all state changes or only global state changes are to be logged on the console.
LOG-CHANGES = *UNCHANGED
The previous setting remains unchanged.
LOG-CHANGES = *ALL-EVENTS
All state changes are logged on the console. This means that all state changes detected in the storage system, including state changes of individual logical units and their mirror disks, are logged on the console.
LOG-CHANGES = *MAJOR-EVENTS-ONLY
All global state changes detected in the storage system, as well as state changes for functions offered in the storage system, are logged on the console. State changes of individual logical volumes and their mirror disks are not logged.
POLLING-MODE =
Specifies the polling mode, which determines the scope of the periodic check.
POLLING-MODE = *UNCHANGED
The polling mode remains unchanged.
POLLING-MODE = *NONE
No periodic check; consequently no monitoring of any type (“Event Monitoring”) takes place.
POLLING-MODE = *PING
Only the failure (or the availability) of a storage system is checked in the periodic check.
POLLING-MODE = *SYNC
The failure and status changes of a storage system are checked in the periodic check.
POLLING-MODE = *STD
The failure and status changes of a storage system and of the selected devices are checked in the periodic check.
USER-TASK-SETTINGS =
Settings for the user task of SHC-OSD with the job name SHCUSERT.
USER-TASK-SETTINGS = *UNCHANGED
The settings for the user task remain unchanged.
USER-TASK-SETTINGS = *PARAMETERS(...)
Parameters for the settings for the user task.
USER-TASK-PRIO =
Specifies the priority of the SHC-OSD user task with the job name SHCUSERT.
USER-TASK-PRIO = *UNCHANGED
The priority remains unchanged.
USER-TASK-PRIO = <integer 80..255>
Specifies the priority in the range from 80 (highest priority) through 255 (lowest priority).
FORK-ACTION =
Specifies whether or not the user task of SHC-OSD with the job name SHCUSERT uses the POSIX function fork.
FORK-ACTION = *UNCHANGED
The setting for using the fork function remains unchanged.
FORK-ACTION = *YES
The user task uses fork (normal case).
FORK-ACTION = *NO
The user task does not use fork. This setting is used only for error analysis.
DEVICE-PRESELECTION =
Preselection of units for which information is output by default by SHOW commands.
If the basic setting is used, only generated units are displayed.
DEVICE-PRESELECTION = *UNCHANGED
The previous setting remains unchanged.
DEVICE-PRESELECTION = *ALL-DEFINED
By default, the SHOW commands return information on all units generated in BS2000 in accordance with the basic setting.
DEVICE-PRESELECTION = *ANY
By default, the SHOW commands return information on all units in the selected storage system.
SYSTEM-ADMIN-SCOPE =
Changes the global security settings for executing actions. Depending on the setting, such actions may be performed only for devices attached or defined (generated) in BS2000 or for any devices of a storage system. The security settings apply for all action commands:
ACTIVATE-CLONE on "ACTIVATE-CLONE Activates a clone pair"
HOLD-REMOTE-COPY on "HOLD-REMOTE-COPY Interrupts remote copy mode"
MODIFY-REMOTE-COPY-PARAMETER on "MODIFY-REMOTE-COPY-PARAMETER Changes the processing mode and remote copy parameters"
RESTART-CLONE-SESSION on "RESTART-CLONE-SESSION Re-creating a clone pair"
RESTORE-FROM-CLONE on "RESTORE-FROM-CLONE Reconstructs an original from a clone unit"
RESTORE-FROM-SNAP on "RESTORE-FROM-SNAP Reconstructs an original from a snap unit"
RESUME-REMOTE-COPY on "RESUME-REMOTE-COPY Resumes remote copy mode"
START-CLONE-SESSION on "START-CLONE-SESSION Creates a clone pair"
START-REMOTE-COPY on "START-REMOTE-COPY Creates a remote copy pair"
START-SNAP-SESSION on "START-SNAP-SESSION Creates a snap pair"
STOP-CLONE-SESSION on "STOP-CLONE-SESSION Cancels a clone pair"
STOP-REMOTE-COPY on "STOP-REMOTE-COPY Cancels a remote copy pair"
STOP-SNAP-SESSION on "STOP-SNAP-SESSION Cancels a snap pair"
SWAP-CLONE-SESSION on "SWAP-CLONE-SESSION Swaps original and clone attributes of a clone pair"
SWAP-REMOTE-COPY on "SWAP-REMOTE-COPY Swaps the source and target property of a remote copy pair"
The basic setting corresponds to the values DETACHED-DEVICES=*REJECT and NOT-DEFINED-DEVICES=*REJECT.
SYSTEM-ADMIN-SCOPE = *UNCHANGED
The previous setting remains unchanged.
SYSTEM-ADMIN-SCOPE = *PARAMETERS(....)
The setting is made by means of parameters.
DETACHED-DEVICES =
Actions are executed for detached devices.
DETACHED-DEVICES = *UNCHANGED
The previous setting remains unchanged.
DETACHED-DEVICES = *REJECT
Actions are rejected for detached devices.
DETACHED-DEVICES = *ACCEPT
Actions are executed for detached devices.
NOT-DEFINED-DEVICES =
Actions are executed for devices not generated in BS2000.
NOT-DEFINED-DEVICES = *UNCHANGED
The previous setting remains unchanged.
NOT-DEFINED-DEVICES = *REJECT
Actions are rejected for devices not generated.
NOT-DEFINED-DEVICES = *ACCEPT
Actions are executed for devices not generated.
TASK-ADMIN-SCOPE =
Changes the task-specific security settings for executing actions. Depending on the setting, such actions may be performed only for devices attached or defined (generated) in BS2000 or for any devices of a storage system. The security settings apply for all action commands:
ACTIVATE-CLONE on "ACTIVATE-CLONE Activates a clone pair"
HOLD-REMOTE-COPY on "HOLD-REMOTE-COPY Interrupts remote copy mode"
MODIFY-REMOTE-COPY-PARAMETER on "MODIFY-REMOTE-COPY-PARAMETER Changes the processing mode and remote copy parameters"
RESTART-CLONE-SESSION on "RESTART-CLONE-SESSION Re-creating a clone pair"
RESTORE-FROM-CLONE on "RESTORE-FROM-CLONE Reconstructs an original from a clone unit"
RESTORE-FROM-SNAP on "RESTORE-FROM-SNAP Reconstructs an original from a snap unit"
RESUME-REMOTE-COPY on "RESUME-REMOTE-COPY Resumes remote copy mode"
START-CLONE-SESSION on "START-CLONE-SESSION Creates a clone pair"
START-REMOTE-COPY on "START-REMOTE-COPY Creates a remote copy pair"
START-SNAP-SESSION on "START-SNAP-SESSION Creates a snap pair"
STOP-REMOTE-COPY on "STOP-REMOTE-COPY Cancels a remote copy pair"
STOP-SNAP-SESSION on "STOP-SNAP-SESSION Cancels a snap pair"
SWAP-CLONE-SESSION on "SWAP-CLONE-SESSION Swaps original and clone attributes of a clone pair"
SWAP-REMOTE-COPY on "SWAP-REMOTE-COPY Swaps the source and target property of a remote copy pair"
The basic setting corresponds to the values DETACHED-DEVICES=*SYSTEM-ADMIN-SCOPE and NOT-DEFINED-DEVICES=*SYSTEM-ADMIN-SCOPE.
TASK-ADMIN-SCOPE = *UNCHANGED
The previous setting remains unchanged.
TASK-ADMIN-SCOPE = *PARAMETERS(....)
The setting is made by means of parameters.
DETACHED-DEVICES =
Actions are executed for detached devices.
DETACHED-DEVICES = *UNCHANGED
The previous setting remains unchanged.
DETACHED-DEVICES = *REJECT
Actions are rejected for detached devices.
DETACHED-DEVICES = *ACCEPT
Actions are executed for detached devices.
DETACHED-DEVICES = *SYSTEM-ADMIN-SCOPE
The global system setting applies.
NOT-DEFINED-DEVICES =
Actions are executed for devices not generated in BS2000.
NOT-DEFINED-DEVICES = *UNCHANGED
The previous setting remains unchanged.
NOT-DEFINED-DEVICES = *REJECT
Actions are rejected for devices not generated.
NOT-DEFINED-DEVICES = *ACCEPT
Actions are executed for devices not generated.
NOT-DEFINED-DEVICES = *SYSTEM-ADMIN-SCOPE
The global system setting applies.
Examples
/MODIFY-SHC-PROCESSING TRACE=*PARAMETERS(EXTENDED-TRACE=*ON)
/MODIFY-SHC-PROCESSING LOCK-RETRY=*PARAMETERS(WAIT-TIME=2,RETRY-COUNT=40)
/MODIFY-SHC-PROCESSING STATE-CHANGE-POLLING=*PARAMETERS(SELECT-DEVICES=*ALL)
Command return codes
(SC2) | SC1 | Maincode | Meaning |
0 | CMD0001 | Command executed successfully | |
1 | CMD0202 | Syntax error | |
32 | NDE2002 | Internal error | |
64 | CMD0087 | Function not permitted in the current input mode or with the current task privileges | |
64 | CMD0216 | Required privilege not available |