Job Management Partner 1/Base User's Guide

jbs_log.bat (Windows only)

Function

The jbs_log.bat command is a tool for collecting data if an error occurs in JP1/Base. The command collects data such as JP1/Base maintenance information, system information output by the OS, and integrated trace logs.

This tool is a batch file. It cannot be customized.

Executing this tool creates a jp1default folder in the specified data folder. If you specify the -h option, in addition to the jp1default folder, a folder with the name of the logical host is created. Two further folders, base_1st and base_2nd are created in each of these folders, and the data collected by jbs_log.bat is copied under them. If necessary, you can compress the collected data by using an archiving tool. The following table shows the folder organization and the files stored in each directory.

Command folder	Collected data
data-folder\jp1_default\base_1st\conf\	Settings and definition files
data-folder\jp1_default\base_1st\log\	Log file
data-folder\jp1_default\base_1st\allusers\jp1_default\JP1Base\log	Log file
data-folder\jp1_default\base_1st\allusers\logical-host-name\JP1Base\log	Log file
data-folder\jp1_default\base_1st\sys\	OS system information
data-folder\jp1_default\base_1st\sys\tmp\event\	Event server settings
data-folder\jp1_default\base_1st\sys\OPI	Information on the operation of services
data-folder\jp1_default\base_1st\default\	Common definition information
data-folder\jp1_default\base_1st\plugin\conf\	Plug-in service settings file
data-folder\jp1_default\base_1st\spool\	Integrated trace logs
data-folder\jp1_default\base_2nd\log\Command\	Command execution log files
data-folder\jp1_default\base_2nd\sys\	Event database
data-folder\logical-host-name\base_1st\conf\	Settings and definition files for the logical host (if applicable)
data-folder\logical-host-name\base_1st\log\	Log data for the logical host (if applicable)
data-folder\logical-host-name\base_1st\event\	Event server settings for the logical host (if applicable)
data-folder\logical-host-name\base_1st\sys\OPI	Information on the operation of services for the logical host
data-folder\logical-host-name\base_2nd\sys\	Command execution log files for the logical host (if applicable)
data-folder\logical-host-name\base_2nd\event\	Event database for the logical host (if applicable)

For details on the types of data that you can collect with this tool, see 16.3 Data that must be collected when an error occurs.

Format

jbs_log.bat [-h logical-host-name]
              [data-folder]
              [-r]
              [-t]
              [-u]
              [-p]
              [-q]

Required execution permission

None. (If User Account Control (UAC) for Windows is enabled, you must execute the command from the administrator console.)

Command directory

installation-folder\tools\

Arguments

-h logical-host-name

Specify the logical host if you are using JP1/Base in a cluster system. When this option is specified, the command collects information about the physical hosts and logical host. If you omit this option, the command collects information about the physical hosts only. There is no need to specify this argument unless you are running a cluster system.

This command does not use the logical host name set in the environment variable JP1_HOSTNAME. You must therefore specify the logical host name in this option if you are using JP1/Base in a cluster system.

data-folder

Specify the folder name by full path or by relative path from the current directory in which you are executing the command. If the path contains a space, enclose the space in double quotation marks (").

If you specify a non-existing folder, a new folder will be created with that name.

If the specified folder already exists, it will be deleted and recreated. Do not specify the name of a folder containing files you want to keep.

If you omit this option, the jp1log folder under the folder specified in the environment variable TEMP is assumed. As the TEMP setting differs according to the OS and user, check the setting by clicking System in the Control Panel.

-r

Specify this option if you do not want to collect command execution logs (ISAM).

-t

Specify this option if you do not want to collect data in the hosts and services files.

-u

Specify this option if you do not want to collect crash dumps.

-p

Specify this option if you do not want to collect data in the event database.

-q

Specify this option if you do not want the system to wait for your response about whether a data collection process will continue.

When the -q option is omitted, a confirmation message appears and your response is waited.

Return values

0	Normal end
8	Abnormal end Invalid argument Unable to find the folder containing data to be collected.

[Contents][Back][Next]

All Rights Reserved. Copyright (C) 2009, Hitachi, Ltd.