Controlling Cci Activity; Horcmstart Command; Table 4.35 Horcmstart Command Parameters - Hitachi TAGMASTORE MK-90RD011-25 User Manual

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
Command Name
Format
Options
Value
horcmstart
horcmstart.sh { inst ... }
(UNIX systems)
horcmstart.exe { inst ... } (Windows systems)
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.
Hitachi Command Control Interface (CCI) User and Reference Guide 261