SHOW-SHC-ENVIRONMENT Displays configuration of the external servers

Storage system:	ETERNUS DX/AF
Domain:	DEVICE
Privileges:	TSOS


/SHOW-SHC-ENVIRONMENT provides information on the configuration of the StorMan 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 StorMan 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.

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

Example

/SHOW-SHC-ENVIRONMENT INFORMATION=*ALL 
    
%----------------------------------------------------------------------------
% SHOW-SHC-ENVIRONMENT                      (SHC-OSD VERSION 15.0C00)
%----------------------------------------------------------------------------
% STORMAN(1) SERVER Settings and Status -------------------------------------
%       HOST        = *SE1MU1(test1mu)                                        
%       PORT-NUMBER = 4178                             SSL = *ENABLED        
%       STATUS      = OK                               CONNECTED = *YES      
%       VERSION     = 10.2.0-0                                               
%                                                                            
%--- STORMAN(1) Management Instances:  --------------------------------------
% Instance(1)  IP = 172.17.64.75                                             
%              PORT-NUMBER = 5989            INTERFACE = SMI-S               
%              USER = root                                                   
%              STATUS = OK                                                   
%              VERSION = V06L00-0000                                         
%              VENDOR = FUJITSU                                              
%              MANAGED-STORAGE-SYSTEM(1) = 4652214004                        
%                      STORAGE-STATUS    = OK                                
%----------------------------------------------------------------------------
% STORMAN(2) SERVER Settings and Status -------------------------------------
%       HOST        = *SE1MU2(test2mu)                                        
%       PORT-NUMBER = 4178                             SSL = *ENABLED        
%       STATUS      = OK                               CONNECTED = *NO       
%       VERSION     = 10.2.0-0                                               
%                                                                          
%--- STORMAN(2) Management Instances:  --------------------------------------
% Instance(1)  IP = 172.17.64.192                                            
%              PORT-NUMBER = 5989            INTERFACE = SMI-S               
%              USER = root                                                   
%              STATUS = OK                                                   
%              VERSION = V05L90-4000                                         
%              VENDOR = FUJITSU                                              
%              MANAGED-STORAGE-SYSTEM(1) = 4621637022                        
%                      STORAGE-STATUS    = OK                                
% Instance(2)  IP = 172.17.64.75                                             
%              PORT-NUMBER = 5989            INTERFACE = SMI-S               
%              USER = root                                                   
%              STATUS = OK                                                   
%              VERSION = V06L00-0000                                         
%              VENDOR = FUJITSU                                              
%              MANAGED-STORAGE-SYSTEM(1) = 4652214004                        
%                      STORAGE-STATUS    = OK                                
%---------------------------------------------------------------------------- 

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-DATABASE
NO-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

S variables

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

For INFORMATION=*ALL, the S variables for all StorMan 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 server exists in the SHC-OSD parameter file, no S variables are output for StorMan servers. If StorMan 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. UNKNOWN: the S variables for a (an empty) StorMan server are output.	var(*LIST).SERVER-TYPE	S	STORMAN 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

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