Job Management Partner 1/Base User's Guide

jbs_log.sh (UNIX only)

Function

The jbs_log.sh 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 shell script. It cannot be customized.

When you execute this tool, the specified directories or files are archived using the tar command in the root directory, and then compressed using the compress command. The compressed files are stored in the data-directory specified in the -f option, or in the /tmp/jp1base/ directory if you did not set the -f option. The following table shows the directory organization for the compressed files.

Command directory	Collected data
data-directory/jp1_default_base_1st/var/opt/jp1base/conf/	Settings and definition files
data-directory/jp1_default_base_1st/var/opt/jp1base/log/	Log file
data-directory/jp1_default_base_1st/var/opt/jp1base/log/sys/	OS system information jbs_spmd_status command execution results
data-directory/jp1_default_base_1st/var/opt/jp1base/sys/tmp/event/	Event server settings
data-directory/jp1_default_base_1st/var/opt/jp1base/sys/OPI	Information on the operation of services
data-directory/jp1_default_base_1st/var/opt/jp1base/plugin/conf/	Plug-in service settings file
data-directory/jp1_default_base_1st/var/opt/hitachi/HNTRLib2/spool/	Integrated trace logs
data-directory/jp1_default_base_1st/opt/jp1/hcclibcnf/	Common definition information
data-directory/jp1_default_base_2nd/var/opt/jp1base/Command/	Command execution log files
data-directory/jp1_default_base_2nd/var/opt/jp1base/sys/event/	Event database
data-directory/jp1_default_base_2nd/usr/tmp/jp1_ses/	Settings file for SES compatibility
data-directory/jp1_default_base_2nd/usr/lib/jp1_ses/
data-directory/jp1_default_base_2nd/usr/bin/jp1_ses/
data-directory/jp1_default_base_2nd/tmp/
data-directory/jp1_default_base_2nd/var/opt/jp1_ses/
data-directory/logical-host-name_base_1st/etc/opt/jp1base/log/	Log files for the logical host
data-directory/logical-host-name_base_1st/etc/opt/jp1base/conf/	Settings and definition files for the logical host (if applicable)
data-directory/logical-host-name_base_1st/shared-directory/event/	Event server settings for the logical host (if applicable)
data-directory/logical-host-name_base_1st/shared-directory/jp1base/sys/OPI	Information on the operation of services for the logical host
data-directory/logical-host-name_base_2nd/shared-directory/event/	Event database for the logical host (if applicable)
data-directory/logical-host-name_base_2nd/var/opt/jp1base/COMMAND/	Command execution log files 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.sh [-f data-directory]
              [-k]
              [-p]
              [-r]
              [-t]
              [-u]
              [-q]
              [-h logical-host-name]
              [directory-name-or-file-name...]

Required execution permission

Superuser

Command directory

/opt/jp1base/tools/

Arguments

-f data-directory

Specify the directory for storing the collected information by absolute path, without any spaces. If you include a space, the character string before the space is taken as the directory name and the characters after the space are regarded as another argument.

If you omit the -f option, JP1/Base creates the following files:

For a physical host:

/tmp/jp1base/jp1_default_base_1st.tar.Z

/tmp/jp1base/jp1_default_base_2nd.tar.Z

For a logical host:

/tmp/jp1base/logical-host-name_base_1st.tar.Z

/tmp/jp1base/logical-host-name_base_2nd.tar.Z

-k

Specify this option if you do not want to collect log data related to the pre-Version 6 program JP1/SES.

-p

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

-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 from the /etc/hosts, etc/services, or /etc/passwd files.

-u

Specify this option if you do not want to collect analysis information from core files.

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

directory-name-or-file-name

Specify this argument to collect one or more specific files or directories using the data collection tool. Specify the name(s) by full path(s). Use spaces to delimit multiple names.

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

Return values

0

Normal end

8

Invalid argument The specified logical host name does not exist. The shared directory of the specified logical host is not mounted. Unable to copy the file because the program has not been installed. The user replied NO when asked whether the device file is ready. The user replied NO when asked whether the file being output might overwrite the existing file. Unable to read the specified additional file. The specified additional file does not exist. Unable to write to the output directory. Unable to create the output directory.

[Contents][Back][Next]

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