Job Management Partner 1/Integrated Management - Manager Command and Definition File Reference

jim_log.sh (UNIX only)

Function

This is a tool for collecting data in the event of a failure in JP1/IM - Manager. The data collected by this tool includes maintenance information for JP1/IM - Manager and JP1/Base, system information from the OS, and integrated trace logs.

This tool is a shell script, which cannot be customized by the user.

When you execute this tool, it classifies the target directories or files used for data collection into primary and secondary data categories, uses the tar command to archive the data directly under the specified data storage directory, and then uses the compress command to create compressed files.

The primary data is collected for such purposes as identifying a failure and investigating the causes of minor failures. It consists of the minimum amount of logs and settings files. The secondary data provides the detailed information needed for an in-depth investigation of a failure. It consists of such data as core analysis information and data from the JP1/Base event database.

If you execute the jim_log.sh command while a core dump and a thread dump of JP1/IM - Manager (JP1/IM - Central Console) are available, the tool displays the KAVB8941-I and KAVB8942-I messages asking whether the core dump or the thread dump is to be deleted. If you enter y or yes, the tool deletes the core dump or thread dump.

For details about the data that can be collected by this tool, see 9.3 Data that needs to be collected when a problem occurs in the Job Management Partner 1/Integrated Management - Manager Administration Guide.

The following table lists and describes the compressed files containing the collected data.

Table 1-22 Compressed files containing the collected data

File name Description

jp1_default_imm_1st.tar.Z Primary data for the physical host

jp1_default_imm_2nd.tar.Z Secondary data for the physical host

logical-host-name_imm_1st.tar.Z^# Primary data for the logical host

logical-host-name_imm_2nd.tar.Z^# Secondary data for the logical host

#: Created only when a logical host was specified in the -h option.

The compressed files are stored in the data storage directory. The following tables show the organization of the internal directories for the compressed files.

Table 1-23 Organization of the internal directories for the primary data of the physical host

Directory and file name Stored data

./etc/opt/jp1base Automated startup and stop scripts for JP1/Base

./etc/opt/jp1base/conf JP1/Base settings and definition files

./etc/opt/jp1base/default Common definition information for JP1/Base

./etc/opt/jp1cons Automated startup and stop scripts for JP1/IM - Manager (JP1/IM - Central Console)

./etc/opt/jp1cons/conf JP1/IM - Manager (JP1/IM - Central Console) settings and definition files

./etc/opt/jp1cons/default Common definition information for JP1/IM - Manager (JP1/IM - Central Console)

./etc/opt/jp1imm/conf/tools JP1/IM - Manager settings and definition files

./etc/opt/jp1imm/conf/imcf IM Configuration Management settings and definition files

./etc/opt/jp1imm/conf/imdb IM database settings and definition files

./etc/opt/jp1imm/default/imcf Common definition information for IM Configuration Management

./etc/opt/jp1scope/conf JP1/IM - Manager (JP1/IM - Central Scope) settings and definition files

./etc/opt/jp1scope/default Common definition information for JP1/IM - Manager (JP1/IM - Central Scope)

./opt/jp1/hcclibcnf Common definition information

./opt/jp1base Patch application history and patch log information for JP1/Base

./opt/jp1base/conf Settings file for JP1/Base plug-in services

./opt/jp1imm Patch application history and patch log information for JP1/IM - Manager

./var/opt/jp1base/log Log files for JP1/Base

./var/opt/jp1base/sys/tmp Logs and temporary files for JP1/Base

./var/opt/hitachi/HNTRLib2/spool Integrated trace logs

./var/opt/jp1cons/log Log files for JP1/IM - Manager (JP1/IM - Central Console)

./var/opt/jp1imm/database/imdb Detailed log information for the IM database

./var/opt/jp1imm/log/imcf Log files for IM Configuration Management

./var/opt/jp1imm/log/imdb Log files for the IM database

./var/opt/jp1imm/log/_jp1_default/oslog OS log information

./var/opt/jp1scope/log Log files for JP1/IM - Manager (JP1/IM - Central Scope)

Table 1-24 Organization of the internal directories for the secondary data of the physical host

Directory and file name Stored data

./var/opt/jp1base/log/COMMAND Command execution log files for JP1/Base

./var/opt/jp1base/sys/event/servers/default Event database for JP1/Base

./var/opt/jp1cons/operation/evgen Correlation event generation history files for JP1/IM - Manager (JP1/IM - Central Console)

./var/opt/jp1imm/log/_jp1_default/oslog OS log information

./var/opt/jp1imm/log/_jp1_default/core Core file

./var/opt/jp1scope/database Database information for JP1/IM - Manager (JP1/IM - Central Scope)

./var/opt/jp1imm/data/imcf Data files for IM Configuration Management

