Retrieving a List of Defined AutoSys Agent Machines

Products

• Autosys Workload Automation

Issue/Introduction

Users often need to obtain a comprehensive list of all agent machines configured within their AutoSys environment. This is essential for inventory management, troubleshooting, and understanding the scope of workload automation. This document outlines various methods to retrieve this list from AutoSys.

Environment

Product: AutoSys Workload Automation

Components: AutoSys Scheduler, Workload Control Center (WCC), AutoSys Web Services (AEWS)

Resolution

There are several methods to retrieve a list of all defined agent machines in your AutoSys environment: 

1. Using the autorep Command-Line Utility: 
You can use the autorep command to report on all machine definitions and then filter for those designated as agent machines. 
autorep -M ALL -q 

2. Leveraging WCC Agent Inventory: 
The Workload Control Center (WCC) provides an Agent Inventory interface that visually displays all configured/defined agents. 

3. Using AutoSys Web Services (AEWS): 
For programmatic access, you can query AEWS using curl to fetch agent machine definitions. 
Example: curl -X GET https://<hostname>.<example>.com:9443/AEWS/machine?filter=type==a -k --user "<id>:<password>" -i 
The filter=type==a parameter specifically requests only machine definitions where the type is 'a' (agent). 
* Replace <hostname>.<example>.com with the actual hostname of your AEWS instance.
* Replace <id>:<password> with your AEWS authentication credentials.

4. Inspecting Telemetry Files: 
While not a direct reporting method, the files located in $AUTOUSER/telemetry can contain information related to agent connectivity and definitions, which may be useful for investigation. 

Important Note on Licensing: 
The methods above will provide a list of defined agent machines. If you are seeking information related to actual licensing costs for your AutoSys agents, it is recommended to reach out directly to your Broadcom Account team. They have access to contract details and can provide accurate licensing information, which support personnel typically do not.