Hitachi

JP1 Version 12 JP1/Automatic Job Management System 3 Command Reference


ajs2collectcore (UNIX only)

Organization of this page

Format

ajs2collectcore
     [-b]
     [-c]
     [-f output-path-name]
     [-l]
     [-s]
     [core-dump-directory-or-core-dump-file...]

Description

Searches for core dump files (names beginning with core, core-, or core.) placed under the following directories and collects analysis information from those core dump files, if any.

The following table describes the information you can collect with the ajs2collectcore command.

Table 3‒1: Information that can be collected with the ajs2collectcore command

Information category

Description

Output file name#1

Core dump

Obtains a core dump file (core).

core.Z

Backtrace information

Outputs primary analysis information about the core dump.

coreinfo.backtrace.Z#2

Shared memory information

Outputs the contents of the shared memory that is used by ISAM, scheduler services, and the connection source restriction function.

coreinfo-ISAM.shmdump.tar.Z

coreinfo-scheduler.shmdump.Z

coreinfo-pmtcon_m.shmdump.physical.Z

coreinfo-pmtcon_a.shmdump.physical.Z

coreinfo-pmtcon_m.shmdump.logical.Z

coreinfo-pmtcon_a.shmdump.logical.Z

Shared library information

Obtains information about existing shared libraries, excluding the following:

  • /opt/jp1ajs2/lib/

  • /opt/jp1ajs2v/lib/

  • /opt/jp1base/lib/

coreinfo-analyze.tar.Z#2

#1

Use ajs2collectcore to compress the collected data. The following describes the compression method used by each OS:

In Linux:

JP1/AJS3 uses the gzip command to compress data. The file extension is .gz. If gzip is not installed, data will not be compressed, and the extension .gz will not be appended to the output file name. Note that the compress command will not be used.

In UNIX systems other than Linux:

JP1/AJS3 uses the compress command to compress data. The file extension is .Z. If compress is not installed, and the gzip command is installed, JP1/AJS3 uses the gzip command to compress data instead of the compress command. In this case, the extension of the output file name is .gz. If neither the compress command nor the gzip command is installed, no data is compressed. In this case, neither extension .Z nor .gz is added to the output file name.

#2

There will be as many outputs as there are core dumps.

The collected files are output, as shown in the following example, under the output-destination directory (the default is /tmp/jp1ajs2/core_analyze/).

Example:

In the following example, the command is executed when there are core dump files under /opt/jp1ajs2/bin/ (the output destination is the default):

/tmp/jp1ajs2/core_analyze/opt/jp1ajs2/bin/

The file list for the information collected is output at the same time. The file list is output immediately under the output-destination directory. The file name is shown below:

Ajs2collectcore_filelist.log

Execution privileges

Superuser privileges

Storage directory

/opt/jp1ajs2/tools/

Arguments

-b

Collects only the backtrace information in the core dump file to be collected.

Specifying this option together with the -c, -l, or -s option enables you to collect non-backtrace information as well. If you specify the -c, -l, or -s option but omit this option, backtrace information is not collected.

-c

Collects only the core dump file.

Specifying this option together with the -b, -l, or -s option enables you to collect non-backtrace information as well. If you specify the -b, -l, or -s option but omit this option, backtrace information is not collected.

-f output-path-name

Specify where to store the core dump information to be collected. Use an absolute path that does not contain space characters. Specifying the name with a relative path causes the command to terminate abnormally due to an argument error. If the specified path name contains a space character, the string before the space character is handled as the output path name and the string after the space character is regarded as another argument.

If you specify this option, core dump information is stored under the output path. If the specified output path does not exist, a message asking you whether to create the directory is output. To create the directory, enter y. If you enter n, the command does not collect the information.

If you omit this option, the default is /tmp/jp1ajs2/core_analyze.

-l

Collects only shared library information that excludes the target library supplied by JP1/AJS3.

Specifying this option together with the -b, -c, or -s option enables you to collect non-shared-library information as well. If you specify the -b, -c, or -s option but omit this option, the shared library information is not collected.

-s

Collects only the shared memory information to be collected.

At this time, if coreinfo-ISAM.shmdump_*, coreinfo-Scheduler.shmdump_*, coreinfo-pmtcon_{m | a}.shmdump.physical_*, or coreinfo-pmtcon_{m | a}.shmdump.logical*_* exists immediately under the destination directory path, back up the file, adding the extension .bk.

Specifying this option together with the -b, -c, or -l option enables you to collect non-shared-memory information as well. If you specify the -b, -c, or -l option but omit this option, the shared memory information is not collected.

core-dump-directory-or-core-dump-file

