MODIFY-SHC-ENVIRONMENT Modify configuration of the external servers

Storage system:	ETERNUS DX/AF, Symmetrix/VMAX3
Domain:	DEVICE
Privileges:	TSOS


/MODIFY-SHC-ENVIRONMENT manages the settings for operating SHC-OSD with SYMAPI and for operating StorMan. The valid settings are displayed with /SHOW-SHC-ENVIRONMENT and are described in the example for this command, see "SHOW-SHC-ENVIRONMENT Displays configuration of the external servers".

The CONNECTED-SYMAPI operand enables the SYMAPI server to be switched over. In this case the connected SYMAPI server is disabled and another SYMAPI server defined in the SHC-OSD parameter file is connected.

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 (ETERNUS DX/AF)".

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(...)
	*PARAMETERS(...)
		|	HOST-NAME = *FIRST-AVAILABLE / *DISABLE-ALL / *MU1 / *MU2 /
		|					<c-string 1..48 with-low> / <posix-filename 1..48>
		|	,WAIT = *NO / *UNTIL-UPDATED
,CONNECTED-SYMAPI = *UNCHANGED / *PARAMETERS(...)
	*PARAMETERS(...)
		|	HOST-NAME = *FIRST-AVAILABLE / *DISABLE-ALL /
		|					<c-string 1..48 with-low> / <posix-filename 1..48>
,STORMAN-PARAMETER = *UNCHANGED / *PARAMETERS(...)
	*PARAMETERS(...)
		|	NAME = <c-string 1..32 with-low> / <posix-filename 1..32>
		|	,VALUE = <c-string 1..32 with-low> / <posix-filename 1..32>
		|	,DESTINATION = *SERVER (...) / *CLIENT
		|		*SERVER(...)
		|			|	SAVE = *NO / *YES
		|			|	, STORMAN-SERVER = *ALL / *CONNECTED / <integer 1..8>

CONNECTED-STORMAN = *UNCHANGED / *PARAMETERS(...)
Only relevant for ETERNUS DX/AF.
Modifies the connected StorMan server.

HOSTNAME =
Specifies the StorMan server to be used.

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 = *DISABLE-ALL
Disables the connected StorMan server. Following this the storage systems can no longer be managed.

HOST-NAME = *MU1
Only for SE servers.
Disables the connected StorMan server and then connects the StorMan server on the first available MU of the SE server.

HOST-NAME = *MU2
Only for SE servers.
Disables the connected StorMan server and then connects the StorMan server on another available MU of the SE server (if one exists).

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).

CONNECTED-SYMAPI = *UNCHANGED / *PARAMETERS(...)
Only relevant for Symmetrix/VMAX3.
Modifies the connected SYMAPI server.

HOSTNAME =
Specifies the SYMAPI server to be used.

HOST-NAME = *FIRST-AVAILABLE
Disables the connected SYMAPI server and then connects the first SYMAPI server in the OK status from the list defined in the SHC-OSD parameter file.

HOST-NAME = *DISABLE-ALL
Disables the connected SYMAPI server. Following this the storage systems can no longer be managed.

HOST-NAME = <c-string 1..48 with-low> / <posix-filename 1..48>
Name or IP address (IPv4) of the SYMAPI server. The SYMAPI server to be connected must be entered in the SHC-OSD parameter file and be in the OK status.

STORMAN-PARAMETER = *UNCHANGED / *PARAMETERS(...)
Only relevant for ETERNUS DX/AF.
Changes the StorMan parameters.
These settings only need to be changed for diagnosing problems. 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	NDE1730	SYMAPI server not found
	64	NDE1731	SYMAPI server could not be connected
	64	NDE1732	SYMAPI server is already connected
	64	NDE1733	No suitable SYMAPI server found
	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	NDE1892	SMI-S Provider added, but management instance not started or not yet found
	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