Determine “High-Water Mark” for a Period (DGADVITL)

The program called DGADVITL reports how many concurrent sessions (Processes) are running during the time period specified. Below is a sample RUN TASK that executes as a PNODE=SNODE Process when submitted. This Process must be force flushed to discontinue. The MCS console displays the number of sessions that ran during the specified period, and the time and date the high water mark was reached. These messages appear in the JESMSGLG segment of the IBM® Connect:Direct® SYSOUT.

/****************************************************************/
/* RUN TASK FOR HIGH WATER PROCESS NUMBER; PNODE=SNODE */  /***************
************************************************/
RTBB PROCESS SNODE=your.local.node
 STEP1 RUN TASK (PGM=DGADVITL,PARM=(C'60')) PNODE

The parameter, C, is the number of minutes desired in a measurement interval. The interval, 60, is an appropriate value to use. Since the Process that does the measuring runs as a PNODE=SNODE Process, the system adds a count of 2 to whatever the highest number of Processes that were running concurrently during a particular sample window. For example, if 6 other Processes were running simultaneously at a given time during the sample window, the value in the SVIT001I message will be '0008'. If no Processes were running during that sample time, the measuring Process is not counted, so the value in the SVIT001I message is '0000'.

The following example shows the output of the DGADVITL program:

SVIT001I SESSION HIGH WATER MARK OF: 0003 REACHED AT: 10:15:46 ON: 02000173
Note: Using the DGADVITL utility may not be required and Simultaneous Session Reporting (SSR) is the preferred application in most instances. Connect:Direct utilizes Simultaneous Session Reporting (SSR) to continually monitor sessions over the life of Connect:Direct and tracks the session high-water mark, generates an SMF133 record to document this value, and provides reports from the data. For CDPLEX, a DGADVITL Run Task must be running on each server in the CDPLEX to report that server's activity on the number of concurrent sessions reached during the specified period. For additional information about Simultaneous Session Reporting (SSR), see Simultaneous Session Reporting in the System Administration Guide.