./var/opt/jp1imm/database/imdb/imdbbackup.dat Backup files of the IM database

./tmp/.JP1_SES*
./usr/tmp/jp1_ses
./usr/lib/jp1_ses/log
./usr/lib/jp1_ses/sys
./usr/bin/jp1_ses/jp*
./var/opt/jp1_ses Log for JP1/SES compatibility

Table 1-25 Organization of the internal directories for the primary data of the logical host

Directory and file name Stored data

./shared-disk/jp1base/../event Event server settings for the logical host of JP1/Base

./shared-disk/jp1base/conf Logical host settings and definition files for JP1/Base

./shared-disk/jp1base/log Log files for the logical host of JP1/Base

./shared-disk/jp1cons/conf Logical host settings and definition files for JP1/IM - Manager (JP1/IM - Central Console)

./shared-disk/jp1cons/log Log files for the logical host of JP1/IM - Manager (JP1/IM - Central Console)

./shared-disk/jp1scope/conf Logical host settings and definition files for JP1/IM - Manager (JP1/IM - Central Scope)

./shared-disk/jp1scope/log Log files for the logical host of JP1/IM - Manager (JP1/IM - Central Scope)

./var/opt/jp1imm/log/_logical-host-name/oslog OS log information

./shared-disk/jp1imm/conf/imcf IM Configuration Management settings and definition files

./var/opt/jp1imm/database/imdb Detailed log information for the IM database

./shared-disk/jp1imm/log/imcf Log files for IM Configuration Management

./var/opt/jp1imm/log/imdb Log files for the IM database

Table 1-26 Organization of the internal directories for the secondary data of the logical host

Directory and file name Stored data

./shared-disk/event Event database for the JP1/BaseEvent database for JP1/Base

./shared-disk/jp1base/log/COMMAND Command execution log files for JP1/Base

./shared-disk/jp1cons/operation/evgen Correlation event generation history files for JP1/IM - Manager (JP1/IM - Central Console)

./shared-disk/jp1scope/database Database information for JP1/IM - Manager (JP1/IM - Central Scope)

./var/opt/jp1imm/log/_logical-host-name/oslog OS log information

./var/opt/jp1imm/log/_logical-host-name/core Core file

./shared-disk/jp1imm/data/imcf Data files for IM Configuration Management

./shared-disk/jp1imm/database/imdb/imdbbackup.dat Backup files of the IM database

File name	Description
jp1_default_imm_1st.tar.Z	Primary data for the physical host
jp1_default_imm_2nd.tar.Z	Secondary data for the physical host
logical-host-name_imm_1st.tar.Z^#	Primary data for the logical host
logical-host-name_imm_2nd.tar.Z^#	Secondary data for the logical host

Directory and file name	Stored data
./etc/opt/jp1base	Automated startup and stop scripts for JP1/Base
./etc/opt/jp1base/conf	JP1/Base settings and definition files
./etc/opt/jp1base/default	Common definition information for JP1/Base
./etc/opt/jp1cons	Automated startup and stop scripts for JP1/IM - Manager (JP1/IM - Central Console)
./etc/opt/jp1cons/conf	JP1/IM - Manager (JP1/IM - Central Console) settings and definition files
./etc/opt/jp1cons/default	Common definition information for JP1/IM - Manager (JP1/IM - Central Console)
./etc/opt/jp1imm/conf/tools	JP1/IM - Manager settings and definition files
./etc/opt/jp1imm/conf/imcf	IM Configuration Management settings and definition files
./etc/opt/jp1imm/conf/imdb	IM database settings and definition files
./etc/opt/jp1imm/default/imcf	Common definition information for IM Configuration Management
./etc/opt/jp1scope/conf	JP1/IM - Manager (JP1/IM - Central Scope) settings and definition files
./etc/opt/jp1scope/default	Common definition information for JP1/IM - Manager (JP1/IM - Central Scope)
./opt/jp1/hcclibcnf	Common definition information
./opt/jp1base	Patch application history and patch log information for JP1/Base
./opt/jp1base/conf	Settings file for JP1/Base plug-in services
./opt/jp1imm	Patch application history and patch log information for JP1/IM - Manager
./var/opt/jp1base/log	Log files for JP1/Base
./var/opt/jp1base/sys/tmp	Logs and temporary files for JP1/Base
./var/opt/hitachi/HNTRLib2/spool	Integrated trace logs
./var/opt/jp1cons/log	Log files for JP1/IM - Manager (JP1/IM - Central Console)
./var/opt/jp1imm/database/imdb	Detailed log information for the IM database
./var/opt/jp1imm/log/imcf	Log files for IM Configuration Management
./var/opt/jp1imm/log/imdb	Log files for the IM database
./var/opt/jp1imm/log/_jp1_default/oslog	OS log information
./var/opt/jp1scope/log	Log files for JP1/IM - Manager (JP1/IM - Central Scope)

