Storage system: | ETERNUS DX/AF |
Domain: | DEVICE |
Privileges: | TSOS |
manages the settings for operating SHC-OSD with StorMan. The valid settings are displayed with
/MODIFY-SHC-ENVIRONMENT/SHOW-SHC-ENVIRONMENT and are described in the example for this command, see "SHOW-SHC-ENVIRONMENT Displays configuration of the external servers".
The CONNECTED-STORMAN operand enables the StorMan server to be switched over. In this case the connected StorMan server is disabled and another StorMan server defined in the SHC-OSD parameter file is connected.
StorMan requires the management instance to manage the ETERNUS DX/AF systems. This corresponds to the SMI-S Provider and is embedded in the storage system's firmware. The settings for the management instance must be made prior to management access to the storage system in order to enter the access data for the management instance in StorMan. See section "Configuring StorMan for access to the storage systems".
The STORMAN-PARAMETER operand enables the parameters to be managed by StorMan. All parameters which StorMan offers via the storparam interface can be modified (see the "StorMan" manual [15]). This function is required in particular for diagnostics. The settings for the StorMan server refer to the external StorMan server. The settings for the StorMan client refer to the StorMan calls integrated into SHC-OSD. When multiple StorMan parameters are to be modified, the command must be entered multiple times.
MODIFY-SHC-ENVIRONMENT | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
CONNECTED-STORMAN = *UNCHANGED / *PARAMETERS(...)
Modifies the connected StorMan server.
HOSTNAME =
Specifies the StorMan server to be used from the list of possible StorMan servers defined in the SHC-OSD parameter file.
HOST-NAME = *FIRST-AVAILABLE
Disables the connected StorMan server and then connects the first StorMan server in the OK status from the list defined in the SHC-OSD parameter file.
HOST-NAME = *NEXT-AVAILABLE
Disables the connected StorMan server and then connects the next StorMan server in the OK status from the list defined in the SHC-OSD parameter file.
HOST-NAME = *DISABLE-ALL
Disables the connected StorMan server. Following this the storage systems can no longer be managed.
HOST-NAME = *MU1
Disables the connected StorMan server and then connects the StorMan server on the first available MU of the SE server.
HOST-NAME = *MU2
Disables the connected StorMan server and then connects the StorMan server on another available MU of the SE server (if one exists).
HOST-NAME = *SE1MU1
Disables the connected StorMan server and then connects the StorMan server on the first MU of the first SE server. *SE1MU1 must be entered in the SHC-OSD parameter file and be in the OK status.
HOST-NAME = *SE1MU2
Disables the connected StorMan server and then connects the StorMan server on the second MU of the first SE server. *SE1MU2 must be entered in the SHC-OSD parameter file and be in the OK status.
HOST-NAME = *SE2MU1
Disables the connected StorMan server and then connects the StorMan server on the first MU of the second SE server. *SE2MU1 must be entered in the SHC-OSD parameter file and be in the OK status.
HOST-NAME = *SE2MU2
Disables the connected StorMan server and then connects the StorMan server on the second MU of the second SE server. *SE2MU2 must be entered in the SHC-OSD parameter file and be in the OK status.
HOST-NAME = *SE3MU1
Disables the connected StorMan server and then connects the StorMan server on the first MU of the third SE server. *SE3MU1 must be entered in the SHC-OSD parameter file and be in the OK status.
HOST-NAME = *SE3MU2
Disables the connected StorMan server and then connects the StorMan server on the second MU of the third SE server. *SE3MU2 must be entered in the SHC-OSD parameter file and be in the OK status.
HOST-NAME = *SE4MU1
Disables the connected StorMan server and then connects the StorMan server on the first MU of the fourth SE server. *SE4MU1 must be entered in the SHC-OSD parameter file and be in the OK status.
HOST-NAME = *SE4MU2
Disables the connected StorMan server and then connects the StorMan server on the second MU of the fourth SE server. *SE4MU2 must be entered in the SHC-OSD parameter file and be in the OK status.
HOST-NAME = <c-string 1..48 with-low> / <posix-filename 1..48>
Name or IP address (IPv4 or IPv6) of the StorMan server. The StorMan server to be connected must be entered in the SHC-OSD parameter file and be in the OK status.
WAIT = *NO / *UNTIL-UPDATED
Specifies whether execution of the command should wait for data update by the StorMan server to end (*UNTIL-UPDATED) or not (*NO).
STORMAN-PARAMETER = *UNCHANGED / *PARAMETERS(...)
Changes the StorMan parameters.
These settings should only be changed tmporary for diagnostic purpose on service request.
A selection of the dynamically settable parameters of the StorMan configuration is supported (see the storparam command in the "StorMan" manual [15]).
NAME = <c-string 1..32 with-low> / <posix-filename 1..32>
Name of the StorMan parameter. The following parameters are supported:
Debug (maximum trace level for StorMan)
DebugCom (trace level for communication (MaxTraceLevel 4 or higher))
TraceWorker (trace level for StorMan worker threads)
This specification is case-sensitive.
VALUE = <c-string 1..32 with-low> / <posix-filename 1..32>
New value for the StorMan parameter. The permissible value range for the parameters is described under the storparam command. This specification is case-sensitive.
DESTINATION = *SERVER(...) / *CLIENT
Addressee for the changed parameter.
DESTINATION = *SERVER (...)
The parameter is to be changed for the StorMan server.
SAVE =
Specifies whether the StorMan parameter is to be changed permanently.
SAVE = *NO
The StorMan parameter only remains changed until StorMan is started again.
SAVE = *YES
The changed StorMan parameter is saved permanently in the StorMan configuration file and also applies when StorMan is started again.
STORMAN-SERVER =
Specifies the StorMan servers for which the parameter is to be modified.
STORMAN-SERVER = *ALL
The StorMan parameter is modified for all StorMan servers in the OK status.
STORMAN-SERVER = *CONNECTED
The StorMan parameter is modified for the active StorMan server.
STORMAN-SERVER = <integer 1..8>
The StorMan parameter is modified for the StorMan server which has the index in the list defined in the SHC-OSD parameter file.
DESTINATION = *CLIENT
The parameter is only to be changed for the StorMan client.
Examples
/MODIFY-SHC-ENVIRONMENT STORMAN-PARAMETER=*PARAMETERS(NAME=debug,VALUE=3,
DESTINATION=*SERVER(SAVE=*YES))
/MODIFY-SHC-ENVIRONMENT
CONNECTED-STORMAN=*PARAMETERS(HOST-NAME=23.123.123.123)
Command return codes
(SC2) | SC1 | Maincode | Meaning |
0 | CMD0001 | Command executed successfully | |
1 | 0 | NDE2003 | Command successfully executed, no processing necessary |
1 | CMD0202 | Syntax error | |
32 | NDE2002 | Internal error | |
64 | NDE1830 | StorMan server not found | |
64 | NDE1831 | StorMan server could not be connected | |
64 | NDE1832 | StorMan server is already connected | |
64 | NDE1833 | No suitable Storman server found | |
64 | NDE1834 | StorMan server with error | |
64 | NDE1835 | SHC-OSD connected to StorMan server | |
64 | NDE2000 | Execution partially successful | |
64 | NDE2014 | StorMan error in command | |
64 | NDE2016 | Invalid parameter entered in the command | |
64 | CMD0087 | Function not permitted in the current input mode or with the current task privileges | |
64 | CMD0216 | Required privilege not available |