SHOW-SHC-PROCESSING Displays settings of SHC-OSD

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


/SHOW-SHC-PROCESSING displays information on the current maintenance and diagnostic settings of SHC-OSD. You can use the /MODIFY-SHC-PROCESSING command to change these settings (see "MODIFY-SHC-PROCESSING Changes settings of SHC-OSD").

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-PROCESSING

Example

/SHOW-SHC-PROCESSING   

%----------------------------------------------------------------------------
% SHOW-SHC-PROCESSING                       (SHC-OSD VERSION 15.0C00)        
%----------------------------------------------------------------------------
%--- Version Information:           (STORMAN CLIENT VERSION V10.2.0-0       )
%                                                                            
%--- STORMAN SERVER Settings and Status (ETERNUS DX)  -----------------------
%  STORMAN(1) HOST = *SE1MU1                                                 
%      PORT-NUMBER = 4178   VERSION = 10.2.0-0             SSL = *ENABLED    
%      STATUS      = OK                              CONNECTED = *YES        
%  STORMAN(2) HOST = *SE1MU2                                                 
%      PORT-NUMBER = 4178   VERSION = 10.2.0-0             SSL = *ENABLED    
%      STATUS      = OK                              CONNECTED = *NO         
%  STORMAN(3) HOST = stortest-1.osd.abg.fsc.net                              
%      PORT-NUMBER = 4178   VERSION = 10.2.0-0             SSL = *ENABLED    
%      STATUS      = OK                              CONNECTED = *NO         
%                                                                            
%--- Subsystem Settings:  ---------------------------------------------------
%  USER-TASK-PRIO   =  80                                                    
%  FORK-ACTION      = *YES                                                   
%
%--- Monitoring Settings:  --------------------------------------------------
%  STATE-CHANGE-POLLING:
%   SHORT-INTERVAL=         60 s,NORMAL-INTERVAL=        600 s
%   LONG-INTERVAL =       3600 s,SELECT-DEVICES=*ATTACHED
%   LOG-CHANGES   = *MAJOR-EVENTS       ,OPERATOR-ORDERS= *YES
%   POLLING-MODE  = *STD
%   DISCOVER-MODE = *FULL
%   REDISCOVER-TIME     = *UNLIMITED
%  THIN-POOL-MONITORING = *BS2000-VOLUMES
%  FLEX-POOL-MONITORING = *BS2000-VOLUMES
%  STORAGE-CLUSTER-MONITORING = *BS2000-VOLUMES
%
%--- Security Settings:  ----------------------------------------------------
%  SYSTEM-ADMIN-SCOPE
%   DETACHED-DEVICES    = *REJECT
%   NOT-DEFINED-DEVICES = *REJECT
%  TASK-ADMIN-SCOPE
%   DETACHED-DEVICES    = *SYSTEM-ADMIN-SCOPE
%   NOT-DEFINED-DEVICES = *SYSTEM-ADMIN-SCOPE
%  DEVICE-PRESELECT     = *ALL-DEFINED
%
%--- ETERNUS Replication Settings:  -----------------------------------------
%  PRESELECTED-CLONE-TYPE      = COPY
%
%--- Diagnostical Settings:  ------------------------------------------------
%  LOCK-RETRY:
%   WAIT-TIME=          1 s,RETRY-COUNT=         30
%  IO-RETRY:
%   WAIT-TIME=          2 s,RETRY-COUNT=         30
%  SYNCH-WAIT-RETRY:
%   WAIT-TIME=         30 s,RETRY-COUNT=         20
%  COMM-WAIT-RETRY:
%   WAIT-TIME=         40 s,RETRY-COUNT=         60
%  TRACE:
%   EXTENDED-TRACE=*OFF,RELEASE-TRACE-AT-UNLOAD=*NO
%      TRACE-SIZE=         32 kB,   ERROR-TRACE-SIZE=         16 kB
%   TU-TRACE-SIZE=        959 kB,TU-ERROR-TRACE-SIZE=         64 kB
%  LOG-FILE-RETENTION= 10 DAYS
%  SHC-OSD-LOG = *ON  
----------------------------------------------------------------------------

Meaning of the output lines (in alphabetical order)

Keyword                                   

Meaning

