SHC-OSD V14.0 (en)

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

/SHOW-SHC-ENVIRONMENT provides information on the configuration of the StorMan and SYMAPI servers and on the status and the valid settings of the management instances used by StorMan and their access data. The storage systems managed by the management instances are also displayed. This provides you with a detailed display of the StorMan environment which complements the /SHOW-SHC-PROCESSING command.

The information on the management instances which is displayed shows the settings and statuses which currently apply. It is determined dynamically by StorMan.

The command supports structured output to S variables (for further information, see the manual “Commands” [1]).

SHOW-SHC-ENVIRONMENT

INFORMATION = *STD / *ALL

INFORMATION =
Determines the scope of the information which is output.
A header line is output followed by lines for each StorMan and SYMAPI server with the corresponding values for each unit, see the example on the next page.

INFORMATION = *STD
Information is output about the active StorMan server with its management instances and the active SYMAPI server.

INFORMATION = *ALL
Information is output about all StorMan servers defined in the SHC-OSD parameter file with their management instance and all defined SYMAPI servers.

Example

/SHOW-SHC-ENVIRONMENT INFORMATION=*ALL 

%----------------------------------------------------------------------------
% SHOW-SHC-ENVIRONMENT                      (SHC-OSD VERSION 14.0A00)
%----------------------------------------------------------------------------
% STORMAN(1) SERVER Settings and Status -------------------------------------
%       HOST        = MCHXX.1
%       PORT-NUMBER = 4178                             SSL = *ENABLED
%       STATUS      = OK                               CONNECTED = *YES
%       VERSION     = 9.0.0-0
%
%--- STORMAN(1) Management Instances:  --------------------------------------
% Instance(1)  IP = 172.11.22.11
%              PORT-NUMBER = 5988            INTERFACE = SMI-S
%              USER = root
%              STATUS = OK
%              VERSION = V05L60-1000
%              VENDOR = FUJITSU
%              MANAGED-STORAGE-SYSTEM(1) = 4531125002
%                      STORAGE-STATUS    = OK
% Instance(2)  IP = 172.11.22.22
%              PORT-NUMBER = 5988            INTERFACE = SMI-S
%              USER = root
%              STATUS = OK
%              VERSION = V05L86-4000
%              VENDOR = FUJITSU
%              MANAGED-STORAGE-SYSTEM(1) = 4531107011
%                      STORAGE-STATUS    = OK
%----------------------------------------------------------------------------
% STORMAN(2) SERVER Settings and Status -------------------------------------
%       HOST        = *MU1
%       PORT-NUMBER = 4178                             SSL = *ENABLED
%       STATUS      = NOT-AVAILABLE                    CONNECTED = *NO
%       VERSION     = NOT-AVAILABLE
%----------------------------------------------------------------------------
% SYMAPI (1) SERVER Settings and Status -------------------------------------
%       HOST        = 172.11.22.33
%       PORT-NUMBER = 2707
%       STATUS      = OK                               CONNECTED = *YES
%       VERSION     = V9.0-2504/0.0
%----------------------------------------------------------------------------
% SYMAPI (2) SERVER Settings and Status -------------------------------------
%       HOST        = 172.11.22.44
%       PORT-NUMBER = 2707
%       STATUS      = NOT-YET-INITIALIZED              CONNECTED = *NO
%       VERSION     = NOT-AVAILABLE
%----------------------------------------------------------------------------

Meaning of the output lines (in the order of their occurrence)

Keyword

Meaning

Value

SHC-OSD VERSION

Version of SHC-OSD

<char 7..7>

STORMAN(m) SERVER
Settings and Status

Settings and status of the mth (m=1...8) StorMan server. The StorMan servers are output in the order they are defined in the SHC-OSD parameter file.

HOST

Host name or IP address of the StorMan server.
For SE servers, *MU1(<MU-name>) or *MU2(<MU-name>) can also be output.
If no StorMan server is defined, 'HOST= 'BLANK''is output for the first StorMan server.

'' <char 1..48>

PORT-NUMBER

Port number of the StorMan server. If no StorMan server is defined, 'PORT-NUMBER= UNDEFINED' is output for the first StorMan server.