Directory and file name	Stored data
./var/opt/jp1base/log/COMMAND	Command execution log files for JP1/Base
./var/opt/jp1base/sys/event/servers/default	Event database for JP1/Base
./var/opt/jp1cons/operation/evgen	Correlation event generation history files for JP1/IM - Manager (JP1/IM - Central Console)
./var/opt/jp1imm/log/_jp1_default/oslog	OS log information
./var/opt/jp1imm/log/_jp1_default/core	Core file
./var/opt/jp1scope/database	Database information for JP1/IM - Manager (JP1/IM - Central Scope)
./var/opt/jp1imm/data/imcf	Data files for IM Configuration Management
./var/opt/jp1imm/database/imdb/imdbbackup.dat	Backup files of the IM database
./tmp/.JP1_SES* ./usr/tmp/jp1_ses ./usr/lib/jp1_ses/log ./usr/lib/jp1_ses/sys ./usr/bin/jp1_ses/jp* ./var/opt/jp1_ses	Log for JP1/SES compatibility

Directory and file name	Stored data
./shared-disk/jp1base/../event	Event server settings for the logical host of JP1/Base
./shared-disk/jp1base/conf	Logical host settings and definition files for JP1/Base
./shared-disk/jp1base/log	Log files for the logical host of JP1/Base
./shared-disk/jp1cons/conf	Logical host settings and definition files for JP1/IM - Manager (JP1/IM - Central Console)
./shared-disk/jp1cons/log	Log files for the logical host of JP1/IM - Manager (JP1/IM - Central Console)
./shared-disk/jp1scope/conf	Logical host settings and definition files for JP1/IM - Manager (JP1/IM - Central Scope)
./shared-disk/jp1scope/log	Log files for the logical host of JP1/IM - Manager (JP1/IM - Central Scope)
./var/opt/jp1imm/log/_logical-host-name/oslog	OS log information
./shared-disk/jp1imm/conf/imcf	IM Configuration Management settings and definition files
./var/opt/jp1imm/database/imdb	Detailed log information for the IM database
./shared-disk/jp1imm/log/imcf	Log files for IM Configuration Management
./var/opt/jp1imm/log/imdb	Log files for the IM database

Directory and file name	Stored data
./shared-disk/event	Event database for the JP1/BaseEvent database for JP1/Base
./shared-disk/jp1base/log/COMMAND	Command execution log files for JP1/Base
./shared-disk/jp1cons/operation/evgen	Correlation event generation history files for JP1/IM - Manager (JP1/IM - Central Console)
./shared-disk/jp1scope/database	Database information for JP1/IM - Manager (JP1/IM - Central Scope)
./var/opt/jp1imm/log/_logical-host-name/oslog	OS log information
./var/opt/jp1imm/log/_logical-host-name/core	Core file
./shared-disk/jp1imm/data/imcf	Data files for IM Configuration Management
./shared-disk/jp1imm/database/imdb/imdbbackup.dat	Backup files of the IM database

Format

jim_log.sh -f data-storage-directory
           [-h logical-host-name]
           [-t]
           [-u]
           [-n]
           [-p]
           [-r]
           [-g]
           [-s]
           [-c]
           [-d]
           [-x]
           [-q]
           [directory-name-or-file-name...]

Execution permission

Superuser permissions

Storage directory

/opt/jp1imm/tools/

Arguments

-f data-storage-directory

