7.9.3 Specifying the task to be executed in the Data maintenance (Asset Console) task

You must enable this task immediately after you set up the asset management server.

When information is updated, the Data maintenance (Asset Console) task updates other related information and deletes unnecessary information to maintain data integrity in the asset management database. You can also select for execution only those tasks that are necessary from among the ones that can be executed. For details about how to select the tasks to execute, see 7.9.3(3) Changing the tasks to be executed.

When you execute the Data maintenance (Asset Console) task, Hitachi recommends that you stop all Asset Console services, commands, and tasks.

To stop Asset Console services, stop the following services in the listed order:

World Wide Web Publishing Service or World Wide Web Publishing
Asset Console commands and tasks

When you use Asset Console after having executed the Data maintenance (Asset Console) task, start the services in the reverse of the order in which they were stopped.

Organization of this subsection

(1) Tasks to be executed in the Data maintenance (Asset Console) task
(2) Specifying options
(3) Changing the tasks to be executed
(4) Specification example of the tasks to be executed in the Data maintenance (Asset Console) task

(1) Tasks to be executed in the Data maintenance (Asset Console) task

Use the Data maintenance (Asset Console) task to execute the following procedures:

Deleting asset information, contract information, and volume contract information in Erase status

When asset information is deleted, the following related information is also deleted:

Hardware information, software information, network information, installed software information, patch information, virus definition information, transfer logs, related asset information, device and key link, and user and key link

When contract information is deleted, the following types of related information are also deleted:

Maintenance contract information, lease contract information, rental contract information, volume contract information, contract history, and contract asset history
Deleting information related to asset information in Restore, Scrap, or Pre-Scrap status

The following information is deleted:

Installed software information, patch information, virus definition information, and network information^#

The license key assigned to an asset is also released.

#: Only the IP address is deleted as network information.
Changing the group names, location names, and user names registered in the existing asset information according to the changes made to them in windows

This task reflects the group name, location, and user name changed in window operations onto the asset information and contract information, and a changed history is collected into a transfer log.
Setting the groups, locations, and user names corresponding to IDs in the asset information

If the asset information contains group IDs, location IDs, user IDs, administrator IDs, and administrator group IDs, but no corresponding groups, locations, user names, administrators, or administrator groups are set, the corresponding names are set.
Deleting unneeded IP address control information

The IP address control information of an unused IP address outside the range of IP group information is deleted.
Deleting installed software information for which no installed software name is registered
Deleting the association between the user and the software key information for licenses whose license category is not User license
Deleting the association between the hardware asset information and the software key information for licenses whose license category is not Install license
Combining the license count and the license keys if a transferred license has the same Group ID and Asset No. as an existing license

This operation targets licenses whose software status is Active.
Deleting the installed software information of the software whose management level is set to Unused
Deleting group- or location-specific IP groups from which the corresponding groups or locations have been deleted
Registering the group that corresponds to the IP address in the hardware asset information in Group in the asset information

For the correspondence between IP addresses and groups, the IP group settings created by the IP Group job menu are used. By default, this task is not set to be executed.
Registering the location that corresponds to the IP address in the hardware asset information in Location in the asset information

For the correspondence between IP addresses and locations, the IP group settings created by the IP Group job menu are used. By default, this task is not set to be executed.
Deleting file attachments that do not have corresponding information (hardware asset information, device catalog, contract information, contract history, volume contract, software asset information, or maintenance history)
Deleting related asset information that does not have target asset information
Deleting division information set for groups that no longer exist

To Page Top

(2) Specifying options

In the Data maintenance (Asset Console) task, you can use an option to specify and execute the processing in the [MAINTE_n] section described in the settings file (taskopt.ini).

To specify an option, display the task properties. On the Task tab, specify the option after the file name in Run.

Format

-s OPT=section-to-be-executed

For the section to be executed, specify a single alphanumeric character (0 to 9 or a to z) to indicate one of the [MAINTE_n] sections described in the taskopt.ini file. The section name is not case-sensitive.

Specification example

"C:\jp1asset\exe\jamscript.exe"

-f "C:\jp1asset\scriptbatch\DataMaintenance.txt" -dp