UNDEFINED <char 1..16>

SSL

Use of secure data transfer with SSL

`*ENABLED`	SSL is used.
`*DISABLED`	SSL is not used.

*ENABLED *DISABLED

STATUS

Status of the StorMan server

`OK`	StorMan server running.
`NOT-AVAILABLE`	StorMan server is not available.
`NO-DATABASE`	StorMan server’s repository is not available.
`NO-MGMT-INSTANCE`	No management instance (SMI-S Provider) is entered in the StorMan repository.
`DISABLED-BY-SYSPAR`
	No StorMan support is requested in the SYSPAR file with `DISCOVER-MODE =` `*BY-SYMAPI.`
`ERROR`	An error occurred.
`VERSION-NOT-SUPPORTED`
	Version not supported
`NOT-YET-INITIALIZED`
	Not yet initialized.
`DISABLED-BY-COMMAND`
	The use of all StorMan servers was terminated with `/MODIFY-SHC-` `ENVIRONMENT.`

OK NOT-AVAILABLE
NO-DATABASENO-MGMT-INSTANCE DISABLED-BY- SYSPAR ERROR VERSION-NOT- SUPPORTED NOT-YET-INITIALIZED DISABLED-BY-COMMAND

CONNECTED

Specifies whether the StorMan server is active

*YES *NO

VERSION

Version of the StorMan server (remains empty in the DISABLED-BY-COMMAND status).

'' <char 1..16> NOT-AVAILABLE

STORMAN (m)

Management instances

Management instance settings of the mth StorMan server

Instance(n)

IP

Name or IP address of the nth management instance for the corresponding StorMan server

<char 1..48>

PORT-NUMBER

Port number of the nth management instance

<char 1..8>

INTERFACE

Interface type

SMI-S

UNKNOWN

USER

User ID on the nth management instance

<char 1..32>

STATUS

Status of the nth management instance.

`OK`	StorMan server running.
`NOT-AVAILABLE`
	Management instance not available.
`AUTHORIZATION-FAILED`
	User ID or password of management instance incorrect
`ERROR`	An error occurred.

OK
NOT-AVAILABLE AUTHORIZATION-FAILED ERROR

VERSION

Version of the nth management instance

UNKNOWN <char 1..16>

VENDOR

Manufacturer of the nth management instance

<char 1..16>

MANAGED-STORAGE-SYSTEM(o)

Serial number of the oth storage system which is managed by the corresponding management instance

<char 1..16>

STORAGE-STATUS

Status of the storage system.

`OK`	Storage system being managed
`NOT-AVAILABLE`	Storage system not available
`ERROR`	An error occurred.

OK NOT-AVAILABLE ERROR

SYMAPI(p) SERVER Settings and Status

Settings and status of the pth (p=1...4) SYMAPI server.
The SYMAPI servers are output in the order they are defined in the SHC-OSD parameter file.

HOST

Host name or IP address of the SYMAPI server.
If no SYMAPI server is defined, 'HOST= 'BLANK''is output for the first SYMAPI server.

'' <char 1..48>

PORT-NUMBER

Port number which the SYMAPI client uses.
If no SYMAPI server is defined, 'PORT-NUMBER= UNDEFINED'is output for the first SYMAPI server.

UNDEFINED <char 1..16>

STATUS

Status of the SYMAPI server.

`OK`	SYMAPI server running.
`NOT-AVAILABLE`
	SYMAPI server is not available.
`DISABLED-BY-SYSPAR`
	No SYMAPI support is requested in the SYSPAR file with `DISCOVER-MODE =` `*BY-SYMAPI.`
`ERROR`	An error occurred.
`VERSION-NOT-SUPPORTED`
	Version not supported
`NOT-YET-INITIALIZED`
	Not yet initialized.
`DISABLED-BY-COMMAND`
	The use of all SYMAPI servers was terminated with `/MODIFY-SHC-` `ENVIRONMENT.`
`DISCONNECTED LICENSE-CHECK`
	The SYMAPI client is not connected. Versions of SYMAPI server and client do not match.
