Hitachi

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

jajs_log.bat or _04.bat (Windows only)

Organization of this page

Format

jajs_log.bat | _04.bat
     [-h logical-host-name]
     [-f storage-directory]
     [-s]
     [-t]
     [-u]
     [-e]
     [-b]

To Page Top

Description

The data collection tool obtains maintenance information, such as the JP1/AJS3 logs and information about the OS.

Both data collection tools have the same basic functionality. Use either tool depending on the purpose of use and whether customization is required.

The following table describes the purpose of jajs_log.bat and _04.bat, and whether they can be customized.

Table 3‒28: Purpose of data collection tools and whether they can be customized

Data collection tool

Purpose

Customization

jajs_log.bat

Use this tool if the log output destinations have not been changed from the defaults, or if you need to collect data by default only.

N

_04.bat

Customize this tool before using it if you have changed log output destinations from the defaults, or if you need to collect data other than the default data.#1, #2

Y
Legend:

Y: The tool can be customized.

N: The tool cannot be customized.

#1

For details about the customization method, see 7.1.1 Setting up the data collection tools in the JP1/Automatic Job Management System 3 Configuration Guide.

#2

If you have changed the installation destination folder from the default, use jajs_log.bat unless output destinations for log files were changed after installation.

By default, the results of executing the data collection tool are output to the following folders under %TEMP%\jp1ajs2\backlog.

For physical hosts:

  1. JP1_DEFAULT\JP1_DEFAULT_1st

    The data for the first reports is output.

  2. JP1_DEFAULT\JP1_DEFAULT_2nd

    The data for the second reports is output.

  3. JP1_DEFAULT\JP1_DEFAULT_3rd

    All other data is output.

For logical hosts:

  1. logical-host-name\logical-host-name_1st

    The data for the first reports is output.

  2. logical-host-name\logical-host-name_2nd

    The data for the second reports is output.

  3. logical-host-name\logical-host-name_3rd

    All other data is output.

Notes

  • _04.bat is the data collection tool for JP1/AJS3 10-10 and earlier. For JP1/AJS3 10-50 and later, you can use both jajs_log.bat and _04.bat.

  • For JP1/AJS3 - Web Console, you can use jajs_log.bat only. You cannot use _04.bat, so you cannot customize the data collection tool.

To Page Top

Execution privileges

Administrators privileges

To Page Top

Storage directory

For jajs_log.bat:

JP1/AJS3-installation-folder\tools

For _04.bat:

JP1/AJS3-installation-folder\tools

To Page Top

Arguments

-h logical-host-name

Specify the name of the target logical host.

The data collection tool collects the data on the physical host in addition to the data on the specified logical host.

If you do not specify a name, the data collection tool obtains the physical host logs.

-f storage-directory

Use the absolute path to the folder to which collected data is output. You can also use a relative path from the location in which the command is executed. However, you cannot specify the root directory.