Operand value                      

COMM-WAIT-RETRY:
RETRY-COUNT

Retry count for FITC communication of SHC-OSD

<integer 1..100>

COMM-WAIT-RETRY:
WAIT-TIME

Wait time between retries for FITC communication

<integer 10..100>

CONNECTED

Specifies whether the StorMan client is connected to the corresponding server

*YES
*NO

DEVICE-PRESELECT

Default number of units for SHOW output

*ALL-DEFINED
*ANY

FORK-ACTION

Setting specifying whether the SHC-OSD task operates with or without fork

*YES
*NO

IO-RETRY:
RETRY-COUNT

Retry count when an expected state change has not occurred in storage system

<integer 1..100>

IO-RETRY:
WAIT-TIME

Wait time between retries when an expected state change has not occurred in storage system

<integer 1..10>

LOG-FILE-RETENTION

Number of days before an SHC-OSD log file is automatically deleted

<integer 1..999>

LOCK-RETRY:
RETRY-COUNT

Retry count when a lock conflict occurs

<integer 1..100>

LOCK-RETRY:
WAIT-TIME

Wait time between retries when a lock conflict occurs

<integer 1..10>

PORT-NUMBER

Port number of the StorMan server

<char 1..16>

PRESELECTED-CLONE- TYPE

Presettings for the usage of the QuickOPC (COPY) or EC (MIRROR) replication function

COPY
MIRROR

SHC-OSD-LOG

Shows whether SHC-OSD logging entries are written to the current log file /var/shcosd/log in the POSIX file system

*ON

*OFF

SHC-OSD VERSION

Version of SHC-OSD

<char 7..7>

SSL

Specifies whether secure data transfer (SSL) is used
(in SHC-OSD V13.0, only for StorMan server)

*ENABLED
*DISABLED

STATE-CHANGE-POLLING:
DISCOVER-MODE

Restricts the discover operation to one type of storage systems (performance)

*BY-STORMAN


STATE-CHANGE-POLLING:
LOG-CHANGES

All state changes detected are output.
Only global state changes are output

*ALL-EVENTS
*MAJOR-EVENTS

STATE-CHANGE-POLLING:
LONG-INTERVAL

Polling interval for checks at long intervals (i.e. a supported storage system was not found at the last polling)

<integer 360..86400>

STATE-CHANGE-POLLING:
NORMAL-INTERVAL

Polling interval for checks at normal intervals (i.e. no problem occurred at the last polling)

<integer 60..7200>

STATE-CHANGE-POLLING:
OPERATOR-ORDERS

Selected messages are output so that they can be answered.
All messages are output asynchronously

*YES
*NO

STATE-CHANGE-POLLING:
POLLING-MODE

Scope of the periodic check

*NONE
*PING
*SYNC
*STD
*DISCOVER

STATE-CHANGE-POLLING:
REDISCOVER-TIME

No check for rediscovery of a failed storage system
Unlimited check for rediscovery
Check time in hours

*NO
*UNLIMITED
<integer 1..9999>

STATE-CHANGE-POLLING:
SELECT-DEVICES

State changes are output for all generated devices.
State changes are output only for attached devices.

*ALL
*ATTACHED

STATE-CHANGE-POLLING:
SHORT-INTERVAL

Polling interval for checks at short intervals (i.e. a storage system was not accessible at the last polling)

<integer 30..3600>

STATUS (STORMAN)

Status of the StorMan server

OK	StorMan server running
NOT-AVAILABLE
	StorMan server 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
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

STORAGE-CLUSTER-MONITORING

Setting for the administration of storage-clusters

*ON
*OFF
*BS2000-VOLUMES

STORMAN(n) HOST

Host name or IP address of the nth StorMan server. The StorMan servers defined in the SHC-OSD parameter file are output. If no StorMan server is defined, 'STORMAN(1) HOST =  'BLANK'' is output.

''
<char 1..48>

SYNCH-WAIT-RETRY:
RETRY-COUNT

Retry count for queries about synchronous command termination when a lock conflict occurs.

<integer 1..100>

SYNCH-WAIT-RETRY:
WAIT-TIME

Wait time between two queries about synchronous command termination.

<integer 1..120>