`SECURITY-LEVEL-MISMATCH`
	Security setting NONSECURE missing on SYMAPI server.

OK NOT-AVAILABLE DISABLED-BY-SYSPAR ERROR VERSION-NOT-SUPPORTED
NOT-YET-INITIALIZED DISABLED-BY- COMMAND DISCONNECTED LICENSE-CHECK
SECURITY-LEVEL-MISMATCH

CONNECTED

Specifies whether the SYMAPI server is active

*YES *NO

VERSION

Version of the SYMAPI server

`NOT-AVAILABLE`
	SYMAPI server is not available.
`VERSION-NOT-SUPP`
	Version not supported

<char 1..16> NOT-AVAILABLE VERSION-NOT-SUPP

S variables

For INFORMATION=*STD, the S variables are output only for the active StorMan server with its management instances and the SYMAPI servers.

For INFORMATION=*ALL, the S variables for all StorMan and SYMAPI servers are output in the order in which they are defined in the SHC-OSD parameter file. When management instances are defined for one of the StorMan servers, the relevant Svariables for the management instances are also output.

If no definition for a StorMan or SYMAPI server exists in the SHC-OSD parameter file, no S variables are output for StorMan or SYMAPI servers. If neither StorMan nor SYMAPI servers are defined, the S variables for a (an empty) StorMan server are output.

