IAMXMON: IAM Execution Monitor for CICS

IAMXMON is a CICS program and transaction that provides real-time statistical information on opened Enhanced format files under CICS. The installation of this program is optional, and an installation must assign a transaction name that you must know to use it. For more information about installing the IAMXMON program and transaction, see Installing-the-IAM-CICS-Monitor.

Summary Display

By entering the assigned CICS Transaction Identifier (TRANSID), you can see a list of OPEN Enhanced format IAM files, described by DDNAME and Data set Name. You can also see the total amount of CICS storage being used for each IAM data set. This display is scrollable using the PF7/PF8 keys.

Example of Initial IAMXMON Display

Data Set Activity Display

To view the detail information about any displayed file, select it by entering 'S' next to the desired file. The first page of the two, is displayed as shown below:

IAMXMON Data set Activity Display Page

Data Set Attributes Display

By pressing the Enter key, a second display describing the physical file will be displayed. Pressing Enter will switch back and forth between the two displays. Use PF3/PF15 to return to the open data set list.

IAMXMON Data set Attributes Display PageRLS Summary Display

RLS Summary Display

By entering the assigned CICS Transaction Identifier (TRANSID) with the RLS keyword (that is, IAMX RLS), the user is presented with a list of OPEN Enhanced format IAM files that are under IAM/RLS control, described by DDNAME and Data set Name. Also displayed is the total amount of CICS storage being used for each IAMdata set. This display is scrollable using the PF7/PF8 keys.

By selecting one of the Data sets by entering an 'S' on the left side of a DDNAME/DSNAME line entry, you will be presented with Data set details just as with the non-RLS display, except that the stats will be from the IAM/RLS address space with the storage and buffer use statistics, because they are in the IAM/RLS address space as opposed to the CICS address space.

RLS Held Record Locks Display

By entering an 'L' on the left side of a DDNAME/DSNAME entry on the RLS Summary Display you'll be presented with from 1 to a maximum of 99 currently held record locks for the selected data set. Only locks held by the CICS region that this IAMX transaction is being executed on are listed. Record Locks are displayed by listing the keys of the records that are locked. Only the first 72 bytes of keys that are longer than 72 bytes are displayed.

The above 'L' locks request would produce either a File Locks Display or a message Chosen Dataset Has No Locks

Sample File Locks Display

RLS Record Locks Display by Job

As discussed above, by entering an 'L' next to a DDNAME/DSN you'll get a RLS Held Locks Display for Locks held by the CICS region the IAMX RLS transaction is being executed on. If you would like to see IAM/RLS held locks that are held by other address spaces you can enter a 'J' to the left of a DDNAME/DSN on the RLS Summary Display and you'll be presented with a Job List display of all Jobs that currently hold record locks of the chosen Data set.

The above 'J' Locks Held Job List request will produce either a Locks Held Job List Display or result in message: Dataset is not being Accessed by any Job Holding a Lock

Sample Locks Job List Display

To see the IAM/RLS held record lock keys for one of the displayed jobnames, select that job by entering an 'S' next to that job and pressing Enter. This will result in an IAM/RLS held locks display as below: