5.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 (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
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
(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.
(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 5‒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 5‒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.
(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 5.9.2 Task setup procedure.