Previous Topic: Install the APPC AgentNext Topic: Understanding CA Service Virtualization


Configure the APPC Agent

Follow these steps:

  1. To specify logging options, edit the appc-agent-logging.properties file in the APPC agent bin directory.

    For information about configuring logging options for log4j, see the log4j documentation.

  2. Configure the SNA properties on the system. To access the SNA Communications Manager, enter snaconf on the command line.
  3. Configure a local logical unit pair that you can use to configure the agent transaction program and destination. Consult your SNA administrator for appropriate values for your system.

    Communications Server for Linux APPC configuration screen

  4. Select Services, APPC, Transaction program, Properties.
  5. Configure the transaction program to point to the agent home directory/bin/run-appc-agent.sh.
  6. Configure the stdout and the stderr paths to some files in the agent directory so that all the log files are in the same location.
  7. Enter a description that indicates that this program is the agent transaction program.

    LISA--nl_APPCAgent_DefineAgentTP

  8. When you have configured the agent transaction program, select Services, APPC, CPI-C, Properties to define a CPI-C destination.

    LISA--nl_APPCAgent_DefineCPICDest

    When you have configured the agent, you can either start recording or you can deploy a recorded virtual service to VSE. To point to the agent destination name, use your client programs.

    If your client program points to a live destination name, you can switch it to VSEAGENT. Depending on how the destination name is passed to your client program, you could change client command-line parameters, a configuration file, or the client code.

    If there is a recording started using DevTest Workstation, the agent records in recording mode. If the service is deployed based on the recording by this agent, it plays back. If recording or playback is not deployed, the service works in pass-through mode. In pass-through mode, it communicates with the live destination and forwards all requests and responses between the live client and the live server.

The following graphic shows the architecture of the APPC agent with VSE.

Diagram of Sample APPC Transaction Architecture with VSE