Trace a CCITCP connection

Document ID : KB000049976
Last Modified Date : 14/02/2018
Show Technical Document Details

Solution:

If you need to trace a CCI connection to verify, if connections are working and the correct data is sent, you may use the following hints for Troubleshooting:

In CA Common Services for z/OS Installation Guide, Chapter 8: CAICCI Configuration, page 155 a chapter "troubleshooting" exists, where you may learn, how to determine the current status of a connection and how to activate tracing.

Current Status

There are several commands that can be issued to determine the current status of a connection between machines and the applications that are visible between them.

ENF CCI(DISPLAY,RESOURCE)
ENF CCI(DISPLAY,LINK)

Activate Tracing

Depending on the application there are several ways to turn tracing on.

However, we reccomend to turn the PC trace on at the same time as the CCITCP trace and then send these record to support for review.

CCITCPGW

Issue the following command to turn on tracing dynamically:

F CCISSLGW,T,SYSPRINT (for SSL)
F CCITCPGW,T,SYSPRINT (for non-SSL)

To deactivate the trace, specify:

F CCISSLGW,NOTRACE (for SSL)
F CCITCPGW,NOTRACE (for non-SSL)

Note: To start tracing immediately at CCISSLGW startup, add a TRCPRINT DD statement to the started task JCL. Deactivation is the same as noted previously.

Make sure //SYSPRINT DD is specified in both procedures.

Local CAICCI

For the local CAICCI trace, issue the following commands:

ENF CCI(LINT)
ENF CCI(PRINTT)

CAICCI Spawn

Some applications will also require the use of CAICCI Spawn. Any product that uses this feature will contain installation instructions to update the CCISPNPM member in the YourdeployHLQ.CAW0OPTN member.

To turn tracing on for CAICCI Spawn, add a SPNDEBUG DD statement to the ENF procedure.

Prepare for Component Tracing

By default, CAICCI initializes Component Tracing using component name CACCI. The environment is initialized but tracing must be activated by an MVS TRACE CT command.

The ENF Parm CCICT can be used to activate and customize the Component Tracing environment including the component name. The Component Tracing parmlib member name can be specified in the CCICT command to activate tracing. For instruction on configuring the parmlib member, see the Reference Guide.

Note: If the external writer proc name is specified in the parmlib member, then the external writer must be configured prior to starting ENF/CCI. See the sample CCIXWTR proc in the Reference Guide.

CAICCI/PC - Using a Workstation Product

On the client side, you can enable tracing using the check box on the Trace tab of the CAICCI Configurator. The trace output goes to the file specified. To disable the trace, uncheck the box.

On the z/OS side, issue the following command to turn tracing on:

F CCISSL,T,SYSPRINT (for SSL)
F CCITCP,T,SYSPRINT (for non-SSL)

To deactivate the trace, specify:

F CCISSL,NOTRACE (for SSL)
F CCITCP,NOTRACE (for non-SSL)

CA TCPaccess Communications Server for z/OS Considerations

Started tasks CCISSL and CCISSLGW support CA TCPaccess Communications Server for z/OS using OE sockets, as well as IBM TCP/IP.

The trace data needs to be reviewed by support.