jcohctest

Function

This command tests the health check definition file (jcohc.conf) that is used by the health check function of JP1/IM - Manager to determine whether the specified definitions will execute correctly. You can test the notification command on the basis of the health check definition file.

The jcohctest command can be executed only when JP1/IM - Manager is running.

If you have made changes to the health check definition file (jcohc.conf), you cannot execute the jcohctest command unless you have first applied the new settings in the health check definition file by means of a method such as executing the jco_spmd_reload command.

During testing by the jcohctest command, the variables specified in the health check definition file (HCHOST, HCFUNC, HCPNAME, HCPID, HCDATE, and HCTIME) are displayed as shown below.

Table 1‒35: Values displayed during execution of the jcohctest command

Variable name	Value displayed during execution of the jcohctest command
HCHOST	Physical host name or logical host name specified in the -h option
HCFUNC	evflow
HCPNAME	evflow
HCPID	Process ID of evflow
HCDATE	Notification command execution date (YYYY/MM/DD)
HCTIME	Notification command execution time (hh:mm:ss)

For details about the health check definition file (jcohc.conf), see Health check definition file (jcohc.conf) in Chapter 2. Definition Files.

To Page Top

Format

jcohctest [-h logical-host-name]

To Page Top

Execution permission

In Windows: Administrator permissions (if the Windows UAC feature is enabled, the command is executed from the administrator console)

In UNIX: Superuser permissions

To Page Top

Storage directory

In Windows:

Console-path\bin\

In UNIX:

/opt/jp1cons/bin/

To Page Top

Arguments

-h logical-host-name

When you are operating in a cluster system, this option specifies the logical host name. The command tests the notification command that is set in the health check definition file for the specified logical host. If this option is omitted, the logical host name specified in the JP1_HOSTNAME environment variable is assumed. If the JP1_HOSTNAME environment variable is not specified, the physical host name is assumed. If you are not using a cluster system, specification of this option is not needed.

To Page Top

Return values

0	Normal termination
1	Argument error
2	Logical host does not exist
3	Notification command execution failure
7	Execution permission error (Windows only)
10	Other error

To Page Top