Previous Topic: /GVAR CommandNext Topic: /JCL Command


/IAS Command

The /IAS command requests CA Integrated Agent Services (CA IAS) to perform a specific function. These functions fall into the following two broad categories:

Agent administration functions act on agents. These functions can add, delete, or change agent and agent manager definitions. These functions can also shut down all communications to agents and restart those communications.

Log administration functions act on the CA IAS log or the internal CA WA CA 7 Edition logging abilities. The CA IAS log is a wraparound log of messages in storage. The /IAS functions that start with LOG control this storage. Each log message has a log type that is associated with it. Log types are turned on and off to control which messages are stored in the CA IAS log area. The internal logging abilities cause CA WA CA 7 Edition to create a log record containing the AFM that is being sent or received. These records are written to the LOGP/LOGS data sets and can create many log records and therefore should remain off unless CA Support directs. The /IAS functions beginning with AGLOG control this option.

This command has the following format:

/IAS,FUNC=function[,LOGDD=ddname][,LOGTYPE=nnn]
FUNC

Specifies the specific function that CA IAS is to perform. Valid values are the following items:

AGLOGOFF

Turns off the internal CA WA CA 7 Edition AFM tracing facility.

AGLOGON

Turns on the internal CA WA CA 7 Edition AFM tracing facility.

LOGCLEAR

Clears the CA IAS log file.

LOGPRINT

Prints the CA IAS log file to the ddname that the LOGDD value indicates.

LOGRESET

Turns off a CA IAS log type. The LOGTYPE value indicates the log type.

LOGSET

Turns on a CA IAS log type. The LOGTYPE value indicates the log type.

LOGSTART

Starts or resumes logging.

LOGSTOP

Suspends the logging function.

RECONFIG

Activates additions, deletions, and changes made to agents in the IASAGENT DD statement.

STARTCOM

Initializes communications between agents and CA WA CA 7 Edition. This function is used after the STOPCOM function is executed.

STOPCOM

Stops communications between agents and CA WA CA 7 Edition. This function is typically used to stop sending all jobs to agents for execution.

LOGDD

(Optional) Specifies the ddname to contain the printed log file. This parameter is required for the LOGPRINT function and ignored on all other functions. CA IAS dynamically allocates a sysout file to this ddname, writes the current log records to it, and then dynamically frees the ddname. The LOGDD value must follow IBM naming standards for ddnames.

LOGTYPE

(Optional) Specifies the CA IAS message log type to turn on or off. This parameter is required for the LOGSET and LOGRESET functions and ignored for all other functions. Valid values are 1 through 127.