Job Management Partner 1/Asset Information Manager Administrator's Guide

[Contents][Glossary][Index][Back][Next]

2.7.2 Totaling operation logs (Operation Log Total)

By using the Operation Log Total job menu, you can check the status for each group based on operation log totals. You can check how often an operation such as copying of files to external media has occurred or how the number of detected operation logs has changed over time.

By default, only an administrator can total operation logs.

You check operation log totals from the Operation Log Total window, which you display by clicking the Operation Log Total job menu. The following figure shows the Operation Log Total window.

Figure 2-85 Operation Log Total window

[Figure]

To insure that you acquire correct totals, make sure that operation logs have been accurately collected from the managed clients.

Before you can check the totals from the Operation Log Total window, you must execute the jamOperationLogAddUp command to collect operation logs. For details about how to execute the jamOperationLogAddUp command, see (5) Executing the jamOperationLogAddUp command (operation log totaling).

Organization of this subsection
(1) Specifying conditions and displaying totals
(2) Displaying a breakdown by group
(3) Displaying operation logs
(4) Displaying the operation log totals in graph format
(5) Executing the jamOperationLogAddUp command (operation log totaling)

(1) Specifying conditions and displaying totals

You can check operation log totals by specifying the desired search conditions and clicking the Search button. For Search period, specify the period over which you want to check totals. Specify a search period of one year or less. You must always specify a start date for Search period. If you do not specify an end date for Search period, the date the search is performed is assumed to be the search period end date.

How to interpret the search results

If you change the group information or IP group information after you total the operation logs, the information you changed is not updated in the totals.

(2) Displaying a breakdown by group

By selecting a radio button under Search pattern in the search results of the Operation Log Total window, and then clicking the Show or Show Total button, you can display totals for the group specified in the search conditions. If you click the Show button, the totals for the specified group are displayed. If you click the Show Total button, the totals for its subgroups are also displayed.

The following figure shows the window that displays a breakdown by group.

Figure 2-86 Window that displays a breakdown by group (Show Total)

[Figure]

Totaled results for managed devices whose asset information is not in the asset management database are displayed as Unknown devices.

(3) Displaying operation logs

You can check the operation logs for a particular date in the Operation Log Total - Logs List dialog box, which you display by clicking a date link in the window that displays a breakdown by group.

The following figure shows the Operation Log Total - Logs List dialog box.

Figure 2-87 Operation Log Total - Logs List dialog box

[Figure]

You can check details about the operation logs for each device in the Operation Log Details dialog box, which you display by clicking an link under Date/time. For details about how to check operation log details, see 2.7.1(3) Checking operation log details for each device.

You can check details about a device by clicking a link under Host name. For details about how to check details for devices, see 2.7.1(4) Checking the asset information of a device.

You can trace user operations from the File Operation Trace dialog box, which you display by clicking a link under File name. For details about how to trace user operations, see 2.7.3 Tracing user operations.

(4) Displaying the operation log totals in graph format

In the window that displays a breakdown by group, select the check boxes of the groups for which you want to display totals in graph format, and then click the Graph button to display the Operation Log Total - Changes window. In the Operation Log Total - Changes window, you can see in graph format the change in the number of the applicable operation logs. You can select up to 255 groups to graph in this manner.

To display the operation log totals as a graph, you must install the Microsoft Office Web component on the PC on which the graph is to be displayed. Either install the Microsoft Office Web component from the Microsoft Office 2003 (or earlier) media, or download it from Microsoft's website.

The following figure shows the Operation Log Total - Changes window.

Figure 2-88 Operation Log Total - Changes window

[Figure]

(5) Executing the jamOperationLogAddUp command (operation log totaling)

This subsection describes the function, format, options, and return values of the jamOperationLogAddUp command, which is used to total operation logs, and provides notes on its command execution, followed by two execution examples. This subsection also explains the settings required to register a task in Windows Task Scheduler for the purpose of executing the jamOperationLogAddUp command on a regular basis.

The command's executable file is stored in the following folder:

Asset-Information-Manager-installation-folder\exe

Note
When you use Asset Information Manager in a 64-bit OS, you must execute it from the 32-bit command prompt. For details about how to perform this procedure, see F(2) Notes on executing commands and tasks in a 64-bit OS in the Planning and Setup Guide.
(a) Function

This command totals operation logs.

