DDNAME=IASAGENT

CA WA CA 7 Edition Environment › Configuration for CA IAS and CA WA CA 7 Edition › CA IAS Files › DDNAME=IASAGENT

DDNAME=IASAGENT

The IASAGENT file contains the CA WA CA 7 Edition scheduling manager and CA WA Agent definitions. If an agent is not defined in this file, CA WA CA 7 Edition does not acknowledge the agent, and you can send no jobs to that agent. Because CA WA CA 7 Edition controls whether an agent can connect to the CA WA CA 7 Edition/Agent network, defining the scheduling manager in the agentparm.txt file is not sufficient.

On the other hand, assume the following:

CA WA CA 7 Edition does have the agent information in the IASAGENT definition.
The agent does not have any communication.manager-statements coded in the agentparm.txt file.

In this case, CA WA CA 7 Edition, on initial “handshake” with the agent, is added to the agentparm.txt file. Also, if CA WA CA 7 Edition is moved from one LPAR to another and is using the same manager name, the agent updates the agentparm.txt for the current IP address. This permits CA WA CA 7 Edition to failover to another system without needing to update any information on the agent side.

A sample member for IASAGENT is provided in the CA IAS-supplied library CIASOPTN(IASAGENT).

Note: Assume that you plan to have multiple CA 7 online systems communicate with the same set of CA WA Agents. You can simplify the configuration files by separating the IASAGENT statements into two PDS members or sequential files. Next, concatenate the files together in the CA 7 Online JCL.

Define a unique PDS member or sequential file for each CA WA CA 7 Edition system. This member/file contains the manager-related statements (MANAGER and AGENTRCV).
Define a common PDS member or sequential file to contain all the AGENT statements for defining the remote agents.
Concatenate these two files under the IASAGENT DD in the CA 7 Online JCL. For example, in the instance CA71 Online JCL, have the following statements:
```
//IASAGENT DD DISP=SHR,DSN=prefix.CAL2OPTN(CA71AMGR)
//         DD DISP=SHR,DSN=prefix.CAL2OPTN(CA7AGNTS)
```
For instance CA72 Online JCL, use a different member to describe the CA72 manager and use the same member as coded in the CA71 JCL to describe the agents:
```
//IASAGENT DD DISP+SHR,DSN=prefix.CAL2OPTN(CA72AMGR)
//         DD DISP=SHR,DSN=prefix.CAL2OPTN(CA7AGNTS)
```

Scheduling Manager Definition Statements

MANAGER NAME(name) RETRYINTERVAL(nnnnnn) RETRYCOUNT(nnnnnn) SLEEPTIME(nnnnnn)

name

(Required) Identifies the 1-16 byte scheduling manager. The name must be unique across the agent network. This name must match the communications.managerid_n field defined in the agentparm.txt file.

The other parameters define defaults for any agent statements that do not specify values explicitly. The RETRYINTERVAL specifies the number of milliseconds before CA IAS tries to resend a message. If, after the RETRYCOUNT number of times, CA IAS still cannot send a message, CA IAS puts that agent into a sleep interval based on the SLEEPTIME number of seconds. For example, if you want to wait 10 seconds between retries, perform five retries, and then pause for five minutes before trying again, code the following:

RETRYINTERVAL(10000)  RETRYCOUNT(5) SLEEPTIME(300)

The default values are to retry every 30 seconds, and after 3 times, sleep for 15 minutes before trying to communicate with the agent again:

RETRYINTERVAL(30000)  RETRYCOUNT(3) SLEEPTIME(900)

AGENTRCV name PORT(nnnnn)

name

Specifies the required name of the listening port.

PORT

Specifies the required listening port of the scheduling manager. This name must match the communications.managerport_n field in the agentparm.txt file.

Agent Definition Statements

AGENT name +
ADDRESS(ip address or DNS name) PORT(nnnnn) +
CRYPTNAME(encryption key name)  PLATFORM(type)  +
RETRYINTERVAL(nnnnnn) RETRYCOUNT(nnnnnn)  SLEEPTIME(nnnnnn)

name: Specifies the required 1-16 byte name of the agent. This name must match the agentname field in the agentparm.txt file.
ADDRESS: (Required) Specifies the IP address or DNS name for this agent. If you are using the DNS Name, define the name to the DNS Server that must always be available. If the agent has a static IP address, using that IP address avoids the overhead associated with performing the DNS lookup to resolve the name to an IP address.
PORT: (Required) Specifies the port on which the agent listens for incoming requests. This name must match the communications.inputport field in the agentparm.txt file.
CRYPTNAME: (Required) Specifies the name of the key found in the encryption table file (DDName=IASCRYPT). Multiple agents can use the same encryption key, and thus the CRYPTNAME can be the same for multiple agents.

The other parameters are optional. The RETRYINTERVAL specifies the number of milliseconds before CA IAS tries to resend a message. If after the RETRYCOUNT number of times CA IAS still cannot send a message, CA IAS puts that agent into a sleep interval based on the SLEEPTIME number of seconds. If these parameters are not coded on the AGENT statement, the MANAGER statement values are used to determine the intervals/count.