DADSM Events RTM monitors DADSM storage events. Whenever a data set is created, extended, renamed, deleted or releases space on the z/OS system, RTM intercepts the event and builds a record for Explorer. The records are written to the RTMDB DD DUMMY state- ment in the DIF started task.
A DEFCONN statement is used to configure RTM to intercept the records being written to the RTMDB dummy file, and forward them to the ExplorerHDB service running on a Linux or z/Linux system. The service adds the storage event records to a MySQL dataset. For more information about the MON-ExplorerHDB installation, examine the “Host Setup and Configuration” and “Install the Explorer History Database (Optional)” sections in the Installation chapter of the Explorer User’s Guide. For information about the RTM install, examine “Steps to Configure the RTM Quick Start Samples” on page 4-4.
The record definition for the MON-RTM event record is contained in the rulelib member @MONEVNT. For more information on defining records, see “Writing Records” on page 3-61 in the Rules Language User’s Guide.
The RTM event record contains:
- the Sysplex, SysID and timestamp
- the jobname, pool and volume name
- storage request type and return code information
- volume space information taken at the time the storage event occured
- dataset space information and DSORG
The MON-Explorer PC application can retrieve and analyze the records from the MySQL database maintained by the MON-ExplorerHDB server.
/**********************************************************/
/* */
/* THIS RULE MEMBER DEFINES THE RECORDS FOR THE MONITOR */
/* REALTIME DATABASE */
/* BASE */
/* */
/* !!!!! DO NOT CHANGE THE RECORD DEFINITIONS */
/* */
/* !!!!! IF DTS CHANGES THE RECORD DEFINITION */
/* */
/* 1- THE VERSION NUMBER PORTION OF THE RECORD */
/* NAME MONEVNT MUST BE INCREMENTED */
/* AND */
/* 2- PC DEVELOPER MUST BE NOTIFIED SO THE PC */
/* GUI CODE CAN BE UPDATED TO ACCEPT THE NEW OR */
/* CHANGED FIELDS */
/**********************************************************/
4-10 QUICK START
DEFREC @MONEVNT
INIT(BLANKS) DDNAME(RTMDB) LEN(450) TYPE(* CSV GRID FAST) FIELD "MONEVNT 00" LEN(10)
FIELD &SYSPLEX LEN(8)
FIELD &SYSID LEN(8)
FIELD &STCK-P LEN(16)
FIELD &CURLDATE LEN(10)
FIELD &CURTIME LEN(8)
FIELD &JOBNAME LEN(8)
FIELD "MVS " LEN(4)
FIELD "510 " LEN(4)
FIELD &VOLSER LEN(6)
FIELD &POOL_NAME LEN(8)
FIELD &FREE_SPACE LEN(4)
FIELD &FREE_CYL LEN(6)
FIELD &FREE_EXT LEN(6)
FIELD &FREE_DSCB LEN(6)
FIELD &FREE_INDEX LEN(6) FIELD &TOTAL_FREE_TRK LEN(8) FIELD &FRAG_INDEX LEN(4)
FIELD &RESPTIME LEN(4)
FIELD &VD_SSTATUS LEN(8)
FIELD &VD_MSTATUS LEN(8) FIELD &INDEX_VTOC_ACT LEN(1) FIELD &FASTWRT_ACTIVE LEN(1) FIELD &CACHE_ACTIVE LEN(1)
FIELD &DSNAME LEN(44)
FIELD &ENV LEN(20)
FIELD &ENVS LEN(20)
FIELD &DADSM_RC LEN(4)
FIELD &RUSER LEN(8) FIELD &REQUEST_SIZE-T LEN(6) FIELD &SIZE-T LEN(6)
FIELD &NUM_EXTENTS LEN(4)
FIELD &SIZE-T-ALL LEN(6)
FIELD &PSPACE LEN(6)
FIELD &SSPACE LEN(6)
FIELD &NVOL LEN(2) FIELD &FORMAT1:VOLSER LEN(6) FIELD &NEWDSN LEN(44)
FIELD &TEMP LEN(1)
FIELD &DSORG LEN(2)
FIELD &USRFLDN1 LEN(6)
FIELD &USRFLDC1 LEN(100)