Other than for a search path for core dumps to be searched for in a standard configuration (see the Description section), specify the core-dump directory path or file name you want to additionally search for by using an absolute path that does not contain space characters. Specifying the name with a relative path causes the command to terminate abnormally due to an argument error. If the specified path name contains a space character, the string before the space character is handled as an output path name and the string after the space character is regarded as another argument.

If the search path contains core dump files (names beginning with core, core-, or core.), the command obtains the backtrace information and shared library information.

If you do not specify the core-dump directory or core dump file, the target of search is core dumps under the following directory paths.

  • /opt/jp1ajs2/ directory path

  • /var/opt/jp1ajs2/ directory path

  • /opt/jp1ajs2v/ directory path

  • /opt/jp1base/bin/ directory path

  • /tmp/jp1ajs2/ajs2gencore_create/ directory path

  • /var/lib/systemd/coredump/ directory path

Notes

Return values

0

All data items have been collected successfully.

4

Some of the data items have been collected successfully.

Other values

The process has terminated abnormally.

Output messages

Return value

Output message

Meaning

Operation

Action

0

Collection of the backtrace data [ file-name ] was successful.

OutputPath:

output-path-name

Normal collection (backtrace)

Normal termination or continued processing to obtain next information

(Not applicable)

0

Collection of the core dump file [ file-name ] was successful.

OutputPath:

output-path-name

Normal collection (core-dump files)

Normal termination or continued processing to obtain next information

(Not applicable)

0

Collection of the shared library data [ file-name ] was successful.

OutputPath:

output-path-name

Normal collection (library information)

Normal termination or continued processing to obtain next information

(Not applicable)

0

Collection of the {ISAM | Scheduler | {JP1_DEFAULT | logical-host-name} PMTCON_M | {JP1_DEFAULT | logical-host-name} PMTCON_A} shared memory dump was successful.

Output Path:

output-path-name

Normal collection (shared memory information)

Normal termination or continued processing to obtain next information

(Not applicable)

4 or 8

Error!!The input parameter [ argument ] is invalid.

<< ### Usage ### >>

ajs2collectcore [ -b ] [ -c ] [ -l ] [ -s ] [ -f output_fullpath ] [ additional_search_fullpath ... ]

Parameter error

Abnormal termination or continued processing (if there is an error in the additionally specified path)

Check the required parameters and re-execute the command.

16

Error!!

The specified directory [ destination-directory ] could not be created.

Failure to create a destination directory

Abnormal termination

The destination disk might have reached its full capacity.

Check the capacity of the destination disk. After taking steps to remedy the problem, re-execute the command.

4 or 8

Error!!

The specified file [ file-name ] does not have overwrite permissions.

Failure to overwrite an existing file

Continued processing (Continuing to collect something other than the target file)

Assign write privileges to the target file and re-execute the command.

4 or 8

Error!!

The backtrace data for the core dump file could not be collected.

Corefile:

corresponding-core-dump-file-name

Failure to collect backtrace information

Continued processing (Continuing to collect something other than the target backtrace information)

The destination disk might have reached its full capacity.

Check the capacity of the destination disk. After taking steps to remedy the problem, re-execute the command.

4 or 8

Error!!

The core dump file could not be collected.

Corefile:

corresponding-core-dump-file-name

Failure to collect core-dump files

Continued processing (Continuing to collect something other than the target core-dump file)

4 or 8

Error!!

Shared library data for the core dump file could not be collected.

Corefile:

corresponding-core-dump-file-name

Failure to collect shared library information

Continued processing (Continuing to collect something other than the target shared library information)

4 or 8

Error!!

{ISAM | Scheduler | {JP1_DEFAULT | logical-host-name} PMTCON_M | {JP1_DEFAULT | logical-host-name} PMTCON_A} shared memory data could not be collected.

Failure to collect shared memory information

Continued processing (Continuing to collect something other than the target shared memory information)

This message is output when there is no shared memory. If you are not using shared memory, ignore the message. If you are using shared memory, the following errors are possible:

  • Memory is running short.

  • The destination disk has reached its capacity.

Check the state of memory use and the capacity of the destination disk. After taking steps to remedy the problem, re-execute the command.

4, 8, or 124

An error occurred!!

ErrorCause: [ error-factor ]

ErrorInfo: [ error-information ]

Other error

Continued processing (Continuing to collect something other than the target information)

(Not applicable)

(Not applicable)

There are no core dump files in default directories.

No core dumps found in a standard search path

(Not applicable)

(Not applicable)

(Not applicable)

There are no core dump files in the specified path.

No core dumps found in an additionally specified path

(Not applicable)

(Not applicable)