Starting Your Product › Configure the Cross-Enterprise APM Agent

Configure the Cross-Enterprise APM Agent

This diagram provides a high-level overview of the Cross-Enterprise APM Agent configuration steps.

Before you begin

Before you begin configuring the Cross-Enterprise APM Agent, verify that you have Set Up CAICCI for CA Cross-Enterprise APM.

Follow these steps:

1. Collect the metrics from CA SYSVIEW by configuring the Cross-Enterprise APM Agent. Establish a session with the CA SYSVIEW user address space by setting these configurations:
   1. Configure the SYSVIEWPATH statement in custom.JCL(STDENV). Point the statement to the zFS directory that is created during the CA SYSVIEW SMP/E process, for example:

      SYSVIEWPATH=/usr/lpp/sysview/cnm4d70
      

      Note: Your directory varies according to the CA SYSVIEW release. Verify that the file being referenced in STDENV resides at the path you provide here.

   2. Configure the Cross-Enterprise_APM_Dynamic.properties file:

      SYSVIEW.connection.jobname=
      

      Note: The jobname parameter is not required because the agent discovers the CA SYSVIEW user address space running on the same system. This parameter is required only if you run multiple copies of CA SYSVIEW and multiple user address spaces.

   Note: For more information about setting the Cross-Enterprise_APM_Dynamic.properties configurations, see Configure the Cross-Enterprise_APM_Dynamic.properties File.

2. Configure CA SYSVIEW to send the trace information to Cross-Enterprise APM.
   1. Establish a TCP listener to which the CA SYSVIEW CICS and IMS loggers connect. The configuration is set by editing this property in the Introscope_Cross-Enterprise_APM.profile file:

      ppz.smf.socket.port=15029
      

   2. Connect the CICS logger and IMS logger tasks in the CA SYSVIEW server to the Cross-Enterprise APM TCP listener on the specified port. Edit the following properties in the CA SYSVIEW data members:

      sysvhlq.CNM4BPRM(CICSLOGR)
      Wily-Introscope-PortList CICSWILY
      
      sysvhlq.CNM4BPRM(GROUPS)
      DEFINE CICSWILY
             TYPE    PORTLIST                          
             DESC    'Wily Agent Listener Port '
             MEMBERS 15029
      
      sysvhlq.CNM4BPRM(IMSLOGR)
      Wily-Introscope-PortList IMSWILY
      
      sysvhlq.CNM4BPRM(GROUPS)
      DEFINE IMSWILY
             TYPE    PORTLIST                          
             DESC    'Wily Agent Listener Port '
             MEMBERS 15029
      

   Note: For more information about setting the Introscope_Cross-Enterprise_APM.profile configurations, see Configure the Introscope_Cross-Enterprise_APM.profile File.

Note: After you configure these settings, read and accept the End User License Agreement. For more information, see Configure and accept the End User License Agreement.