SYSTEM-ADMIN-SCOPE:
DETACHED-DEVICES

System-wide security setting for detached devices.

*REJECT
*ACCEPT

SYSTEM-ADMIN-SCOPE:
NOT-DEFINED-DEVICES

System-wide security setting for devices which are not known to BS2000 (devices not generated)

*REJECT
*ACCEPT

TASK-ADMIN-SCOPE:
DETACHED-DEVICES

Task-specific security setting for detached units

*REJECT
*ACCEPT
*SYSTEM-ADMIN-SCOPE

TASK-ADMIN-SCOPE:
NOT-DEFINED-DEVICES

Task-specific setting for units not recognized by BS2000
(devices not generated).

*REJECT
*ACCEPT
*SYSTEM-ADMIN-SCOPE

THIN-POOL-MONITORING

Setting for the administration of thin pools

*ON
*OFF
*BS2000-VOLUMES
*BY-AVOID-FILE

FLEX-POOL-MONITORING

Setting for the administration of flex pools.

*ON
*OFF
*BS2000-VOLUMES
*BY-AVOID-FILE

TRACE:
RELEASE-TRACE-AT- UNLOAD

Trace areas are released when SHC-OSD is unloaded
Trace areas are not released when SHC-OSD is unloaded in order to facilitate diagnostics

*YES
*NO

TRACE:
ERROR-TRACE-SIZE

Size of the error trace area in Kbyte

<integer 1..4096>

TRACE:
EXTENDED-TRACE

Controls the size of the entries in the normal trace of SHC-OSD. When EXT=*ON is specified, additional information is recorded in order to facilitate diagnostics. The initial setting is *OFF

*OFF
*ON

TRACE:
TRACE-SIZE

Size of the trace area in Kbyte

<integer 1..4096>

TRACE:
TU-TRACE-SIZE

Size of the trace area (TU) in Kbyte

<integer 1..4096>

TRACE:
TU-ERROR-TRACE-SIZE

Size of the error trace area (TU) in Kbyte

<integer 1..4096>

USER-TASK-PRIO

Priority of the SHC-OSD user task

<integer 80..255>

VERSION Information

Version of the StorMan client

<char 0..15>

VERSION (STORMAN)

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

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

S variables

Output information

Name of the S variable                   

T

Contents                                  

Maximum number of retries for communication

var(*LIST).COMM-RETRY.LIM

I

<integer 0..100>

Wait time (in seconds) on communication retry

var(*LIST).COMM-RETRY.TIME

I

<integer 10..100>

Default number of units for SHOW information output
*ALL-DEFINED: only units known in BS2000
*ANY: all units

var(*LIST).DEV-PRESELECT

S

*ALL-DEFINED
*ANY

DISCOVER restriction in accordance with the type of storage system

var(*LIST).DISCOVER-MODE

S

*BY-STORMAN

Threshold value monitoring of the flex pools

*ON:	all pools
*OFF:	no pools

*BS2000 volumes: only pools with BS2000 volumes
*BY-AVOID-FILE: only pools which are not contained in the AVOID file

var(*LIST).FLEX-POOL-MONITORING

S

*ON
*OFF
*BS2000-VOLUMES
*BY-AVOID-FILE

Maximum number of retries for input/output

var(*LIST).IO-RETRY.LIM

I

<integer 0..100>

Wait time (in seconds) on input/output retries

var(*LIST).IO-RETRY.TIME

I

<integer 0..120>

Maximum number of retries if lock conflicts occur

var(*LIST).LOCK-RETRY.LIM

I

<integer 0..100>

Wait time (in seconds) on retries caused by lock conflicts

var(*LIST).LOCK-RETRY.TIME

I

<integer 0..10>

Maximum number of days before an SHC-OSD log file is automatically deleted

var(*LIST).LOG-FILE-RETENTION

I

<integer 1..999>

MULTI-SNAP function
*ENABLED: enabled
*DISABLED: disabled

var(*LIST).MULTI-SNAP

S

*ENABLED
*DISABLED

Presettings for the usage of the QuickOPC (COPY) or EC (MIRROR) replication function

var(*LIST).PRESELECTED-CLONE-TYPE

S

COPY
MIRROR

SHC-OSD logging
*ON: switched on
*OFF: switched off

