Programs - MPROGRAM

The Monitor data for programs (MPROGRAM) views display information about monitored programs.

Supplied views

To access from the main menu, click:

Monitoring views > Program monitoring views > Programs

Table 1. Views in the supplied Monitor data for programs (MPROGRAM) view set
View Notes
Monitor data for programs

EYUSTARTMPROGRAM.DETAILED

Detailed information about a selected program.
Monitor data for programs

EYUSTARTMPROGRAM.DISCARD

Removes a program from CICSPlex SM monitoring for the current sample interval and discards its accumulated statistics.
Monitor data for programs

EYUSTARTMPROGRAM.RESET

Resets the CICSPlex SM statistics counters associated with a program to 0.
Monitor data for programs

EYUSTARTMPROGRAM.TABULAR

Tabular information about monitored programs.

Actions

Table 2. Actions available for MPROGRAM views
Action Description
DISCARD Removes a program from CICSPlex SM monitoring for the current sample interval and discards its accumulated statistics.
RESET Resets the CICSPlex SM statistics counters associated with a program to 0.

Fields

Table 3. Fields in MPROGRAM views
Field Attribute name Description
Average fetch time for current sample CURAVGFETCH The average amount of time taken to fetch a copy of the program during the last sample period.
% of times program reused - current sample CURRUSEPCT The percentage of times a copy of the program in storage could be reused during the last sample period.
Program access rate for current sample CURUSERATE The rate at which the program was executed during the last sample period.
Program execution key EXECKEY The access key in which the program is executing:
  • CICSEXECKEY - The program executes in CICS key and has read and write access to both CICS-key and user-key storage.
  • USEREXECKEY. - The program executes in user key and has write access to user-key storage, but read-only access to CICS-key storage.
  • NOTAPPLIC - This option is not available; either the program is defined as remote, or it is a map set or partition set.
Number of times program loaded into storage FETCHCNT The number of times a copy of the program was loaded from the DFHRPL library concatenation into storage during the current CICS statistics interval.
Total time for all program fetches FETCHTIME The total time taken to perform all fetches of the program during the current CICS statistics interval.
Hold status HOLDSTATUS Indicates whether a copy of the program is currently loaded with the HOLD option (HOLD or NOHOLD). A value of NOTAPPLIC means either the program is not currently loaded, or it is a remote program.
Average fetch time for monitor interval INTAVGFETCH The average amount of time taken to fetch a copy of the program over the monitor interval.
Interval ID INTERVALID The ID of the monitor interval
% of times program reused - monitor interval INTRUSEPCT The average percentage of times a copy of the program in storage could be reused over the monitor interval.
Program access rate for monitor interval INTUSERATE The average rate at which the program was executed over the monitor interval.
Program length LENGTH The length of the program in bytes. A value of 0 means either the program has not been loaded in the current CICS session, or it is a remote program.
Link pack area (LPA) status LPASTAT Indicates where the most recently loaded copy of the program was taken from:
  • LPA - CICS used a version in either the link pack area (LPA) or the extended link pack area (ELPA).
  • NOTLPA - CICS used a private version.
  • NOTAPPLIC - CICS has not used either an LPA version or a private version of the program.
Number of NEWCOPY requests issued NEWCOPYCNT The number of times a NEWCOPY request has been issued against this program during the current CICS statistics interval.
Program name PROGRAM The name of the program.
Program type PROGTYPE The type of program, as one of the following:
  • MAP - A map set.
  • PARTITION - A partition set.
  • PROGRAM - An executable program.
Number of times removed by program compression REMOVECNT The number of times a copy of this program has been removed from storage by the Dynamic Program Storage Compression (DPSC) facility during the current CICS statistics interval.
Number of times program currently accessed RESCOUNT The number of separate copies of the program that are currently executing.
DFHRPL data set number RPLID The position of the program's RPL data set in the DFHRPL concatenation. This parameter will report UNKNOWN if the program has not yet been loaded by CICS.
Share status SHARESTATUS The shared status of the program, which determines whether the next new copy loaded will be a shared version (SHARED) or a private version (PRIVATE). A value of NOTAPPLIC is returned for remote programs.
Enabled status STATUS The enabled status of the program, which indicates whether it is available for use (ENABLED or DISABLED).
Number of times program accessed since last reset USEAGELSTAT The number of times access to the program was requested during the current CICS statistics interval.
Total number of times program executed USECOUNT The total number of times the program has been executed in the current CICS session.


eyua4gk.html | Timestamp icon Last updated: Sunday, 4 June 2017