Use the PowerExchange Agent commands to perform the following tasks:
Display information about PowerExchange Agent processing.
Manage the PowerExchange Agent message log.
Open or close the PowerExchange Agent repository data set, change the name that the PowerExchange Agent uses for the repository data set, and display status information about this data set.
Start and stop PowerExchange Agent subtasks.
Shut down the PowerExchange Agent address space.
The commands that begin with “REP” manage to the PowerExchange Agent repository data set. The PowerExchange Agent uses the repository data set to get the latest capture registration information. You can use either the AGENTREP data set or CCT data set as the PowerExchange Agent repository. Informatica recommends using the AGENTREP data set to avoid unnecessary I/O activity.
To issue the PowerExchange Agent commands, use the MVS operator console or an interface such as SDSF. You must precede each command with the MVS command prefix that is specified for the CmdPrefix parameter in the AGENTCTL member of the RUNLIB library. If you did not define the optional CmdPrefix parameter, use the default command prefix, which is the AGENTID parameter value in the AGENTCTL member. The PowerExchange Agent uses the command prefix to intercept commands issued to MVS. In the syntax, the command prefix is represented by the
cmd_prefix
variable.
If you issue a PowerExchange Agent command when the PowerExchange Agent address space is inactive, MVS rejects the command and PowerExchange issues the following message:
PWXEDM172054W
module
:
agentid
Command Exit.
command
command rejected – Agent is not active
If you issue a PowerExchange Agent command with the incorrect command prefix or when the PowerExchange Agent has not been active since the last IPL of the system, MVS issues the following message:
IEE305I
agent_command
COMMAND INVALID
To start the PowerExchange Agent, use the standard MVS START command.
For more information about the PowerExchange Agent repository and AGENTREP data set, see the