var(*LIST).SHC-OSD-LOG

S

*ON
*OFF

Logging of state changes.
*ALL-EVENTS: all events
*MAJOR-EVENTS: Global events only

var(*LIST).STA-CHA-POLLING.LOG-CHA

S

*ALL-EVENTS
*MAJOR-EVENTS

Polling of state changes:
Long interval in seconds

var(*LIST).STA-CHA-POLLING.LONG-INTERVAL

I

<integer 360..86400>

Polling of state changes:
Normal interval in seconds

var(*LIST).STA-CHA-POLLING.NORMAL-INTERVAL

I

<integer 60..7200>

Polling of state changes:
Output of operator orders

var(*LIST).STA-CHA-POLLING.OPERATOR-ORDER

S

*YES
*NO

Scope of polling of status changes:
*NONE: no check
*PING: failure of the storage system
*SYNC: failure and status of the storage system
*STD: failure and status of the storage system and device status
*DISCOVER: complete discover

var(*LIST).STA-CHA-POLLING.POLLING-MODE

S

*NONE
*PING
*SYNC
*STD
*DISCOVER

Polling of state changes:
Recognition time (in hours) for a failed storage system

var(*LIST).STA-CHA-POLLING.REDISCOVER-TIME

I

*NO
*UNLIMITED
<integer 1..9999>

Logging of state changes: Units.
*ATTACH: for attached units only
*ALL: for all units

var(*LIST).STA-CHA-POLLING.SEL-DEV

S

*ATTACH
*ALL

Polling of state changes:
Short interval in seconds

var(*LIST).STA-CHA-POLLING.SHORT-INTERVAL

I

<integer 30..3600>

Polling of state changes:
Threshold value for the occupancy level of the save pool

var(*LIST).STA-CHA-POLLING.SNAP-SAVE-POOL-SAT

I

<integer 1..100>

Polling of state changes:
Threshold value for the occupancy level of the thin device

var(*LIST).STA-CHA-POLLING.THIN-DEVICE-SAT

I

<integer 1..100>

Polling of state changes:
Threshold value for the occupancy level of the thin pool

var(*LIST).STA-CHA-POLLING.THIN-POOL-SAT

I

<integer 1..100>

Monitoring of the storage cluster
*ON: All clusters
*OFF: No clusters
*BS2000-VOLUMES: Just clusters with BS2000-Volumes

var(*LIST).STOR-CLU-MONITORING

S

*ON
*OFF
*BS2000-VOLUMES

Version number of the StorMan client

var(*LIST).STORMAN-CLIENT-VERS

S

NOT-AVAILABLE
<c-string 1..16>

Index of the connected StorMan server in the order of the server details in the SHC-OSD parameter file

var(*LIST).STORMAN-CONN-INDEX

I

<integer 1..8>

Specifies whether the nth StorMan server is connected (n=1..8)
*YES or *NO

var(*LIST).STORMAN(*LIST).CONNECTED

S

*YES
*NO

Host name or IP address of the nth StorMan server (n=1..8)

var(*LIST).STORMAN(*LIST).HOST

S

"
<c-string 1..48>

Port number of the nth StorMan server (n=1..8)

var(*LIST).STORMAN(*LIST).PORT-NUMBER

S

"
<c-string 1..16>

Specifies whether the nthStorMan server uses secure data transfer (SSL) (n=1..8)
*ENABLED: SSL is used
*DISABLED: SSL is not used

var(*LIST).STORMAN(*LIST).SSL

S

"

*ENABLED
*DISABLED

Status of the nth StorMan server (n=1..8)
OK: the StorMan server is running
NOT-AVAILABLE: StorMan 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
DISABLED-BY-COMMAND: the /MODIFY-SHC-ENVIRONMENT command does not result in StorMan usage
NOT-YET-INITIALIZED: StorMan client not initialized
ERROR: self-explanatory
VERSION-NOT-SUPPORTED: Version not supported

var(*LIST).STORMAN(*LIST).STATUS

S

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

Version of StorMan on the nth StorMan server (n=1..8)

var(*LIST).STORMAN(*LIST).VERSION

S

<c-string 1..16>
*NOT-AVAILABLE

Version number of the SYMAPI client (no longer supported)