To specify a path that contains spaces, enclose the entire path in double quotation marks (").

If you specify a folder that does not exist, a new folder with that name is created.

If data has already been collected under the specified storage folder, a message asking whether you want to overwrite the files appears.

If you specify too long a path to the storage folder, data collection might fail. If data collection fails, specify a shorter path, and then retry collecting data.

If you omit this option, the collected data is output to %TEMP%\jp1ajs2\backlog. If you specify this option, the value of this option overrides the storage folder that was changed from the default by customizing the tool.

-s

Specify this option if you do not want to collect information about the database used by JP1/AJS3.

If you do not specify this option, the data collection tool collects information about these databases.

-t

Specify this option if you do not want to obtain the hosts and services files.

-u

Specify this option if you do not want to obtain dump files.

-e

Specify this option if you do not want to collect detailed information about the embedded database.

The detailed information about the embedded database is the data for the second report, which is output to the embdbinfo folder.

If you do not specify this option, the data collection tool collects detailed information about the embedded database.

When this option is not specified, it is automatically determined whether to collect the information. Therefore, do not specify this option if you are unsure about whether detailed information about the embedded database needs to be collected.

Specify this option only when you want to suppress the collection of detailed information about the embedded database.

-b

Specify this option if you do not want to collect detailed information about JP1/Base.

The detailed information about JP1/Base is the data for the second report, which is output to the JP1BASE_INFO folder.

If you do not specify this option, the data collection tool collects detailed information about JP1/Base.

When this option is not specified, it is automatically determined whether to collect the information. Therefore, do not specify this option if you are unsure about whether detailed information about JP1/Base needs to be collected.

Specify this option only when you want to suppress the collection of detailed information about JP1/Base.

If free disk space at the output destination is insufficient, execute the data collection tool with the -b option specified, and then execute the data collection tool for JP1/Base (jbs_log) to collect detailed information about JP1/Base. For details about the data collection tool for JP1/Base (jbs_log), see the JP1/Base User's Guide.

To Page Top

Notes

  1. If you execute the data collection tool without the -s option specified during startup of the JP1/AJS3 service, the job might end abnormally. In such a case, JP1/AJS3 does not collect information about the ISAM database.

  2. To collect data about a logical host in a cluster system, execute the data collection tool on the host on which the logical host runs.

  3. The data collection tool does not compress the data if collects. To compress the data, use a data compression tool.

  4. If you have already created a file containing the execution results of batch files, JP1/AJS3 outputs a message asking for permission to overwrite the file. To overwrite the file, specify y. If you do not want to overwrite the file, specify n.

  5. While a batch file is being executed, JP1/AJS3 might display an error message reporting that a sharing violation has occurred for a file in the JP1/AJS3 - Manager-or-JP1/AJS3 - Agent-installation-folder\sys folder. This is not a problem.

  6. If you perform an operation on the collected data such as, moving it or deleting it immediately after the execution of the data collection tool has finished, a message reporting that the process cannot access a file because another process is currently using the file might appear. This message appears because a process that collects OS information internally is still being executed despite termination of the tool. If this message appears, wait a while and then retry the operation.

  7. If you execute the data collection tool while using Outlook, the following message might appear:

    The program is attempting to access email addresses in Outlook. Is this all right?

    The program indicated in this message is the machine configuration collection program (msinfo32) executed internally by the data collection tool. This program does not affect the operation of the data collection tool or Outlook.

    The data collection tool does not collect email addresses. If this message appears, click the No button.

  8. When you execute the data collection tool, you must open the Command Prompt window as an administrator. If you are not an administrator, UAC will frequently open a confirmation dialog box. If you turn UAC off, you will not need to open the Command Prompt window as an administrator.

  9. Do not execute more than one data collection tool at the same time. Do not execute jajs_log.bat and _04.bat at the same time.

  10. When you specify options, do not specify characters or symbols that have special meanings in the bat file. If you specify such characters and symbols, an unexpected error might occur.

  11. If the embedded database service has stopped, information about the database stored in the embedded database is not collected even if you execute the command without the -s option specified.

  12. If an error occurred in the embedded database, information about the database stored in the embedded database might not be collectible.

  13. If JP1/AJS3 is operated by using an external database, and the connected database has stopped, information about the connected database is not collected even if the command is executed with the -s option specified.

  14. In cases where JP1/AJS3 is operated by using an external database, and an error occurs in the connected database, information about the connected database might not be collectible.

To Page Top

Return values

0

Normal end

Value other than 0

Abnormal end

To Page Top

Messages

Message

Description

Action

Finished. Press any key.

The process ended normally. Press any key.

Wait for a user response.

Failed. Press any key.

The process did not end normally. Press any key.

See the output OS messages, remove the cause of the error, and then re-execute the process.

Wait for a user response.

File file-name is exist. Delete to continue? (y/n)

A file created the last time this process was executed exists. Press y to delete the file and continue processing, or press n to stop processing.

Wait for a user response.

Directory directory-name is exist. Delete to continue? (y/n)

A directory created the last time this process was executed exists. Press y to delete the directory and continue processing, or press n to stop processing.

Wait for a user response.

Error exist in option.

An option is specified incorrectly. Specify the option correctly, and then re-execute the process.

Complete the process.

The following logical hosts exist, other than the specified logical host. : logical-host-name

A logical host environment other than the one specified for the -h option exists. If necessary, re-execute the process.

After this message, the following message is output:

Finished. Press any key.

The collection of detailed information on EmbedDB _JF*# begins.

Collection of detailed information about the embedded database has started.

Continue processing.

The collection of detailed information on EmbedDB_JF*# ended.

Collection of detailed information about the embedded database has ended.

Continue processing.

The collection of detailed information on JP1/Base begins.

Collection of detailed information about JP1/Base has started.

Continue processing.

The collection of detailed information on JP1/Base ended.

Collection of detailed information about JP1/Base has ended.

Continue processing.

The collection of Event Log in text format begins.

Collection of event log data in text format has started.

Continue processing.

The collection of Event Log in text format ended.

Collection of event log data in text format has ended.

Continue processing.

The collection of the database information on SQLSVR begins.

If an external database is used, collection of information about the connected database starts.

Continue processing.

The collection of the database information on SQLSVR ends.

If an external database is used, collection of information about the connected database ends.

Continue processing.
#

_JF* indicates an embedded database identifier (_JF0, _JF1, _JF2, and so on). Detailed information is collected for each identifier.

To Page Top

Example 1

The following command collects physical host materials:

For jajs_log: 
jajs_log.bat
If you use _04 customized to trouble.bat: 
trouble.bat

To Page Top

Example 2

The following command collects physical host materials when the JP1/AJS3 service is running:

For jajs_log: 
jajs_log.bat -s
If you use _04 customized to trouble.bat: 
trouble.bat -s

To Page Top

Example 3

The following command collects data about a logical host (cluster):

For jajs_log: 
jajs_log.bat -h cluster
If you use _04 customized to trouble.bat: 
trouble.bat -h cluster

To Page Top

Data that can be collected

For physical hosts:

  • The data for first reports (%TEMP%\jp1ajs2\backlog\JP1_DEFAULT\JP1_DEFAULT_1st)

    Name of folder or file containing collected data

    Description

    1. \FILELIST.txt

    2. \JP1AJS3WEB_INFO\FILELIST.txt

    List of files under the JP1/AJS3 installation folder

    1. \GETERROR.log

    2. \JP1AJS3WEB_INFO\GETERROR.log

    Log information that is output by the data collection tool (_04.bat)

    \HOSTS

    hosts file

    \services

    services file

    1. \JP1AJS2.DAT

    2. \JP1AJS2C.DAT

    3. \JP1AJS2DA.DAT

    4. \JP1AJS2SE.DAT

    5. \JP1AJS2V.DAT

    6. \JP1AJS2WOA.DAT

    7. \JP1AJS3WEB_INFO\JP1AJS3WEB.DAT

    8. \JP1BASE.DAT

    Registry information about each product

    \REGDATA.DAT

    JP1 registry information

    \WIN.DAT

    Windows registry information

    \ajsqlstatus.txt

    Execution result of ajsqlstatus.exe

    \ajsagtshow.txt

    Execution result of ajsagtshow.exe

    \ajsagtshow_e.txt

    Execution result of ajsagtshow.exe (-e option)

    \ajsagtprint.txt

    Execution result of ajsagtprint.exe

    \jajs_status.txt

    Execution result of jajs_status.exe

    \ajsprof_scheduler-service-name_agent_stat.txt#1

    Execution result of ajsprofstatus.exe (-t agent -s option)

    \ajsprof_scheduler-service-name_agent_def.txt#1

    Execution result of ajsprofstatus.exe (-t agent -p option)

    \ajsprof_scheduler-service-name_unit_stat.txt#1

    Execution result of ajsprofstatus.exe (-t unit -s option)

    \ajsprof_scheduler-service-name_unit_def.txt#1

    Execution result of ajsprofstatus.exe (-t unit -p option)

    \jajs_pmtcon_m.txt

    Execution result of jajs_pmtcon.exe (-m -v option)

    \jajs_pmtcon_a.txt

    Execution result of jajs_pmtcon.exe (-a -v option)

    \OSINFO.txt

    OS version, Windows environment variables, IP configuration, network configuration, statistics

    1. \PERMISSIONINFO.TXT

    2. \JP1AJS3WEB_INFO\PERMISSIONINFO.TXT

    Access permissions for JP1/AJS3 folders

    \WINMSD.TXT

    All system information that is collected by using the msinfo32 command

    1. \ALLUSERSPROFILE\conf\JP1AJS2

    2. \conf\JP1AJS2DA

    3. \ALLUSERSPROFILE\conf\JP1AJS2V

    4. \conf\JP1AJS2WOA

    5. \JP1AJS3WEB_INFO\ALLUSERPROFILE\conf

    Environment-settings file storage folder

    \EMBDB\_JF*#2\conf

    Embedded database definition file

    \EMBDB\_JF*#2\spool

    Embedded database failure investigation file

    \EMBDB\_JF*#2\etc

    Other information related to the embedded database that is needed for investigation

    1. \HNTRLib2\spool

    2. \JP1AJS3WEB_INFO\HNTRLib2

    Integrated trace log

    1. \ALLUSERSPROFILE\JP1AJS2

    2. \JP1AJS2C

    3. \ALLUSERSPROFILE\JP1AJS2DA

    4. \JP1AJS2HC

    5. \ALLUSERSPROFILE\JP1AJS2V

    6. \JP1BASE

    7. \JP1AJS3WEB_INFO\ALLUSERSPROFILE\log

    8. \JP1AJS3WEB_INFO\jp1common_ajs3web

    Folders containing log files

    1. \PATCHLOG\JP1JAJS2\PATCHLOG.txt

    2. \PATCHLOG\JP1JAJS2C\PATCHLOG.txt

    3. \PATCHLOG\JP1JAJS2DA\PATCHLOG.txt

    4. \PATCHLOG\JP1JAJS2V\PATCHLOG.txt

    5. \PATCHLOG\JP1JAJS2WOA\PATCHLOG.txt

    6. \JP1AJS3WEB_INFO\PATCHLOG.txt

    Patch log files

    \resource\JP1AJS2V

    Folder containing resource files

    1. \ALLUSERSPROFILE\sys\JP1AJS2

    2. \sys\JP1AJS2WOA

    3. \ALLUSERSPROFILE\sys\JP1AJS2V

    4. \JP1AJS3WEB_INFO\sys

    Folders containing the system files

    \ALLUSERSPROFILE\tmp\JP1AJS2DA

    Folders containing temporary files for execution

    \JP1AJS3WEB_INFO\ALLUSERPROFILE\tmp

    Folders containing the work files

    \ALLUSERSPROFILE\tmp\schedule\pd*.trc

    Embedded database trace logs

    \user_acl

    Folder containing user mapping and authentication settings files

    1. \jp1common_ajs2

    2. \jp1common_ajs2da

    3. \JP1AJS3WEB_INFO\jp1common_ajs2

    Folder containing product information files

    \HCDINST

    Hitachi integrated installation log

    \jp1common

    JP1/Base installation log

    1. \Version\JP1AJS2

    2. \Version\JP1AJS2V

    3. \Version\JP1AJS2DA

    4. \JP1AJS3WEB_INFO\Version

    Folders containing the version information files

    1. \embsch_data

    2. \embsch_inst\ga.ini

    3. \embsch_inst\Readme.txt

    Folder used for a flexible job to store files, and files used for a flexible job

    1. \JP1AJS3WEB_INFO\snapshotlog.txt

    2. \JP1AJS3WEB_INFO\srvdata\snapshot.zip

    Web server information

    \JP1AJS3WEB_INFO\SHARED

    Shared folder of web server
    #1

    Information about all scheduler services on the host is collected.

    #2

    _JF* indicates an embedded database identifier (_JF0, _JF1, _JF2, and so on). A folder is created for each identifier.

  • The data for second reports (%TEMP%\jp1ajs2\backlog\JP1_DEFAULT\JP1_DEFAULT_2nd)

    Name of folder or file containing collected data

    Description

    \ADD

    Folder for additional collected data

    1. \cmdatabase

    2. \database

    3. \embdatabase\_JF*#1

    4. \extdb\SQLSVR\scheduler-service-name#3

    Database storage folders

    1. \eventlog\AppEvent(Backup).evt

    2. \eventlog\AppEvent(Backup).txt

    Application event log

    1. \eventlog\SysEvent(Backup).evt

    2. \eventlog\SysEvent(Backup).txt

    System event log

    1. \SHMDUMP\coreinfo-ISAM.shmdump

    2. \SHMDUMP\coreinfo-Scheduler.shmdump

    3. \SHMDUMP\ProgMon.shmdump

    4. \SHMDUMP\coreinfo-host.shmdump

    5. \SHMDUMP\coreinfo-hostprof.shmdump

    6. \SHMDUMP\coreinfo-pmtcon_m.shmdump

    7. \SHMDUMP\coreinfo-pmtcon_a.shmdump

    Shared memory information

    \USERDUMP\*.dmp

    Dump files

    \embdbinfo\_JF*#1

    Detailed information about the embedded database

    \JP1BASE_INFO#2

    Detailed information about JP1/Base
    #1

    _JF* indicates an embedded database identifier (_JF0, _JF1, _JF2, and so on). A folder is created for each identifier.

    #2

    The detailed information about JP1/Base is created as data for the second physical hosts report, regardless of the data for physical hosts or logical hosts.

    #3

    If an external database is used, a directory is created for each scheduler service.

  • The data for third reports (%TEMP%\jp1ajs2\backlog\JP1_DEFAULT\JP1_DEFAULT_3rd)

    Name of folder or file containing collected data

    Description

    \ALLUSERSPROFILE\jobinf

    Folder containing information about jobs

For logical hosts:

  • The data for first reports (%TEMP%\jp1ajs2\backlog\logical-host-name\logical-host-name_1st)

    Name of folder or file containing collected data

    Description

    \jpomanevshow.txt

    Execution result of jpomanevshow.exe

    \ajsqlstatus.txt

    Execution result of ajsqlstatus.exe

    \ajsagtshow.txt

    Execution result of ajsagtshow.exe

    \ajsagtshow_e.txt

    Execution result of ajsagtshow.exe (-e option)

    \jajs_status.txt

    Execution result of jajs_status.exe

    \ajsprof_scheduler-service-name_agent_stat.txt#1

    Execution result of ajsprofstatus.exe (-t agent -s option)

    \ajsprof_scheduler-service-name_agent_def.txt#1

    Execution result of ajsprofstatus.exe (-t agent -p option)

    \ajsprof_scheduler-service-name_unit_stat.txt#1

    Execution result of ajsprofstatus.exe (-t unit -s option)

    \ajsprof_scheduler-service-name_unit_def.txt#1

    Execution result of ajsprofstatus.exe (-t unit -p option)

    \jajs_pmtcon_m.txt

    Execution result of jajs_pmtcon.exe (-m -v option)

    \jajs_pmtcon_a.txt

    Execution result of jajs_pmtcon.exe (-a -v option)

    \JP1AJS2_LOGICAL

    Folder containing log files

    \JP1BASE

    Folder containing JP1/Base log files

    \EMBDB\_JF*#2\conf

    Embedded database definition file

    \EMBDB\_JF*#2\spool

    Embedded database failure investigation file

    \EMBDB\_JF*#2\etc

    Other information related to the embedded database that is needed for investigation

    \sys\JP1AJS2

    System folder

    \tmp\schedule\pd*.trc

    Embedded database trace log

    \user_acl

    Folder containing user mapping and authentication settings files
    #1

    Information about all scheduler services on the host is collected.

    #2

    _JF* indicates an embedded database identifier (_JF0, _JF1, _JF2, and so on). A folder is created for each identifier.

  • The data for second reports (%TEMP%\jp1ajs2\backlog\logical-host-name\logical-host-name_2nd)

    Name of folder or file containing collected data

    Description

    1. \cmdatabase

    2. \database

    3. \embdatabase\_JF*#

    Database storage folders

    \SHMDUMP\ProgMon.shmdump

    Information about the shared memory for monitoring processing status

    \SHMDUMP\coreinfo-host.shmdump

    Information about the shared memory for the system management function

    \SHMDUMP\coreinfo-hostprof.shmdump_logical-host-name

    Information about the shared memory for the operation profile

    1. \SHMDUMP\coreinfo-pmtcon_m.shmdump

    2. \SHMDUMP\coreinfo-pmtcon_a.shmdump

    Information about the shared memory for the connection source restriction function

    \embdbinfo\_JF*#

    Detailed information about the embedded database
    #

    _JF* indicates an embedded database identifier (_JF0, _JF1, _JF2, and so on). A folder is created for each identifier.

  • The data for third reports (%TEMP%\jp1ajs2\backlog\logical-host-name\logical-host-name_3rd)

    Name of folder or file containing collected data

    Description

    \jobinf

    Folder containing information about jobs

To Page Top

Copyright (C) 2019, 2022, Hitachi, Ltd.

Copyright (C) 2019, 2022, Hitachi Solutions, Ltd.