-s OPT=1

C:\jp1asset indicates the Asset Console installation folder.

To Page Top

(3) Changing the tasks to be executed

To change the task to be executed in the Data maintenance (Asset Console) task, describe the task to be changed in the settings file (taskopt.ini). Specify in different sections the tasks to be normally executed and those that are to be executed when options are specified.

The storage destination and the coding method for the settings file are described below.

Settings file storage destination

Asset-Console-installation-folder\env

A settings file sample file (taskopt.org) is provided in the above folder so that it can be referenced when creating a settings file. Modify the sample to create a settings file.

Settings file (taskopt.ini) coding method

Figure 7‒10: taskopt.ini coding method

[DATAMAINTENANCE]

Describe the variable name and specification value that correspond to the task to be changed.

To change the basic execution content of the Data maintenance (Asset Console) task, describe the change in this section. The content described here is enabled even when no option is specified. Even when an option is specified, the content described here is enabled if it does not overlap the processing in the section in which the option is specified.

Tasks not described in this section are executed according to the default settings.

[MAINTE_n]

Describe the variable name and specification value that correspond to the task to be changed.

To change the execution content of the Data maintenance (Asset Console) task to match various purposes, describe the changes in separate sections. Specify the section names using the [MAINTE_n] format. For n, specify a single alphanumeric character (0 to 9 or a to z). The section name is not case-sensitive. When specifying an option, you can select the execution content by specifying the character specified for n.

Tasks not described in this section are executed according to the settings in the [DATAMAINTENANCE] section.

The table below shows the variable names, processing content, specification values, and default values to be described for the individual sections. Variable names and default values are described in taskopt.org stored in the same folder as taskopt.ini.

Table 7‒13: Variable names to be specified in taskopt.ini
Processing content	Variable name	Specification value	Default
Deleting asset information and related information for devices in Erase status.	`ASSET_ERASE_DEL`	`YES` Deletes. `NO` Does not delete.	`YES`
Deleting information related to devices in Restore, Scrap, or Pre-Scrap status.	`ASSET_ASSOC_DEL`	`YES` Deletes. `NO` Does not delete.	`YES`
Deleting asset information and related information for software in Erase status.	`SOFTINFO_ERASE_DEL`	`YES` Deletes. `NO` Does not delete.	`YES`
Deleting information related to software in Restore or Scrap status.	`SOFTINFO_ASSOC_DEL`	`YES` Deletes. `NO` Does not delete.	`YES`
Deleting contract information in Erase status.	`CONTRACT_ERASE_DEL`	`YES` Deletes. `NO` Does not delete.	`YES`
Deleting volume contract information in Erase status.	`VOLUME_ERASE_DEL`	`YES` Deletes. `NO` Does not delete.	`YES`
Changing the user name registered in the existing asset information according to the user name changed in a window operation. Setting the user name that corresponds to an ID in the asset information.	`USER_ASSOC_UPD`	`YES` Updates. `NO` Does not update.	`YES`
Changing the group name registered in the existing asset information according to the group name changed in a window operation. Setting the group name that corresponds to an ID in the asset information.	`GROUP_ASSOC_UPD`	`YES` Updates. `NO` Does not update.	`YES`
Changing the location registered in the existing asset information according to the location changed in a window operation. Setting the location that corresponds to an ID in the asset information.	`LOCATION_ASSOC_UPD`	`YES` Updates. `NO` Does not update.	`YES`
Deleting unnecessary IP address management information.	`IP_UNNECESSARY_DEL`	`YES` Deletes. `NO` Does not delete.	`YES`
Deleting installed software information for which no installed software name is registered.	`INSTINFO_NOLIST_DEL`	`YES` Deletes. `NO` Does not delete.	`YES`
Deleting the association between the user and the software key information for licenses whose license category is not User license. Deleting the association between the hardware asset information and the software key information for licenses whose license category is not Install license.	`LICENSELINK_UNNECESSARY_DEL`	`YES` Deletes. `NO` Does not delete.	`YES`
Combining the license count and the license keys if a transferred license has the same Group ID and Asset No. as an existing license.	`SOFTINFO_CONSOLIDATE`	`YES` Combines. `NO` Does not combine.	`YES`
Deleting the installed software information of the software whose management level is set to Unused.	`INSTINFO_UNMANAGED_DEL`	`YES` Deletes. `NO` Does not delete.	`YES`
Deleting group- or location-specific IP groups from which the corresponding groups or locations have been deleted.	`IPGROUP_NOOBJECT_DEL`	`YES` Deletes. `NO` Does not delete.	`YES`
Registering, in Group in the asset information, the group that corresponds to the IP address in the hardware asset information.	`IP_GROUP_ASSOC`	`NO` Does not register. `OVERWRITE`^# Always overwrites with the group assigned from the IP address. `YES` Follows Settings for a group that uses a group-specific IP group in the Server Setup dialog box.	`NO`
Registering, in Location in the asset information, the location that corresponds to the IP address in the hardware asset information.	`IP_LOCATION_ASSOC`	`NO` Does not register. `OVERWRITE`^# Always overwrites with the group assigned from the IP address. `YES` Follows Settings for a location that uses a location-specific IP group in the Server Setup dialog box.	`NO`
Deleting file attachments that do not have corresponding information.	`ATTACHFILE_DEL`	`YES` Deletes. `NO` Does not delete.	`YES`
Deleting related asset information that does not have an asset ID of asset information that matches the child asset ID of the related asset information.	`RELATION_NOOBJECT_DEL`	`YES` Deletes. `NO` Does not delete.	`YES`
Deleting division information set for groups that no longer exist.	`DIVISIONINFO_NOOBJECT_DEL`	`YES` Deletes. `NO` Does not delete.	`YES`