var(*LIST).SYMAPI-CLIENT-VERS

S

<c-string 1..16>

SYMAPI-DEBUG trace (no longer supported)
*ON: switched on
*OFF: switched off

var(*LIST).SYMAPI-DEBUG

S

*ON
*OFF

SYMAPI logging (no longer supported)
*ON: switched on
*OFF: switched off

var(*LIST).SYMAPI-LOG

S

*ON
*OFF

Specifies whether the nth SYMAPI server is connected (n=1..4) (no longer supported)
*YES or *NO

var(*LIST).SYMAPI(*LIST).CONNECTED

S

*YES
*NO

Host name or IP address of the nth SYMAPI server (n=1..4) (no longer supported)

var(*LIST).SYMAPI(*LIST).HOST

S

"

<c-string 1..32>

Port number of the nth management instance (n=1..4) (no longer supported)

var(*LIST).SYMAPI(*LIST).PORT-NUMBER

S

"

<c-string 1..16>

Status of the nth SYMAPI server (n=1..4) (no longer supported)
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
DISABLED-BY-COMMAND: the /MODIFY-SHC-ENVIRONMENT command does not result in SYMAPI usage
NOT-YET-INITIALIZED: Not initialized
ERROR: self-explanatory
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(*LIST).STATUS

S

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

Version of SYMAPI on the nth SYMAPI server (n=1..4) (no longer supported)

var(*LIST).SYMAPI(*LIST).VERSION

S

<c-string 1..16>
NOT-AVAILABLE
VERSION-NOT-SUPP

Maximum number of retries to check synchronization

var(*LIST).SYNCH-RETRY.LIM

I

<integer 0..100>

Wait time (in seconds) on retries to check synchronization

var(*LIST).SYNCH-RETRY.TIME

I

<integer 0..120>

Global security setting for detached units
*REJECT: process rejected
*ACCEPT: process accepted

var(*LIST).SYS-ADM-SCOPE.PROCESS-DET-DEV

S

*REJECT
*ACCEPT

Global security setting for units not known in BS2000
*REJECT: process rejected
*ACCEPT: process accepted

var(*LIST).SYS-ADM-SCOPE.PROCESS-UNDEF-DEV

S

*REJECT
*ACCEPT

Task-specific security setting for detached units
*SYS-ADM-SCOPE: global setting is valid locally
*REJECT: process rejected
*ACCEPT: process accepted

var(*LIST).TASK-ADM-SCOPE.PROCESS-DET-DEV

S

*SYS-ADM-SCOPE
*REJECT
*ACCEPT

Task-specific security setting for units not known in BS2000
*SYS-ADM-SCOPE: global setting is valid locally
*REJECT: process rejected
*ACCEPT: process accepted

var(*LIST).TASK-ADM-SCOPE.PROCESS-UNDEF-DEV

S

*SYS-ADM-SCOPE
*REJECT
*ACCEPT

Threshold value monitoring of the thin pools

*ON:	all pools
*OFF:	no pools

*BS2000 volumes: only pools with BS2000 volumes
*BY-AVOID-FILE: only pools which are not contained in the AVOID file

var(*LIST).THIN-POOL-MONITORING

S

*ON
*OFF
*BS2000-VOLUMES
*BY-AVOID-FILE

Size of error trace

var(*LIST).TRACE.ERROR-SIZE

I

<integer 0..4096>

Extended trace
*ON: switched on
*OFF: switched off

var(*LIST).TRACE.EXT

S

*ON
*OFF

Release of trace on unloading subsystem
*YES or *NO

var(*LIST).TRACE.REL-AT-UNLOAD

S

*YES
*NO

Size of trace

var(*LIST).TRACE.SIZE

I

<integer 0..4096>

Unique HOST-ID assigned by SYMACL

var(*LIST).UNIQUE-HOST-ID

S

<c-string 1..32>

Priority of the SHC-OSD user task

var(*LIST).USER-TASK-PRIO

<integer 80..255>

Version number of the SHC-OSD subsystem

var(*LIST).VERSION

S

<c-string 7..7>

Command return codes

(SC2)	SC1	Maincode	Meaning
	0	CMD0001	Command executed successfully
	32	NDE2002	Internal error
	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