5.6.1 Notes on when there is a link with JP1/AJS
-
Execute the jddcreatetree command while the JP1/AJS3 - Manager host is not running any job. If the jddcreatetree command is executed while a job is running, both command and job processes impose a load on the system, causing them to potentially be delayed.
If jobs are always running, then execute the jddcreatetree command when the number of executed jobs is small, so that the command execution causes less impact on business operations. In addition, verify the execution in your development environment sufficiently to make sure there is no problem with each of the processes.
-
The jddcreatetree command can collect information from JP1/AJS3 - Manager hosts for a maximum of 60 minutes. A timeout occurs when 60 minutes is reached and the command can no longer collect the information. If it takes 60 minutes or more to collect the information and then a timeout occurs, the IMDDAdapter_HITACHI_JP1_AJS3 adapter command process, which is responsible for information collection, might be kept running on the JP1/AJS3 - Manager host. As two adapter commands cannot be executed at once, you need to terminate the IMDDAdapter_HITACHI_JP1_AJS3 process by using the following method on the JP1/AJS3 - Manager host, if you collect the information again:
- In Windows
-
Use Task Manager to terminate the process.
- In UNIX
-
Use the kill command to terminate the process.
Then, adjust how your units are configured and the number of jobnets registered for execution so that the collection time is less than or equal to 60 minutes, and re-execute the jddcreatetree command.
-
The jddcreatetree command does not collect unit information from:
-
Manager job group
-
Manager jobnet
-
Recovery manager jobnet
-
Remote jobnet and its underlying units
-
Recovery remote jobnet and its underlying units
-
JP1 event sending job in which queueless is specified for its execution service, and units with wait conditions
-
JP1 event reception monitoring job and JP1 event sending job that are defined in the same level as a root jobnet
-
Root jobnet not registered for execution and its underlying units
-
-
Execution of an adapter command running on a JP1/AJS3 - Manager host cannot be cancelled from a JP1/IM - Manager host. To cancel it, on the JP1/AJS3 - Manager host, use the following method to terminate the IMDDAdapter_HITACHI_JP1_AJS3 process:
- In Windows
-
Use Task Manager to terminate the process.
- In UNIX
-
Use the kill command to terminate the process.
-
A single JP1/AJS3 - Manager host can collect information from up to 400,000 units. If the number of units exceeds 400,000, the jddcreatetree command fails with message KAJY04260-E and the configuration management tree is not updated. You can estimate the number of units by executing the following commands on the JP1/AJS3 - Manager host:
- In Windows
-
Total number of rows obtained by executing the following commands:
ajsname -F scheduler-service-name -R -E "/"
ajsname -F scheduler-service-name -R -G "/"
- In UNIX
-
Total number of rows obtained by executing the following commands:
/opt/jp1ajs2/bin/ajsname -F scheduler-service-name -R -E "/"
/opt/jp1ajs2/bin/ajsname -F scheduler-service-name -R -G "/"
-
If environment settings parameter ADMACLIMIT is set to yes on the JP1/AJS3 - Manager host, the jddcreatetree command might fail to collect information. Use the following corrective action to make a configuration so that the information can be collected before operation:
- In Windows
-
Set environment settings parameter ADMACLIMIT to no or remove the parameter to disable the function.
On the JP1/AJS3 - Manager host, register a JP1 user named system add one of the following JP1 permission levels to the user:
Or, on the JP1/AJS3 - Manager host, register a JP1 user named SYSTEM and add one of the following JP1 permission levels to the user:
- JP1_AJS_Admin permission
- JP1_AJS_Manager permission
- JP1_AJS_Editor permission
- JP1_AJS_Operator permission
- JP1_AJS_Guest permission
- In UNIX
-
Set environment settings parameter ADMACLIMIT to no or remove the parameter to disable the function.
Or, on the JP1/AJS3 - Manager host, register a superuser as a JP1 user and add one of the following JP1 permission levels to the user:
- JP1_AJS_Admin permission
- JP1_AJS_Manager permission
- JP1_AJS_Editor permission
- JP1_AJS_Operator permission
- JP1_AJS_Guest permission
-
If information, such as a unit name, unit definition, execution agent name, or JP1 resource group name, collected by the jddcreatetree command contains a control character, the command might fail to collect the information. Avoid using any control character in the information if it is to be collected.
-
If the system time on the JP1/AJS3 manager host of the trend information acquisition destination is set back#, and the time recorded in duplicate in the performance log files due to the system time change overlaps with the specified start or end time for the trend information display period, only part of the duplicate record in the performance log file might be displayed. If so, it might be possible to avoid this issue by one of the following methods.
-
Wait before displaying again
-
Change the periods before displaying again
-
If you perform the above workarounds but the record in the performance log files is not output correctly, perform the following methods.
-
Execute the ajsreport command on the JP1/AJS3 manager host of the trend information acquisition destination. For details on trend information metrics and the item list that is output in the performance reports by ajsreport command, see 2.7.1 Metrics that can be retrieved from JP1/AJS in the JP1/Integrated Management 3 - Manager GUI Reference.
-
-
Consider deleting the performance log files. To delete the performance log files, you will need to stop the scheduler service of the JP1/AJS3 manager host of the trend information acquisition destination. For details, see the JP1/Automatic Job Management System 3 manual.
# This applies if the prerequisites for the trend information display function are not met, or if the system time is set back while the JP1/AJS3 services on the JP1/AJS3 manager host of the trend information acquisition destination are stopped. To set back the system time while the JP1/AJS3 services are stopped, see the JP1/Automatic Job Management System 3 Administration Guide, and delete the performance log files.
-
If the jddcreatetree command is used to obtain information from a target JP1/AJS3 - Manager host of version 12-50 or later, make sure that the JP1/AJS3 - Manager host as the information acquisition target can resolve the agent host name as the job execution destination, before you execute the jddcreatetree command.