13.9.3 Task log details
JP1/AO outputs information about tasks starting and stopping, called plug-ins, and other activity to the task log.
When you execute a task, JP1/AO creates a folder to which the log information for that task is output. You can see or download the task log file in the Tasks view, Task Details dialog box, and Debug-Tasks view.
You can specify the maximum task log size value (KB) of the task log file size section of the property file (config_user.properties). If the task log file size exceeds the maximum value, task log data is overwritten from the oldest.
- Organization of this subsection
(1) Name and location of task log files
The name and location of the task log file are as follows:
-
JP1/AO-installation-folder\data\task\task-ID\task_task-ID_1.log
In a cluster environment, replace JP1/AO-installation-foder with shared-folder-name\jp1ao.
(2) Information output to task log
The following shows the information output to the task log, and shows an example of a task log entry.
|
Output sequence |
Type |
Example message |
|---|---|---|
|
1 |
Basic information |
message-ID Plug-in execution has started. |
|
2 |
Plug-in definition |
message-ID Plug-in definition information |
|
3 |
Property (before plug-in execution) |
message-ID Property information at plug-in execution |
|
4 |
Basic information |
message-ID Plug-in execution has completed. |
|
5 |
Property (after plug-in execution) |
message-ID Property information after plug-in execution |
|
6 |
Standard output |
Standard output of plug-in execution results |
|
-- |
Error information |
message-ID An error occurred during plug-in execution. |
|
-- |
Debug information |
message-ID Arbitrary debug information |
|
-- |
Messages related to task operation |
|
|
-- |
Messages related to debug operation |
|
- Legend:
-
--: Output when a failure occurred, or task or debug operation was performed.
The following is an example of the information output to the task log:
KNAE08001-I Plug-in execution started (Task name: JP1/AJS root jobnet transition_multi_20131107141827, Task ID: 5859, Step ID: /getRootJobnetKeyList, Execution ID: @A571).
KNAE08005-I vendor=com.hitachi.software.dna.cts.jp1
KNAE08005-I name=osReadCSVExcelFileColumn
KNAE08005-I version=01.10.00
:
KNAE08006-I property=plugin.destinationHost, value=192.168.1.1
KNAE08111-I Remote command execution started.
KNAE08102-I Remote command execution succeeded (Command: osReadCSVExcelFileColumn.bat "C:\AJS.xlsx" "sheet 1" "1" "" "" "" "" 2>&1).
:
KNAE08010-I <Standard output (first line)>
KNAE08010-I <Standard output (second line)>
:
KNAE08010-I Standard output (nth line)>
KNAE08002-I Plug-in execution finished (Task name: Obtain JP1/Cm2 monitored node list, Task ID: 3969, Step ID: /getNodeListFileJP1Cm2, Execution ID: @A105, Plug-in retuen value: 0).
(3) Output levels for the task log
You can set the output level for the task log in a shared service property.
The output level setting determines the information output to the task log. The following table describes the information output to the task log at each output level.
|
Output level |
Output information |
Task related |
Debugger function |
Description |
|||||||
|---|---|---|---|---|---|---|---|---|---|---|---|
|
Error information |
Basic information |
Plug-in definition (before plug-in execution) |
Property (before plug-in execution) |
Plug-in definition (after plug-in execution) |
Property (after plug-in execution) |
Standard output |
Debug information |
||||
|
0 |
Y |
N |
N |
N |
N |
N |
N |
N |
N |
N |
Only error information is output. |
|
10 |
Y |
Y |
N |
N |
Y/N |
Y/N |
Y/N |
N |
Y |
Y |
When the return value of the plug-in is 0, JP1/AO outputs error information and basic information. When the return value of the plug-in is other than 0, JP1/ AO outputs error information, basic information, plug-in definitions (after plug-in execution), properties (after plug-in execution), and standard output. |
|
20 |
Y |
Y |
Y |
N |
N |
Y |
Y/N |
N |
Y |
Y |
When the return value of the plug-in is 0, JP1/AO outputs error information, basic information, plug-in definitions (before plug-in execution), and properties (after plug-in execution). When the return value of the plug-in is other than 0, JP1/AO outputs error information, basic information, plug-in definitions (before plug-in execution), properties (after plug-in execution), and standard output. |
|
30 |
Y |
Y |
Y |
Y # |
N |
Y # |
Y |
N |
Y |
Y |
JP1/ AO outputs information other than plug-in definitions (after plug-in execution) and debug information. |
|
40 |
Y |
Y |
Y |
Y # |
N |
Y # |
Y |
Y |
Y |
Y |
JP1/ AO outputs all information other than plug-in definitions (after plug-in execution) for debugging purposes. |
- Legend:
-
Y: Output according to the log level of the message when an occurrence subject to message output occurs.
N: Not output.
Y/N: Output when the plug-in return value is a value other than 0.
- #
-
When the data type of the property is password, ******** is output as the property value.
Related topics
(4) Plug-in return values output to task log files
Return values of plug-ins are output to task log files, but return values of the flow plug-in, interval plug-in, judge returncode plug-in, abnormal-end plug-in, and judge value plug-in are not output to task log files.
When a task is forcibly stopped, or a failure occurs, the return value of the plug-in to be output to the task log and the return value of the step displayed in the Task Details dialog box might be different. If this happens, take action according to the description for the return values of steps displayed in the Task Details dialog box.
Note that the judgment of the subsequent-step execution condition is performed according to the return values of steps.
Related topics
-
Overview of subsequent step conditions in the Job Management Partner 1/Automatic Operation Service Template Developer's Guide