8.9.3 Task log details

To the task log, JP1/AO outputs information about tasks starting and stopping, called plug-ins, return values of plug-ins, and other activity.

JP1/AO creates a task log folder for each task it executes. You can view and download the contents of the task log from the Task Details dialog box in the Tasks tab.

You can specify the maximum size (in KB) of the task log file in the user-specified properties file (config_user.properties). If the task log file size exceeds the maximum value, task log data is overwritten from the oldest data.

Organization of this subsection

(1) Name and output location of task log files
(2) Information output to task log
(3) Task log output levels

(1) Name and output location of task log files

The name and location of task log files are as follows:

In Windows

JP1/AO-installation-folder\data\task\task-ID\task_task-ID_1.log

In a cluster environment, interpret JP1/AO-installation-folder as shared-folder-name\jp1ao.
In Linux

/var/opt/jp1ao/data/task/task-ID/task_task-ID_1.log

In a cluster environment, interpret /var/opt/jp1ao as shared-folder-name/jp1ao.

To Page Top

(2) Information output to task log

The table below shows the information output to the task log, followed by an example of a task log entry.

Table 8‒4: Contents of task log
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 operations	`message-ID` Task execution was stopped. `message-ID` Task execution was forcibly stopped. `message-ID` The task was retried from the failed step. `message-ID` The task was retried from the step after the failed step.
--	Messages related to debug operations	`message-ID` Processing stopped before (or after) execution of plug-in processing. `message-ID` Plug-in processing was resumed. `message-ID` Changes were applied to plug-in properties. `message-ID` Changes were applied to plug-in return values.

Legend:: --: Output when a failure occurs, or when a task or debug operation is performed.

The following is an example of task log output:

KNAE08001-I Plug-in execution started (Task name: JP1/AJS root jobnet migration_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 list of JP1/Cm2 monitored nodes,Task ID:3969,Step ID:/getNodeListFileJP1Cm2,Execution ID:@A105,Plug-in return value:0).

To Page Top

(3) Task log output levels

You can set the output level for task logs in a Service Share Property.

The output level setting determines what information is output to the task log. The following table describes the information output at each output level:

Table 8‒5: Task log output levels
Output level	Output information								Task-related	Debugger function	Description
Output level	Error information	Basic information	Plug-in definitions (before plug-in execution)	Properties (before plug-in execution)	Plug-in definition (after plug-in execution)	Properties (after plug-in execution)	Standard output	Debug information	Task-related	Debugger function	Description
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 all information except 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 except plug-in definitions (after plug-in execution) for debugging purposes.

Legend:

Y: Output according to the log level of the message when an event occurs that generates message output.

N: Not output.

Y/N: Output when the return value of the plug-in is other than 0.

#

When the data type of the property is password, ******** is output as the property value.

When the value of a property with the Composite data type is 4,097 characters or longer, an ellipsis (...) replaces the 4,097th and subsequent characters.