• Home
  • Deploy Dynatrace
  • Dynatrace OneAgent
  • Installation and operation
  • Dynatrace for z/OS
  • z/OS monitoring overview
  • Monitor file access of CICS applications

Monitor file access of CICS applications

With Dynatrace, you can monitor the VSAM and BDAM file access calls from your CICS applications using the CICS code module. Each accessed file in a CICS region is represented as a database service on the Databases page, including metrics like response time, failure rate, and throughput.

File access on the Database page

The Distributed traces page lists the file operations and logical file names that are being accessed on the PurePath method-level. The file operations are aggregated per logical file name (for example, in the image below, the READNEXT operation was executed 21 times on the file EXMPCAT).

File access calls in the Distributed traces page

Get started

CICS code module version 1.259+

To start monitoring the file access calls from your CICS applications

  1. From the Dynatrace menu, go to Settings > Preferences > OneAgent features.
  2. Activate the OneAgent feature z/OS CICS file monitoring sensor.
  3. Restart your CICS region or allow DTAX transaction to pick up the new configuration setting in the next 5 minutes interval.

Remote files

In the application program, if the file control API has a SYSID clause with the remote SYSID, the file is recognized as a remote file. However, if the file is defined as remote in the CEDA definition, the CICS code module doesn`t recognize the file as a remote file.