Troubleshooting the CICS® Transaction Server agent
If the CICS® Transaction Server agent is not behaving as expected, you can investigate various aspects of its operation.
Before you begin
Confirm that the RITAGENT is enabled and configured to communicate with HCL Quality Server on the appropriate host and port by viewing the Infrastructure Dashboard of HCL Quality Server.
- Created an IBM® CICS® Region in the logical view of Architecture School and bound it to an IBM® CICS® Server
- Selected the DPL on CICS Transaction Server check box in that server
- Provided the appropriate values for the server
After you start recording the CICS® region, check the recording rules and their content by clicking the Network icon in HCL Quality Server, and expand the rule card to view the Details tab section.
About this task
The CICS® Transaction Server (TS) agent (RITAGENT) is a batch service in z/OS®. It must register itself with HCL Quality Server and communicate with the CICS® exit programs.
+RITAGENT is running in intercepting status.
You can also view the agent status in the HCL Quality Server Infrastructure Dashboard, https://RTCP_HOST:5443/RTCP/dashboards/infrastructure, where RTCP_HOST is the name of the system that is hosting HCL Quality Server.
Procedure
- Set the RITAGENT log level to trace level and restart the RITAGENT. Send the contents of the files that are identified as RITLOG01 and RITLOG02 in the RITAGENT JCL to IBM®.
- Check the RITLOG in the CICS® region
JES log and send it to IBM®:
- Type a question mark (?) before the CICS® region JOB.
- Select RITLOG.
- Check the intrapartition transient data queue (TDQ):
- Check with the system administrator to see if z/OS® outbound firewall rules are set up that
prohibit the CICS® agent from
connecting to the HCL OneTest™ API recording port. If so, complete
the following steps:
- Set the recording port and CICS® stub server port in HCL OneTest™ API Library Manager. For more information, see Working with the Library Manager.
- Add the specific rules to allow z/OS® outbound HTTP to access those ports.