HCL Workload Automation, Version 9.4

Configuring properties of the Resource advisor agent [ResourceAdvisorAgent]

About this task

In the JobManager.ini and JobManagerGW.ini files, the section containing the properties of the Resource advisor agent is named:
[ResourceAdvisorAgent]
You can change the following properties:
BackupResourceAdvisorUrls
The list of URLs returned by the HCL Workload Automation master in a distributed environment or by the dynamic domain manager either in a z/OS or in a distributed environment. The agent uses this list to connect to the master or dynamic domain manager.
CPUScannerPeriodSeconds
The time interval that the Resource advisor agent collects resource information about the local CPU. The default value is every 10 seconds.
FullyQualifiedHostname
The fully qualified host name of the agent. It is configured automatically at installation time and is used to connect with the master in a distributed environment or with the dynamic domain manager in a z/OS or in a distributed environment. Edit only if the host name is changed after installation.
NotifyToResourceAdvisorPeriodSeconds
The time interval that the Resource advisor agent forwards the collected resource information to the Resource advisor. The default (and maximum value) is every 180 seconds.
ResourceAdvisorUrl
JobManager.ini
The URL of the master in a distributed environment, or of the dynamic domain manager in a z/OS or in a distributed environment, that is hosting the agent. This URL is used until the server replies with the list of its URLs. The value is https://$(tdwb_server):$(tdwb_port)/JobManagerRESTWeb/JobScheduler/resource, where:
$(tdwb_server)
is the fully qualified host name of the master in a distributed environment or of the dynamic domain manager either in a z/OS or in a distributed environment.
$(tdwb_port)
is the port number of the master in a distributed environment or of the dynamic domain manager either in a z/OS or in a distributed environment.

It is configured automatically at installation time. Edit only if the host name or the port number are changed after installation, or if you do not use secure connection (set to http). If you set the port number to zero, the resource advisor agent does not start. The port is set to zero if at installation time you specify that you will not be using the master in a distributed environment or the dynamic domain manager either in a z/OS or in a distributed environment.

In a distributed environment, if -gateway is set to either local or remote, then this is the URL of the dynamic agent workstation where the gateway resides and through which the dynamic agents communicate. The value is https://$(tdwb_server):$(tdwb_port)/ita/JobManagerGW/JobManagerRESTWeb/JobScheduler/resource, where:
$(tdwb_server)
The fully qualified host name of the dynamic agent workstation where the gateway resides and through which the dynamic agent communicates with the dynamic workload broker.
$(tdwb_port)
The port number of the dynamic agent workstation where the gateway resides and through which the dynamic agent communicates with the dynamic workload broker.
JobManagerGW.ini
In a distributed environment, if -gateway is set to local, then ResourceAdvisorUrl is the URL of the master or dynamic domain manager. The value is https://$(tdwb_server):$(tdwb_port)/JobManagerRESTWeb/JobScheduler/resource, where:
$(tdwb_server)
The fully qualified host name of the master or dynamic domain manager.
$(tdwb_port)
The port number of the master or dynamic domain manager.
ScannerPeriodSeconds
The time interval that the Resource advisor agent collects information about all the resources in the local system other than CPU resources. The default value is every 120 seconds.

The resource advisor agent, intermittently scans the resources of the machine (computer system, operating system, file systems and networks) and periodically sends an update of their status to the master or dynamic domain manager either in a z/OS or in a distributed environment.

The CPU is scanned every CPUScannerPeriodSeconds seconds, while all the other resources are scanned every ScannerPeriodSeconds seconds. As soon as one of the scans shows a significant change in the status of a resource, the resources are synchronized with the master in a distributed environment or the dynamic domain manager either in a z/OS or in a distributed environment. The following is the policy followed by the agent to tell if a resource attribute has significantly changed:
  • A resource is added or deleted
  • A string attribute changes its value
  • A CPU value changes by more than DeltaForCPU
  • A file system value changes by more than DeltaForDiskMB megabytes
  • A Memory value changes by more than DeltaForMemoryMB megabytes

If there are no significant changes, the resources are synchronized with the HCL Workload Automation master in a distributed environment or with thedynamic domain manager either in a z/OS or in a distributed environment every NotifyToResourceAdvisorPeriodSeconds seconds.