Job Output Variables
To use a job's return variables in other jobs, the agent administrator must set the agent.manager.variables.allow parameter to True in the agentparm.txt file. However, the agent administrator does not have to set this parameter for CPU Monitoring and Disk Monitoring jobs.
For example, suppose that a payroll processing application comprises three jobs: the first job calculates the employee's gross pay, the second job calculates the tax deduction, and the third job calculates the employee's contribution to charity. The second job uses the employee's gross pay returned by the first job to calculate the tax deduction. The third job uses the tax amount returned by the second job to calculate the employee contribution to charity.
The return value variable names have the following format:
For example, a variable name could be APPL.agent_os_purchase_order_num, where APPL is the context name, agent is the job name, os is the qualifier, and purchase_order_num is the return value variable ID.
- job_nameandjob_qualifierare in lowercase.
- Periods (.) are replaced with underscores (_) in return variable names.
- All return variable names start with APPL because variables are resolved in the Application context.
The following table lists the return value names of each job type that creates output variables:
Return value names
<stored procedure output parameters>
<selected column names>
<SNMP variable OIDs>
<updated variable SNMP OID>
JMX-MBean Attribute Get
JMX-MBean Attribute Set
Example: Return Variables from a CPU Monitoring Job
The following example shows the return variables from a CPU Monitoring job.
To return values from a CPU Monitoring job
- EnterCPUMonitor0in the Name field of the Basic page.
- Select the Return immediately option button from the Wait mode section.
- Select the Within option button from the Range section.
- Select the Available option button from the Monitor when CPU percentage section.
- Click OK.The CPU Monitoring job return variables are as follows:
Example: Return Variables from a JMX-MBean Attribute Get Job
The following example shows the return variables from a JMX-MBean Attribute Get job.
To return values from a JMX-MBean Attribtue Get job
- Enter the following information in the Basic page:
- URL —service:jmx:rmi:///jndi/rmi://localhost:9999/server
- MBean— config
- Attribute— cachesize
- Click OK.The JMX-MBean Attribute Get job return variables are as follows:
- APPL. jmxmbeanattrget0_variable_jmx_mbeanattr
Special considerations apply to DB Stored Procedure, SQL, SNMP Value Get, and SNMP Value Set jobs because they do not have fixed names for all return values.