Output information	Name of the S variable	T	Contents
Status of the management instance OK: the management instance is running NOT-AVAILABLE: the management instance is not running AUTHORIZATION-FAILED: user ID or password of management instance incorrect ERROR: self-explanatory	var(LIST).MGMT-INSTANCE(LIST).STA var(LIST).CIMOM(LIST).STA	S	OK NOT-AVAILABLE AUTHORIZATION-FAILED ERROR
The following S variables var(LIST).MGMT-INSTANCE(LIST).STORAGE-SYSTEMn and var(LIST).MGMT-INSTANCE(LIST).STORAGE-STAn exist n times (n=1..8) per management instance
Status of the nth managed storage system OK: storage system being managed NOT-AVAILABLE: storage system not available ERROR: self-explanatory	var(LIST).MGMT-INSTANCE(LIST).STORAGE-STAn var(LIST).CIMOM(LIST).STORAGE-STAn	S	'' OK NOT-AVAILABLE ERROR
Serial number of the nth managed storage system	var(LIST).MGMT-INSTANCE(LIST).STORAGE-SYSTEMn var(LIST).CIMOM(LIST).STORAGE-SYSTEMn	S	'' <c-string 1..16>
Manufacturer of the management instance	var(LIST).MGMT-INSTANCE(LIST).VENDOR	S	'' <c-string 1..16>
Version of the management instance	var(LIST).MGMT-INSTANCE(LIST).VERSION var(LIST).CIMOM(LIST).VERSION	S	'' <c-string 1..16>
Name or IP address of the management instance (up to 99 management instances are possible)	var(LIST).MGMT-INSTANCE(LIST).IP var(LIST).CIMOM(LIST).HOST	S	'' <c-string 1..48>
Port number of the management instance	var(LIST).MGMT-INSTANCE(LIST).PORT-NO var(LIST).CIMOM(LIST).PORT-NO	S	'' <c-string 1..16>
Interface of the management instance	var(LIST).MGMT-INSTANCE(LIST).INTERFACE	S	`SMI-S` `UNKNOWN`
User ID of the management instance	var(LIST).MGMT-INSTANCE(LIST).USER-ID var(LIST).CIMOM(LIST).USER-ID	S	'' <c-string 1..32>
Server type STORMAN: the S variables for a StorMan server are output. SYMAPI: the S variables for a SYMAPI server are output. UNKNOWN: the S variables for a (an empty) StorMan server are output.	var(*LIST).SERVER-TYPE	S	STORMAN SYMAPI UNKNOWN
Version number of SHC-OSD	var(*LIST).SHC-OSD-VERSION	S	<c-string 1..16>
Is the StorMan server active?	var(*LIST).STORMAN-CONNECT	S	YES NO
Host name or IP address of the StorMan server (only with SERVER-TYPE=STORMAN/UNKNOWN)	var(*LIST).STORMAN-HOST	S	'' <c-string 1..48>
Port number of the StorMan server	var(*LIST).STORMAN-PORT-NO	S	'' <c-string 1..16>
Use of secure data transfer ENABLED: SSL is used DISABLED: SSL is not used	var(*LIST).STORMAN-SSL	S	ENABLED DISABLED
Status of the StorMan server OK: the StorMan server is running NOT-AVAILABLE: torMan server not available NO-DATABASE: repository of StorMan server not available NO-MGMT-INSTANCE: no management instance (SMI-S Provider) entered in the StorMan repository DISABLED-BY-SYSPAR: the DISCOVER-MODE=BY-SYMAPI parameter does not result in StorMan usage ERROR: self-explanatory VERSION-NOT-SUPPORTED: StorMan version not supported NOT-YET-INITIALIZED: StorMan not yet initialized DISABLED-BY-COMMAND: The use of all StorMan servers was terminated with `/MODIFY-SHC-ENVIRONMENT`.	var(*LIST).STORMAN-STA	S	OK NOT-AVAILABLE NO-DATABASE NO-MGMT-INSTANCE DISABLED-BY-SYSPAR ERROR VERSION-NOT-SUPPORTED NOT-YET-INITIALIZED DISABLED-BY-COMMAND
Version name of the StorMan server (remains empty in the `DISABLED-BY-COMMAND` status) NOT-AVAILABLE: the StorMan server is not available	var(*LIST).STORMAN-VERSION	S	'' <c-string 1..16> NOT-AVAILABLE
Is the SYMAPI server active?	var(*LIST).SYMAPI-CONNECT	S	YES NO
Host name or IP address of the SYMAPI server (for SERVER-TYPE=SYMAPI only)	var(*LIST).SYMAPI-HOST	S	'' <c-string 1..48>
Port number of the SYMAPI server	var(*LIST).SYMAPI-PORT-NO	S	'' <c-string 1..16>
Use of secure data transfer ENABLED: SSL is used (not in SHC-OSD V13.0) DISABLED: SSL is not used	var(*LIST).SYMAPI-SSL	S	ENABLED DISABLED
Status of the SYMAPI server. OK: the SYMAPI server is running NOT-AVAILABLE: SYMAPI server not available DISABLED-BY-SYSPAR: the DISCOVER-MODE=BY-STORMAN parameter does not result in SYMAPI usage ERROR: self-explanatory VERSION-NOT-SUPPORTED: SYMAPI version not supported NOT-YET-INITIALIZED: SYMAPI not yet initialized DISABLED-BY-COMMAND: The use of all SYMAPI servers was terminated with `/MODIFY-SHC-ENVIRONMENT`. DISCONNECTED: SYMAPI client not connected LICENSE-CHECK: Versions of SYMAPI server and client do not match SECURITY-LEVEL-MISMATCH Security setting NONSECURE missing on SYMAPI server	var(*LIST).SYMAPI-STA	S	OK NOT-AVAILABLE DISABLED-BY-SYSPAR ERROR VERSION-NOT-SUPPORTED NOT-YET-INITIALIZED DISABLED-BY-COMMAND DISCONNECTED LICENSE-CHECK SECURITY-LEVEL-MISMATCH
Version of the SYMAPI server NOT-AVAILABLE: SYMAPI server not available VERSION-NOT-SUPP: Version not supported	var(*LIST).SYMAPI-VERSION	S	<c-string 1..16> NOT-AVAILABLE VERSION-NOT-SUPP

Command return codes

(SC2)	SC1	Maincode	Meaning
	0	CMD0001	Command executed successfully
	1	CMD0202	Syntax error
	32	NDE2002	Internal error
	64	NDE2014	StorMan 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
	130	NDE1082	Memory bottleneck during processing of command

Your Browser is not longer supported

Please use Google Chrome, Mozilla Firefox or Microsoft Edge to view the page correctly

SHOW-SHC-ENVIRONMENT Displays configuration of the external servers

Example

Meaning of the output lines (in the order of their occurrence)

S variables

Command return codes