MPROGRAM Resource Table

A CICS® Monitored resource that describes a subset of the program attributes sampled by the CICSPlex® SM MAS Monitor agents.

The First key field for this resource is PROGRAM.

The following actions are supported:
DISCARD
Remove the Monitored resource instance.
RESET
Reset all Monitoring instance attributes.

Object type
CICS Monitored
Length
120
Usage
API, WUI, EVALDEF
API view
Yes
CMAS context
No
SCOPE applies
Yes
Only query CMASs in workload
No
Copybook identifier
EYUt1377
Security Class
OPERATE.PROGRAM
CICS Commands subject to CICS Security
INQUIRE PROGRAM
Unsupported CICS Releases
None
Table 1. Valid CPSM operations
Operations Actions Parameters Required
GET   None N/A
PERFORM SET, PERFORM OBJECT DISCARD None N/A
  RESET None N/A
Table 2. MPROGRAM FEEDBACK error codes
Value Code Description
9 MPROGRAM_NO_MON_DATA No data for monitored resource
10 MPROGRAM_MON_SYSDEF_REQ Monitored resource required by Real Time Analysis (RTA)
Table 3. MPROGRAM resource table attributes
Name Datatype Source Len Sum Description Offset
EYU_CICSNAME CHAR CPSM 8 DIFF CICS System Name 0
EYU_CICSREL CHAR CPSM 4 DIFF CICS Release 8
EYU_RESERVED CHAR CPSM 4 N/A Reserved 12
 PROGRAM-1  CHAR INQ 8 DIFF Program name 24
CURAVGFETCH INT16US INQ 4 MAX Average fetch time for current sample 108
CURRUSEPCT PERCENT CPSM 4 AVG % of times program reused - current sample 60
CURUSERATE RATE CPSM 4 AVG Program access rate for current sample 44
EXECKEY CVDAS INQ 4 LIKE Program execution key 72
EXECKEY Output valid values
  • CICSEXECKEY
  • USEREXECKEY
  • NOTAPPLIC
FETCHCNT BINARY STAT 4 AVG Number of times program loaded into storage 56
FETCHTIME INT16US STAT 4 AVG Total time for all program fetches 100
HOLDSTATUS CVDAS INQ 4 LIKE Hold status 80
HOLDSTATUS Output valid values
  • HOLD
  • NOHOLD
  • NOTAPPLIC
INTAVGFETCH INT16US INQ 4 MAX Average fetch time for monitor interval 112
INTERVALID TIMESTP CPSM 8 LIKE Interval ID 16
INTRUSEPCT PERCENT CPSM 4 AVG % of times program reused - monitor interval 64
INTUSERATE RATE CPSM 4 AVG Program access rate for monitor interval 48
LENGTH BINARY INQ 4 AVG Program length 88
LPASTAT CVDAS INQ 4 LIKE Link pack area (LPA) status 92
LPASTAT Output valid values
  • LPA
  • NOTLPA
  • NOTAPPLIC
NEWCOPYCNT CNUMERIC STAT 4 AVG Number of NEWCOPY requests issued 32
PROGTYPE CVDAS INQ 4 LIKE Program type 96
PROGTYPE Output valid values
  • PROGRAM
  • MAP
  • PARTITIONSET
REMOVECNT CNUMERIC STAT 4 AVG Number of times removed by program compression 104
RESCOUNT BINARY INQ 4 AVG Number of times program currently accessed 52
RPLID CNUMERIC STAT 4 AVG DFHRPL data set number 84
SHARESTATUS CVDAS INQ 4 LIKE Share status 76
SHARESTATUS Output valid values
  • PRIVATE
  • SHARED
  • NOTAPPLIC
STATUS CVDAS INQ 4 LIKE Enabled status 68
STATUS Output valid values
  • ENABLED
  • DISABLED
USEAGELSTAT CNUMERIC STAT 4 AVG Number of times program accessed since last reset 40
USECOUNT BINARY INQ 4 SUM Total number of times program executed 36