beautypg.com

13 controlling cci activity, 1 horcmstart command – Hitachi TAGMASTORE MK-90RD011-25 User Manual

Page 279

background image

Hitachi Command Control Interface (CCI) User and Reference Guide

261

4.13 Controlling CCI Activity

4.13.1 Horcmstart Command

The horcmstart command is a shell script that starts the HORCM application (/etc/horcmgr).
This shell script also sets the environment variables for HORCM as needed (e.g.,
HORCM_CONF, HORCM_LOG, HORCM_LOGS). Table 4.35 lists and describes the horcmstart
command parameters.

Table 4.35 Horcmstart Command Parameters

Parameter Value

Command Name

horcmstart

Format horcmstart.sh

{ inst ... } (UNIX systems)

horcmstart.exe

{ inst ... } (Windows systems)

Options

Inst: Specifies the HORCM instance number (numerical value). When this option is specified, the

horcmstart shell script sets the environment variables (HORCMINST, HORCM_CONF, HORCM_LOG,

HORCM_LOGS) which correspond to the instance number, and starts the specified HORCM instance.

(Environment variables set by the user become invalid.) When this option is not specified, the horcmstart

shell script starts 1 HORCM and uses the environment variables set by the user. If you have designated full

environment variables, you should use horcmstart.sh without any arguments. If you did not designate

environment variables (HORCM_CONF, HORCM_LOG, HORCM_LOGS), then this shell script sets the

environment variables as follows:
For UNIX-based platforms:

If HORCMINST is specified:

HORCM_CONF = /etc/horcm*.conf (* is instance number)

HORCM_LOG = /HORCM/log*/curlog

HORCM_LOGS = /HORCM/log*/tmplog
If no HORCMINST is specified:

HORCM_CONF = /etc/horcm.conf

HORCM_LOG = /HORCM/log/curlog

HORCM_LOGS = /HORCM/log/tmplog
For Windows

platform:

If HORCMINST is specified:

HORCM_CONF = \WINNT\horcm*.conf (* is instance number)

HORCM_LOG = \HORCM\log*\curlog

HORCM_LOGS = \HORCM\log*\tmplog
If no HORCMINST is specified:

HORCM_CONF = \WINNT\horcm.conf

HORCM_LOG = \HORCM\log\curlog

HORCM_LOGS = \HORCM\log\tmplog
[environmental variable]

The HORCM_LOGS environment variable is used to specify the log file directory for automatic storing.

When HORCM starts up, the log files created in the operation are stored automatically in the

HORCM_LOGS directory. This log directory must give an equality class with HORCM_LOG
HORCMSTART_WAIT (for waiting the RM instance with start-up). Horcmgr does fork/exec() horcmd_XX

as deamon process, and verifies/waits until HORCM become ready state. The timeout is used for only

avoiding infinite loop, currently the default time is 200 sec in consideration of maximum LDEV.

However, it may be needed to change the default timeout value for starting HORCM under high-loading of

the server, or the remote command device. In such a case, this environmental variable is used to change a

timeout value (in units of Sec) from the current default value (200 sec), this value must be specified more

than 5 seconds and multiple of 5 seconds. For Example setting 500 sec:

HORCMSTART_WAIT=500
Export HORCMSTART_WAIT

For OpenVMS

®

platform: OpenVMS needs to make the Detached LOGINOUT.EXE Process as a JOB in

the background by using the ‘RUN /DETACHED’ command. Refer to item (4) in section 3.5.1 for details.