#: Overwrites even when a value acquired from the JP1/IT Desktop Management 2 - Manager management information or a value entered in the New Device window or the Device Details dialog box is set. Specify this task when you want to update all group names and locations according to the setting in the IP Group job menu.

To Page Top

(4) Specification example of the tasks to be executed in the Data maintenance (Asset Console) task

In this example, only the necessary tasks are executed and the task execution interval is changed according to the task content of each task.

The following tasks are to be executed in the Data maintenance (Asset Console) task at the intervals described:

Only the tasks of deleting devices in Erase status, deleting software in Erase status, and deleting software in Restore or Scrap status are to be executed every day.
Only the task of deleting unnecessary IP addresses is executed once a week.

taskopt.ini specification:

[DATAMAINTENANCE]
ASSET_ERASE_DEL               = NO
ASSET_ASSOC_DEL               = NO
SOFTINFO_ERASE_DEL            = NO
SOFTINFO_ASSOC_DEL            = NO
CONTRACT_ERASE_DEL            = NO
VOLUME_ERASE_DEL              = NO
IP_UNNECESSARY_DEL            = NO
INSTINFO_NOLIST_DEL           = NO
LICENSELINK_UNNECESSARY_DEL   = NO
INSTINFO_UNMANAGED_DEL        = NO
USER_ASSOC_UPD                = NO
GROUP_ASSOC_UPD               = NO
LOCATION_ASSOC_UPD            = NO
SOFTINFO_CONSOLIDATE          = NO
 
[MAINTE_1]
ASSET_ERASE_DEL               = YES
SOFTINFO_ERASE_DEL            = YES
SOFTINFO_ASSOC_DEL            = YES
 
[MAINTE_2]
IP_UNNECESSARY_DEL            = YES

Option specification:

Specify the options for the Data maintenance (Asset Console) task as shown below. C:\jp1asset indicates the Asset Console installation folder.

"C:\jp1asset\exe\jamscript.exe"

-f "C:\jp1asset\scriptbatch\DataMaintenance.txt" -dp

-s OPT=1

Next, copy the Data maintenance (Asset Console) task and specify options as follows.

"C:\jp1asset\exe\jamscript.exe"

-f "C:\jp1asset\scriptbatch\DataMaintenance.txt" -dp

-s OPT=2

Make a change so that the added task is executed once a week. For the procedure for changing the task execution dates and frequency, see 7.9.2 Task setup procedure.

To Page Top