Previous Topic: LACTR ExamplesNext Topic: LAGENT Examples


LAGENT Command

The LAGENT command displays agents to which this CA WA CA 7 Edition can communicate when communication paths are available. To send agent jobs, each agent must be defined to CA WA CA 7 Edition, and this CA WA CA 7 Edition instance must be defined to each agent.

Using the LAGENT command provides general information about the agent status. The Scheduling Manager (CA 7/IAS) does not stay connected to the agent on an ongoing basis but only when there is data to send or receive from the agent. Thus, the status can show active or inactive when no messages are sent to or from the agent. To ensure latest status available for an agent, use the /AGENT,FUNC=PING,AGENT=agentname command to force a communication to the agent.

Note: For more information about defining agents, see the CA Integrated Agent Services Implementation Guide.

This command has the following format:

LAGENT[,AGENT={*|name|mask}][,LIST={SHORT|ACCUM|ALL|STATS}]
AGENT

(Optional) Specifies the agent name or mask to select agent information for display.

Default: * (all agents)

Limits: 1 to 16 characters

LIST

(Optional) Specifies the amount of agent information to provide.

SHORT

Lists the agent name, active status, and host name. SHORT is the default.

ACCUM

Lists the accumulated statistics for each agent requested. These statistics are reset to zero when the CA IAS checkpoint file is initialized. This information can be useful to detect whether any agent jobs are being sent to a particular agent. This option also lists communication handshake information that is captured when the agent last initiated a handshake. If the agent has not initiated communications after the IASCKPT file was initialized, this data displays as N/A.

ALL

Lists the definition that is associated with the agents requested. This information includes platform, code (ASCII or EBCIDC), host information, and more.

STATS

Lists the current statistics for each agent. These statistics are reset to zero each time CA WA CA 7 Edition is initialized. This information can be useful to detect the last time that a message was sent or received and agent activity. This option also lists communication handshake information that is captured when the agent last initiated a handshake. If the agent has not initiated communications after the IASCKPT file was initialized, this data displays as N/A.

More information:

Masking