Storage system: | ETERNUS DX/AF, Symmetrix/VMAX3 |
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.
SYMAPI-DEBUG =
Only relevant for Symmetrix/VMAX3.
Changes the debug mode setting for the SYMAPI server.
SYMAPI-DEBUG = *UNCHANGED
The previous setting remains unchanged.
SYMAPI-DEBUG = *OFF
Debug mode is deactivated.
SYMAPI-DEBUG = *ON(...)
Debug mode is activated. All activities of the SYMAPI server are logged.
SYMAPI-LOG =
Only relevant for Symmetrix/VMAX3.
Switches SYMAPI logging to the current log file on the SYMAPI server on or off.
This operand should be used with care. If it is switched off, SYMAPI no longer generates diagnostic documents.
SYMAPI-LOG = *UNCHANGED
The previous setting remains unchanged.
SYMAPI-LOG = *ON
SYMAPI logging is switched on.
SYMAPI-LOG = *OFF
SYMAPI logging is switched off.
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
For ETERNUS DX/AF: The entire SHC-OSD logging is switched off.
For Symmetrix/VMAX3: SHC-OSD logging is switched off. SHC-OSD logging is independent of SYMAPI logging, see the SYMAPI-LOG parameter.
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).
IO-RETRY = *UNCHANGED / *PARAMETERS(...)
Changes the retry count and wait time between retries when an expected state change does not occur in the storage system.
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.
SHORT-INTERVAL = *UNCHANGED / <integer 30..3600 seconds >
Polling interval for checks at short intervals (i.e. a unit in the storage system was not accessible at the last polling).
NORMAL-INTERVAL = *UNCHANGED / <integer 60..7200 seconds >
Polling interval for checking at normal intervals (i.e. no problems during last polling cycle).
LONG-INTERVAL = *UNCHANGED / <integer 360..86400 seconds >
Polling interval for checks at long intervals (i.e. no supported unit was found in the storage system at the last polling).
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.
For Symmetrix: This mode should not be set when TimeFinder/Snap is used because in this mode the occupancy level of the save pool is not monitored.
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.
POLLING-MODE = *DISCOVER
Only relevant for Symmetrix/VMAX3.
Complete redetermination of the configuration and status data of the storage system in every periodic check. This mode also detects configuration changes in the storage system.
This mode should not be set in normal operation because it is very resource-intensive.
REDISCOVER-TIME =
Only relevant for Symmetrix/VMAX3.
Specifies the time in hours during which a failed storage system should automatically be checked for rediscovery.
REDISCOVER-TIME = *UNCHANGED
The time for the automatic check remains unchanged.
REDISCOVER-TIME = *NO
No automatic check for rediscovery. This setting is recommended when, for example, a storage system has been permanently removed from the configuration.
REDISCOVER-TIME = *UNLIMITED
Unlimited automatic check for rediscovery. In this way SHC-OSD automatically recognizes when a storage system is available again.
REDISCOVER-TIME = <integer 1..9999>
Time for the automatic check for rediscovery in hours.
SNAP-SAVE-POOL-SAT =
Only relevant for Symmetrix.
Specifies a limit value for the occupancy level of the save pool. When you are using TimeFinder/Snap, message NDE0055/NDE0056 is displayed on the console to indicate that the limit value has been reached or exceeded (see “Monitoring the save pools” in "Snap units (Symmetrix)").
SNAP-SAVE-POOL-SAT = *UNCHANGED
The limit value remains unchanged.
SNAP-SAVE-POOL-SAT = <integer 1..100>
Specifies the limit value in percent.
THIN-POOL-SAT =
Only relevant for Symmetrix/VMAX3.
Specifies a limit value for the occupancy level of the thin pools used for virtual provisioning. The limit value applies for the thin pools selected in the SHC-OSD parameter file with the THIN-POOL-MONITORING parameter (see "Configuration of SHC-OSD"). When the limit value is reached or exceeded, this is logged on the console with messages NDE0070/NDE0071 (see “Monitoring the thin pools” in "Virtual provisioning and BS2000").
THIN-POOL-SAT = *UNCHANGED
The limit value remains unchanged.
THIN-POOL-SAT = <integer 1..100>
Specifies the limit value in percent.
THIN-DEVICE-SAT =
Only relevant for Symmetrix.
Specifies a limit value for the occupancy level of the Symmetrix volumes used with virtual provisioning at volume level. When the limit value is reached or exceeded, this is logged on the console with message NDE0074.
THIN-DEVICE-SAT = *UNCHANGED
The limit value remains unchanged.
THIN-DEVICE-SAT = *OFF
The limit value is not monitored.
THIN-DEVICE-SAT = <integer 1..100>
Specifies the limit value in percent.
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"
ACTIVATE-SNAP on "ACTIVATE-SNAP Activates a snap 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"
SET-REMOTE-COPY-ACCESS on "SET-REMOTE-COPY-ACCESS Sets the access path to the data of a remote copy pair"
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"
ACTIVATE-SNAP on "ACTIVATE-SNAP Activates a snap 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"
SET-REMOTE-COPY-ACCESS on "SET-REMOTE-COPY-ACCESS Sets the access path to the data of a remote copy pair"
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.
MULTI-SNAP =
Only relevant for Symmetrix.
Changes the setting for supporting a maximum of 127 snap units per original unit for TimeFinder/Snap.
MULTI-SNAP = *UNCHANGED
The previous setting remains unchanged
MULTI-SNAP = *ENABLED
Support for up to 127 snap units per original unit for TimeFinder/Snap is enabled.
MULTI-SNAP = *DISABLED
Support for up to 127 snap units per original unit for TimeFinder/Snap is disabled. In this case up to 15 snap units per original unit are supported for TimeFinder/Snap.
PRESELECT-SAVE-POOL =
Only relevant for Symmetrix.
Specifies which save pool is to be used for TimeFinder/Snap if automatic selection by means of SAVE-POOL=*BY-PRESELECTION is specified in the /START-SNAP-SESSION command.
PRESELECT-SAVE-POOL = *UNCHANGED
The previous setting remains unchanged
PRESELECT-SAVE-POOL = *DEFAULT-POOL
The storage system’s default pool is used as the save pool.
PRESELECT-SAVE-POOL = <name 1..32 with-under with-low>
Specifies the name of the storage system’s save pool.
This specification is case-sensitive.
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 | NDE2013 | SYMAPI error in command | |
64 | CMD0087 | Function not permitted in the current input mode or with the current task privileges | |
64 | CMD0216 | Required privilege not available |