Overview

The z/OS Agent resource provides information about a Universal Agent for z/OS running on a z/OS platform.

To run a z/OS task, you need a z/OS Agent installed and running on the target machine.

z/OS Agent Details

z/OS Agent Details provide the information necessary for the scheduler to locate and communicate with the machine where the Agent resides. Universal Controller creates this record automatically when the Agent connects with the Controller.

To view z/OS Agent Details:

Step 1

From the Agents & Connections navigation pane, select Agents > z/OS Agents. The z/OS Agents list displays a list of connected z/OS Agents.

Note

You also can select Agents > All Agents from the Agents & Connections navigation pane to display a list of all connected Agents: Linux/Unix, Windows, and z/OS.

Step 2

Click the Details icon next to a Name or click anywhere in the Agent row to display Details for that agent.

Most fields are read-only; however, you can make the following changes:

Add a Member of Business Services.
Assign Credentials.
Change the heartbeat interval. The heartbeat is a status message sent from the Agent to the Controller.
Change the Log Level (default is Informational).
Select whether or not to apply a Task Execution Limit (and Limit Amount) on the Agent.

You also can choose to temporarily suspend the agent's ability to run tasks.

See the field descriptions, below, for details about all fields in the z/OS Agent Details.

z/OS Agent Details Field Descriptions

The following table describes the fields, buttons, and tabs in the z/OS Agent Details.

Field Name	Description
Configuration Details	This section contains detailed information about the configuration of the Agent.
Name	User-defined during installation; name used within the Controller to identify this Agent.
Agent ID	Unique ID for this Agent, created during installation.
Description	Description of this record. Maximum length is 255 characters.
Member of Business Services	User-defined; Allows you to select one or more Business Services that this record belongs to. (You also can Check All or Uncheck All Business Services for this record.) You can select up to 62 Business Services for any record type, and enter a maximum of 2048 characters for each Business Service. If the Business Service Visibility Restricted Universal Controller system property is set to true, depending on your assigned (or inherited) Permissions or Roles, Business Services available for selection may be restricted.
Status	System-supplied; status of the Agent.
Suspended	Indication that the Agent's ability to run tasks has been suspended.
Log Level	User-modifiable; level of logging that the Agent will perform. Note You cannot modify a Log Level from a non-active (Passive or Offline) mode. Modifying this field changes the log level of the messages that appear in the `agent.log` file. Options: Severe Error Errors Warning Informational Debug Trace Note A Trace file is not created when the Trace option is selected.
Retrieve Output Prohibited	If enabled, disallows any Retrieve Output request (automatic or manual) from being performed.
Heartbeat Interval	User-modifiable; heartbeat interval (in seconds). The heartbeat is a status message sent from the Agent to the Controller. If you change the heartbeat interval, it only affects new Agents that are registered after the change. It does not affect the heartbeat interval of existing Agents. Note You cannot modify a Heartbeat Interval from a non-active (Passive or Offline) mode.
Heartbeat Grace Period	User-modifiable; grace period, in seconds, that the Controller will allow for a delayed heartbeat message.
Task Execution Limit	Specification for whether a Limited or Unlimited number of task instances can be run concurrently on the Agent. (Default is Unlimited.) For purposes of imposing this task execution limit, running task instances are those in any of these statuses: Cancel Pending, Queued, Received, Running, Submitted, and Started.
Limit Amount	If Task Execution Limit = Limited; Number of tasks that can be running at the same time by the Agent.
Credentials Required	Specifies if credentials are required to execute any task on the agent.
Credentials	Credentials under which this Agent runs tasks. These credentials are overridden by any credentials provided in the task definition for any tasks being run by this Agent.
Installation Details	This section contains detailed information about the installation of the Agent.
Host Name	User-provided during installation; IP address or domain/name of the host machine where the resource resides.
IP Address	User-provided during installation; TCP/IP address of the machine where the Agent is running. If the currently logged in user is a non-Administrator /wiki/spaces/UC71x/pages/5179605) user, and the /wiki/spaces/UC71x/pages/5177877 Universal Controller system property is set to true, the IP Address field will display ***** instead of the actual value. Note This also applies to the ipAddress of /wiki/spaces/UC71x/pages/5177563.
Operating System	System-supplied; operating system on which the Agent is running.
Operating System Release	System-supplied; release information for the operating system on which the Agent is running.
Version	System-supplied; version number of the Agent program.
Build ID	System-supplied, provided by the Agent; build ID of the Agent. Internal use only.
Build Date	System-supplied, provided by the Agent; date the Agent program was last built.
CPU	System-supplied; information about the CPU on the Agent machine.
System Details	This section contains detailed information about the Agent system.
Started Date	System-supplied; date/timestamp when the Agent was last started.
Last Heartbeat	System-supplied; date and time the most recent heartbeat was received from the resource.
CPU Load	System-supplied; current CPU load on the Agent machine, expressed as a percentage. For example, 1 means 1% currently utilized.
OMS Server	Host name of the OMS Server.
PID	System-supplied, provided by the Agent; process ID of the Agent.
Jobs Run	Total number of jobs that have been run through the Controller to this Agent.
Current Task Count	If Task Execution Limit = Limited; Current number of tasks currently being run by this Agent. (See Resetting the Current Task Count for information on resetting the current task count.)
Authentication Version	This value is used by the Controller to determine what level of encryption is to be used for sensitive data between the Agent and the Controller. The most secure method available is used per that agent. Options: 1 or unspecified: Legacy authentication prior to Release 6.5. 2: Release 6.5 and above using AES encryption strategies.
Extension Details	This section contains detailed information about Universal Extensions.
API Level Minimum	Minimum extension API level supported.
API Level Maximum	Maximum extension API level supported.
Extensions	List of deployed Universal Extensions and their corresponding checksums.
Accept Extensions	Specification (true or false) for whether or not the Agent will accept deployment of Universal Extensions.
Accept List	If Accept Extensions true; list of specific Universal Extensions that are allowed to be deployed to the agent, or * for no deployment restrictions.
Secondary Agent Details	This section contains detailed information about any secondary z/OS Agents.
Secondary Agent Licenses	Number of secondary Agent licenses.
Secondary Agent(s)	List of secondary Agent information.
Metadata	This section contains Metadata information about this record.
UUID	Universally Unique Identifier of this record.
Updated By	Name of the user that last updated this record.
Updated	Date and time that this record was last updated.
Created By	Name of the user that created this record.
Created	Date and time that this record was created.
Buttons	This section identifies the buttons displayed above and below the Agent Details that let you perform various actions.
Update	Saves updates to the record.
Suspend Agent	Suspends the Agent's ability to run tasks.
Resume Agent	Resumes the suspended Agent's ability to run tasks.
Delete	Deletes the current record.
Refresh	Refreshes any dynamic data displayed in the Details.
Close	For pop-up view only; closes the pop-up view of this task.
Tabs	This section identifies the tabs across the top of the Agent Details that provide access to additional information about the Agent.
For an Agent-Only installation of Universal Controller, the Agent Clusters, Task Instances, and Tasks tabs do not display.
Agent Clusters	Lists all agent clusters that this Agent belongs to.
Notifications	Lists all notifications that have been defined for this Agent.
Task Instances	System-supplied; lists all task instances that have run or are ready to run on this Agent since it last started.
Tasks	System-supplied; lists all tasks that specify this Agent in its Details, and lets you create a new task that specifies this Agent.