Specifying the task to be executed in the Data maintenance task

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

When information is updated, the Data maintenance 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 (3) Changing the tasks to be executed.

When you execute the Data maintenance task, Hitachi recommends that you stop all Asset Information Manager services, commands, and tasks.

To stop Asset Information Manager services, stop the following services in the order indicated below:

World Wide Web Publishing Service or World Wide Web Publishing
Asset Information Synchronous Service, Asset Information Manager commands, and tasks
JP1/Client Security Control - Manager (when JP1/CSC is linked)

When you use Asset Information Manager after having executed the Data maintenance task, start the services in the reverse order from the order in which they were stopped.

Organization of this subsection: (1) Tasks to be executed in the Data maintenance task; (2) Specifying options; (3) Changing the tasks to be executed; (4) Specification example of the tasks to be executed in the Data maintenance task

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

Use the Data maintenance 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 log, component information, 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, component 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 (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.

(2) Specifying options

(3) Changing the tasks to be executed

To change the task to be executed in the Data maintenance 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-Information-Manager-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 5-16 taskopt.ini coding method

[Figure]

[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 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 task according to 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 5-28 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 the group that corresponds to the IP address in the hardware asset information in Group in the 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 the location that corresponds to the IP address in the hardware asset information in Location in the 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/Software Distribution user inventory 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.

(4) Specification example of the tasks to be executed in the Data maintenance 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 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:

Specifies options for the Data maintenance task as shown below. C:\jp1asset indicates the Asset Information Manager installation folder.

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

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

-s OPT=1

Next, copy the Data maintenance task and specify options as follows.

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

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

-s OPT=2

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

5.9.3 Specifying the task to be executed in the Data maintenance task

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

(2) Specifying options

(3) Changing the tasks to be executed

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