Specifies the name of the directory or device to which the collected data is to be output, expressed as a full path or a path relative to the root directory. If you specify a directory name, the tool creates the files containing the collected data under that directory. If the path contains a space, enclose the entire path in double-quotation marks ("). This option is mandatory.

If a nonexistent directory is specified, a new directory with the specified name is created. If an existing directory is specified, that directory is deleted and the specified directory is created.

If a device name is specified, a write operation occurs on that device for each file that is created. If a device file name such as for a tape device is specified, the collected data is stored on the device without being compressed.

If you specify a device name and the -q option, the tool assumes that you have chosen yes for user confirmation. In such a case, you must set the device before you execute the command.

-h logical-host-name

When you are operating in a cluster system, this option specifies a logical host name and that the command is to collect data for that logical host as well as for the physical host. If this option is omitted, the command collects data for the physical host only. If you are not using a cluster system, there is no need to specify this option.

Note that this command will not use the logical host name that is set in the JP1_HOSTNAME environment variable. Therefore, if you use this command in a cluster system, make sure that you specify the logical host name in this option.

-t

Specifies that the hosts, services, and passwd files are not to be collected.

-u

Specifies that core analysis information is not to be collected. The core analysis information consists of a file obtained by using the car command of the Seraph tool to analyze a core dump file.

-n

Specifies that maintenance data for JP1/Base is not to be collected.

-p

Specifies that the event database for JP1/Base is not to be collected.

-r

Specifies that the command execution log files for JP1/Base are not to be collected.

-g

Specifies that the correlation event generation history file is not to be collected.

-s

Specifies that maintenance data for JP1/IM - Manager (JP1/IM - Central Scope) is not to be collected.

-c

Specifies that maintenance data for IM Configuration Management is not to be collected.

-d

Specifies that maintenance data for the IM database is not to be collected.

-x

Specifies that IM database backup files are to be collected.

The IM database backup files are not included in the maintenance data for the IM database that is collected by default. If the IM database service is not running, the maintenance data is not collected. In such a case, start the IM database service and then re-execute the data collection command. The backup files can be collected even when JP1/IM - Manager is running.

-q

Specifies that the command is to be executed without requesting confirmation from the user.

directory-name-or-file-name

Specifies a file or directory to be collected by the data collection tool. Specify a full path name. To specify multiple names, use the space character to separate the names.

Note that this option must be the last option specified in the command. Specify it after you have specified all the other options that you need to specify. The collected data is stored as the primary data for the physical host.

Notes

It is possible that this tool will collect a vast amount of data. Before you execute this tool, you must estimate the amount of disk space required and check the available capacity in your machine. For details, see 9.4 Collecting data in the Job Management Partner 1/Integrated Management - Manager Administration Guide.

Do not execute this tool more than once. If it is executed multiple times, previously collected data might be overwritten or data collection might fail.

Return values

0 Normal termination

8 Abnormal termination

Example 1

Collect data for the physical host and the logical host hostA into /tmp/jp1log:

jim_log.sh -f /tmp/jp1log -h hostA

The output result is as follows:

KAVB8925-I The directory does not exist. (/var/opt/jp1imm/log/_jp1_default).
           The directory will be created.
KAVB8925-I The directory does not exist. (/var/opt/jp1imm/log/_hostA).
           The directory will be created.
KAVB8926-I Data acquisition processing will start.
KAVB8921-I The physical host's first material will be acquired.
KAVB8922-I The physical host's first material has been acquired.
KAVB8921-I The physical host's second material will be acquired.
KAVB8922-I The physical host's second material has been acquired.
KAVB8921-I The logical host(hostA)'s first material will be acquired.
KAVB8922-I The logical host(hostA)'s first material has been acquired.
KAVB8921-I The logical host(hostA)'s second material will be acquired.
KAVB8922-I The logical host(hostA)'s second material has been acquired.
KAVB8918-I The data was successfully acquired.

Example 2

Collect data for the physical host into the nonexistent directory /tmp/jp1log/, but do not specify the existing logical host (hostA):

jim_log.sh -f /tmp/jp1log

The output result is as follows:

KAVB8925-I The directory does not exist. (/tmp/jp1log).
           The directory will be created.
KAVB8925-I The directory does not exist. (/var/opt/jp1imm/log/_jp1_default).
           The directory will be created.
KAVB8926-I Data acquisition processing will start.
KAVB8921-I The physical host's first material will be acquired.
KAVB8922-I The physical host's first material has been acquired.
KAVB8921-I The physical host's second material will be acquired.
KAVB8922-I The physical host's second material has been acquired.
KAVB8918-I The data was successfully acquired.
KAVB8935-I The following logical host(s) exist on this machine:
hostA
To acquire information about a logical host, execute "jim_log.sh -f output-directory-name -h logical-hostname".

Example 3

Collect data for the physical host into the /tmp/jp1log/ directory, which contains the jp1_default_imm_1st.tar.Z and jp1_default_imm_2nd.tar files, but do not specify the existing logical host (hostA):

jim_log.sh -f /tmp/jp1log

The output result is as follows (when y is entered for all responses):

KAVB8925-I The directory does not exist. (/var/opt/jp1imm/log/_jp1_default).
           The directory will be created.
KAVB8926-I Data acquisition processing will start.
KAVB8921-I The physical host's first material will be acquired.
KAVB8922-I The physical host's first material has been acquired.
KAVB8921-I The physical host's second material will be acquired.
KAVB8944-I (/tmp/jp1log/jp1_default_imm_2nd.tar.Z) already exists. Do you want to overwrite it? [yes/no]y
KAVB8922-I The physical host's second material has been acquired.
KAVB8918-I The data was successfully acquired.
KAVB8944-I (/tmp/jp1log/jp1_default_imm_1st.tar.Z) already exists. Do you want to overwrite it? [yes/no]y
KAVB8935-I The following logical host(s) exist on this machine:
hostA
To acquire information about a logical host, execute "jim_log.sh -f output-directory-name -h logical-hostname".

[Contents][Back][Next]

[Trademarks]