(b) Format
jamOperationLogAddUp -p "search-pattern"
[-s base-point-day-for-totaling-data]
[-d number-of-days-for-which-data-is-to-be-totaled]
[-k number-of-days-for-retaining-totaled-results]
(c) Options

-p "search-pattern"
Specifies the search pattern to use as the search condition. You must specify a search pattern that is registered. This option must always be specified. You can specify more than one search pattern. To do so, insert a space between the search patterns, as in -p "Copy detections" "Site inspections" "Program start preventions".
If the search pattern contains a double quotation mark ("), add two additional ones. For example, if the search pattern is "copy to removable", specify -p """copy to removable""".

-s base-point-day-for-totaling-data
Specifies the base day for totaling operation logs (base-point day for totaling data) in the format -s yyyymmdd, where yyyy is an integer between 2000 and 9999. If you have previously totaled data in the period beginning one or more days following this base-point day for totaling data, those totals are deleted. You can omit this option. If omitted, the day before the command is executed is assumed as the base-point day for totaling data.

-d number-of-days-for-which-data-is-to-be-totaled
Specifies x number of days counting from the base-point day for totaling data as the totaling period in the format -d Dx, where x is an integer between 0 and 2192. This specification totals x + 1 days' worth of data, including the operation logs on the base-point day for totaling data. You can omit this option. If omitted, data is totaled over the period beginning six days before the base-point day for totaling data. For example, if the base-point day for totaling data is May 4th, specify -d D3 to total data over the period beginning three days earlier (from May 1st).

-k number-of-days-for-retaining-totaled-results
Specifies y number of days counting from the base-point day for totaling data as the maximum number of days to retain totals in the format -k Dy, where y is an integer between 0 and 2192. This specification deletes totals prior to the indicated day. The value specified for number-of-days-for-retaining-totaled-results must be greater than the value specified for number-of-days-for-which-data-is-to-be-totaled. This option can be omitted. If omitted, totals beginning from six days before the base-point day for totaling data are retained, and totals prior to that are deleted.
Note that specifying a very large value for number-of-days-for-retaining-totaled-results increases the size of the asset management database. Before you specify this value, carefully consider how long you need to retain these totals.
(d) Return values

This command returns the following values:

Return value Description
0 Normal termination.
1 Normal termination (no totaled results).
2 Invalid parameter.
3 No corresponding search pattern exists.
4 An error occurred while connecting to JP1/Software Distribution.
6 Invalid environment.
7 A DLL load error occurred.
8 An error occurred in the operation log totaling function.
9 An error occurred while acquiring registry information.
10 An error occurred while jamscript.exe was executing.
(e) Notes on command execution
(f) Execution examples

Execution example 1
jamOperationLogAddUp - p "Site inspections" -d D2 -k D6
In this example, operation logs are totaled beginning from two days before the base-point day for totaling data, which is assumed to be the day before the command is executed. Additionally, totals prior to six days before the base-point day for totaling data are deleted.
For example, if the command is executed on May 10th, operation logs are collected for a period of three days, from May 7th to May 9th, and totals prior to May 3rd are deleted.
The following figure shows the processing details for execution example 1.

Figure 2-89 Processing details for execution example 1

[Figure]

Execution example 2
jamOperationLogAddUp - p "Site inspections" -d D2 -k D3
This example describes a situation in which the totaling period overlaps a previous totaling period.
For example, if the first time the command is executed to total data is on May 10th, three days' worth of operation logs would be collected, from May 7th to May 9th. If the second time the command is executed to total data is May 12, the three days' worth of operation logs that are collected would be from May 9th to May 11th. So, the second time the command is executed, the previous totals from May 9th would be overwritten, and totals prior to May 8th would be deleted. This means that totals from May 7th collected the first time the command was executed would be deleted.
The totaled results that would remain are the totaled results from May 8th, collected the first time the command was executed, and the totaled results from May 9th to May 11th, collected the second time the command was executed.
The following figure shows the processing details for execution example 2.

Figure 2-90 Processing details for execution example 2

[Figure]
(g) Setting up the jamOperationLogAddUp (operation log totaling) command to execute on a regular basis

By registering the jamOperationLogAddUp command as a task in Windows Task Scheduler, you can set up the command to execute on a regular basis. To register the command as a task, in the Task tab of the task's Properties dialog box, add the following line in the Run text box:

-f Asset-Information-Manager-installation-folder\exe\jamOperationLogAddUp-command-execution-format

jamOperationLogAddUp-command-execution-format is the format that is described in (b), above.