ONLINE monitoring

You can monitor the status and performance of an ONLINE system, including SNA Communications Server interfaces, with the MONITOR command. See MONITOR command for complete command syntax.

MONITOR provides a series of formatted or unformatted displays of system and user statistics about all or a selected set of active users. You can update the displays on a periodic basis, but do not update them more frequently than every five seconds.

Unformatted displays

Unformatted displays show all the nonzero cumulative system or user statistics in a format similar to that provided in the journal:

• Series of terms appears in name=value format.
• Journal header is not displayed.
• Each user is identified by user number.
• Account name appears at the beginning of the user's display.

Formatted displays

Formatted displays show basic system information, followed by specified user information in labelled columns.

Basic system information includes the number of:

• Active users (USR)
• Active servers (SVR)
• Open buffers (BUF)
• Open files (FLS)
• A file open as part of one or more permanent groups is followed by an asterisk (*).
• Two pound signs (##) indicate that the user has more files open than can fit into the internal buffer used to hold open file names.
• System percentage of CPU time (PCPU).
• Statistics from the last system performance line written to the journal. If performance monitoring is active and performance lines are being written to the journal, all statistics are shown. Otherwise, only open buffers, open files, and system PCPU are shown.

Specified user information is described in the next section.

User information in formatted displays

User information is viewable in the following types of formatted displays:

• Basic display (default)
• User since-last statistics
• User performance data
• Open files

The following sections describe these types of formatted displays.

Basic display

USER SVR USERID P CUR SLICE AGE FUNC CNCT CPU SEQIO QUE WT FLGS 0 SAM S 48 0.075 0 0.041 3 BLKO 04 40 1 1 MARY S 49 0.075 EVAL 266 0.152 36 REDY

Where:

• USER is the user number.
• SVR is the server number.
• USERID is the user ID.
• P is user priority (P).
• CUR is current priority.
• SLICE is current CPU time slice.
• AGE is user pre-aged priority.
• FUNC is the last function to set the since-last parameter.
• CNCT is connect time.
• CPU is CPU time.
• SEQIO is the sequential I/O operations performed.
• QUE is the [#Values for QUE|current scheduler queue]]
• WT is the [#Values for WT|user wait type]].

Values for QUE

QUE value	Means user is...
RUNG	Running
BLKI	Blocked in server
BLKO	Blocked out of server
WTSV	Waiting for server
REDY	Ready or running
SWPG	Being swapped in or out
OFFQ	Invisible to the scheduler, off all scheduler queues. This typically occurs when the user is at command level
WTUS	Inactive

Wait type values

Flag	Description
00	Unspecified
01	Disk I/O
02	Sequential user I/O — output
03	Sequential user I/O — input
04	Operator's console input (WTOR)
05	Restore reads (BSAM)
06	Dump writes (BSAM)
07	Enqueue waits (record or noncritical resource)
08	Buffer waits
09	Wait almost forever (deactivated user)
10	Waits for a pseudo subtask, or waits for reactivation (hung terminal)
11	Waits for an IFAM2 or IFAM4 call
12	Waits for a wakeup
13	Server I/O
15	Writes to the journal data set, CCAJRNL
16	Checkpoint writes to CHKPOINT data set
17	Waits for check on previous write
18	Waits for a checkpoint DECB to free up or waiting for multiuser output arbitration
19	Waits for a checkpoint request
20	Waits for a checkpoint completion
21	Wait forever (dead user)
22	VSAM or sequential file input
23	User waiting due to excessive login failures
24	Waits for exclusive control of critical file resource
25	Waits for share control of critical file resource
26	Waits for SNA Communications Server buffer, input or output
27	Waits for interprocess input
28	Waits for interprocess output
29	User waiting for the security interface
30	User(s) waiting, with $WAIT(nn,'SWAP'), for a user-defined ECB to be posted by a $POST function from a different user
31	User(s) waiting, with $WAIT(nn,'NOSWAP'), for a user-defined EDB to be posted by a $POST function from a different user
32	User waiting for DB2 subtask
33-36	Reserved for future development
37	User waiting for recovery to complete
38	Reserved for future development
39	Reserved for future development
40	Waiting for an MQSeries subtask to become available
41	Waiting for a MQ subtask to run
42	MQSeries MQGET operations with wait time specified
43	ECF to load or delete a module
44	External module to become free
45	ECF subtask to become free
46	External module to run
47	User(s) waiting, with $WAIT('CPQZ'), for the extended quiesce ECB to be posted by the successful completion of a Model 204, system-wide checkpoint
48	User(s) waiting, with $WAIT('QZSIG'), for the end of extended quiesce
49	User(s) waiting, at end of extended quiesce, for count of $WAIT('CPQZ') and $WAIT('QZSIG') users to go to zero
50	User is waiting for HSM to recall an archived data set

FLGS is the combined value of the status flags.

Status flags are the hexadecimal sum of the values listed in the "Status flag values" table:

Status flag values

Flag	Description of wait...
40	User's wait is swappable. If another user needs this user's server area, the waiter may be written out.
20	User is waiting for an internal ECB (that is, the ECB is posted only by Model 204, not by the operating system).
8	More than one user is allowed to wait for the ECB that this user is waiting for.
4	User can be bumped.
2	User can be interrupted with an urgent message.
1	A time limit was specified for the user's wait.

User since-last statistics

User since-last statistics (SL option) show current activity.

If the user is between activities or performing an activity that does not initialize since-last statistics, the display is cumulative.

Statistics displayed are CPU, DKRD, DKWR, UDD, OUT, SLIC, FINDS, RECDS, PCPU, RQTM, SUBSYSTEM, PROC-FILE, PROC, and the pseudo subtask's user ID, account name, and user number. (Refer to the Statistics with descriptions table for statistic definitions, and to Pseudo subtasks.)

User performance data

The PERFORMANCE option shows data last written to the journal. The following information is included:

• Number of samples used to compute percentages
• percentage of time the user is in each of the scheduler queues

See Priority scheduling.

Open files

This display is a list of files a user has open.

MONITOR examples

These examples show several variations of the MONITOR command.

The following command specifies a single nonrepeating formatted display of basic information for the system and all active users:

MONITOR

The following MONITOR ACTIVE command specifies a single nonrepeating formatted display of basic information for the system and active users, excepting OFFQ users. OFFQ is a state-of-queue status meaning that the Scheduler does not have to evaluate those users not in the queue. This command is used to reduce the amount of terminal output.

MONITOR ACTIVE

The following commands specify a display of the cumulative system statistics, which is updated every minute:

MONITOR STATISTICS 60 MONITOR STAT EVERY 60 MONITOR SYSTEM STATISTICS 60

The following command specifies a single display of the cumulative user statistics for users 1, 3, and 5, if they are active:

MONITOR (1,3,5) STATISTICS

The following commands specify a single formatted display of basic system information and basic, since-last, performance, and file information for each active user. Pseudo subtask's user ID, account name, and user number are displayed for SL (since-last) statistics:

MONITOR ALL MONITOR USERS ALL MONITOR BASIC SL PERFORMANCE FILE MONITOR SL FILE PERF

The following commands specify a display of basic formatted information for the system and users 1, 2, 5, and 7, if they are active. The display is repeated continually 75 seconds after it completes. The user must press Enter to display the refreshed version, or enter *CANCEL to terminate the display:

MONITOR (1,2,5,7) 75 MONITOR (1,2,5,7) BASIC EVERY 75

The following command specifies an unformatted display of the following information:

• Number of active users
• Number of compactions of the record locking table
• Current number of bytes used in the record locking table
• Current high-water mark for the number of bytes used in the record locking table
• Current number of headers used in the record locking table
• Current high-water mark for the number of headers used in the record locking table
• Required LRETBL setting (high-water mark) for the current system load

MONITOR ENQ

The following command specifies a formatted display of the number of pages from tables of each file that are currently located in the disk buffers:

MONITOR DISKBUFF

The following command specifies information about SNA Communications Server's use of output buffers and waits for threads:

MONITOR VTAM

MONITOR LINK example

The following command specifies information about a network entity:

MONITOR LINK HEADQTRS

For more information about the MONITOR command for network monitoring, see Model 204 Horizon: Intersystem Processing.

In this example, HEADQTRS is the specified network entity for which the Online system operation is being monitored. The following statistics are provided:

LOCAL ID MAXSES BNDSES IBWTS OBWTS CONVS FLGS TRAN/PROTO -------- ------ ------ ----- ----- ----- ---- ---------- BOSTACB 4 2 0 0 2 A VTAM/LU62 USER PROCESS SENDS RECVS FLGS PROCESSGRP ----- -------- ----- ----- ---- ---------- 3 PROCESS1 5 4 BI DENVER OBSOLETE 4 PROCESS1 5 4 BI DENVER

Where:

• LOCAL ID is the SNA Communications Server ACB name (BOSTACB).
• MAXSES is the maximum number of sessions allowed on this link (4).

  The limit is established by the SESSIONS parameter of the DEFINE LINK command.

• BNDSES indicates the number of currently bound sessions (2).
• IBWTS indicates the number of input buffer waits (0) by inbound conversations.

  The input buffer availability is controlled by the actual number of input buffers established by the INBUFNO parameter of the DEFINE LINK command. An input buffer is used on the inbound side when a conversation is being established. If IBWTS is high, and you observe delays while opening inbound processes, then increase INBUFNO.

• OBWTS indicates the number of output buffer waits (0).

  Note: OBWTS is always zero when the communication protocol is LU 6.2 (output buffers are not used).

• CONVS indicates the number of active conversations (2).
• FLGS indicates the status of the link status (A). Possible values for FLGS are:

  A	Active
  S	Stopped
  C	Closed

• TRAN indicates the transport mechanism: SNA Communications Server or terminal (TERM). In this case TRAN is SNA Communications Server.
• PROTO indicates the communication protocol (LU 6.2). Possible values for PROTO are:

  MSTR	Master (for TPROCESS)
  XFER	Transfer (for TPROCESS)
  IMS61	IMS LU 6.1
  LU 6.2	LU 6.2

  The second line of statistics is a detail line for each bound session.

  • USER provides the external user number (3, 4). A blank occurs if a conversation is not active.
  • PROCESS indicates the process name (PROCESS1). If a conversation is not active, a blank appears.
  • SENDS indicates the number of physical sends for each conversation (5, 5).
  • RECVS indicates the number of physical receives for each conversation (4, 4).
  • FLGS indicates the status of the session (BI, BI). The session status flags are:

    B	bound
    F	first speaker
    I	inbound
    O	outbound
    L	local bid in progress
    R	remote bid accepted

• PROCESSGRP provides the process group name (DENVER). In this example, user 3 is running with an OBSOLETE process group: the process group was stopped and a DEFINE PROCESSGROUP command was issued to change the process group definition for subsequent usage. User 4 is running with the most recent version of the process group definition.

MONITOR PROCESSGROUP example

The following command specifies reports concerning a specific process group:

MONITOR PROCESSGROUP

In this example, two PROCESSGROUP reports are produced. The first report is for an active conversation. The second report reflects the stopping and redefinition of the active conversation, which is allocated to another conversation (OBSOLETE with the same process name). Until the conversation with the obsolete process group ends, separate reports are produced for each process group to reflect the more current set of attributes.

MONITOR PROCESSGROUP DENVER LINKNAME REMOTEID BNDSES INCONVS OTCONVS FLGS -------- -------- ------ ------- ------- ---- HEADQTRS DENVACB 2 1 0 A USER PROCESS SENDS RECVS FLGS ----- -------- ----- ----- ---- 4 PROCESS1 5 4 BI MONITOR PROCESSGROUP DENVER LINKNAME REMOTEID BNDSES INCONVS OTCONVS FLGS -------- -------- ------ ------- ------- ---- HEADQTRS DENVACB 2 1 0 AX USER PROCESS SENDS RECVS FLGS ----- -------- ----- ----- ---- 3 PROCESS1 5 4 BI

Where:

• LINKNAME names the associated link (HEADQTRS).
• REMOTEID provides the Remote LU name (DENVACB).
• BNDSES indicates the number of bound sessions (2).
• INCONVS indicates the number of active inbound conversations (1).
• OTCONVS indicates the number of active outbound conversations (0).
• FLGS indicates the status of the processgroup (A). The processgroup status flags are:

  A	Active
  S	Stopped
  X	Obsolete

The second line of statistics is a detail line for each active conversation.

• USER indicates the external user number (4).
• PROCESS provides the name of the program as it is known to network users (PROCESS1).
• SENDS indicates the number of physical sends (5).
• RECVS indicates the number of physical receives (4).
• FLGS indicates the status of the session status (BI). Status flags are:

  B	Bound
  F	First speaker
  I	Inbound
  O	Outbound

MONITOR PROCESS example

The following command specifies information about a particular process:

MONITOR PROCESS PROCESS1

In this example, two inbound conversations invoked from PROCESSGROUP DENVER (users 3 and 4) are in progress with the process named PROCESS1. The conversation ID (CID) that was assigned in the SOUL OPEN PROCESS statement is PROGRAM1.

MONITOR PROCESS PROCESS1 USER CID PROCESSGRP STARTED SENDS RECVS FLGS STATE ----- -------- ---------- ----------- ----- ----- ---- ------ 3 PROGRAM1 DENVER 88349135723 5 4 BI RECV 4 PROGRAM1 DENVER 88349135803 5 4 BI RECV

• USER indicates the external user number (3, 4).
• CID provides the conversation ID (PROGRAM1).
• PROCESSGRP indicates the name of the processgroup (DENVER).
• STARTED provides the Julian date and time the conversation began (88349 and 13:57:23).
• SENDS indicates the number of physical sends (5, 5).
• RECVS indicates the number of physical receives (4, 4).
• FLGS indicates the status of the session (BI). Status flags are:

  B	Bound
  F	First speaker
  I	Inbound
  O	Outbound

• STATE indicates the state of the conversation (RECV). Conversation states can be:

  ACCEPT

  CLOSE

  CONFCLS

  CONFIRM

  CONFSND

  INITIAL

  RECV

  SEND

MONITOR DISKBUFF example

You can use the MONITOR DISKBUFF commands to analyze the buffer pool utilizations:

• MONITOR DISKBUFF output shows buffer usage combining above and below the bar buffers.
• MONITOR DISKBUFFG output shows buffer pool usage for only above the bar buffers.
• MONITOR DISKBUFFL output shows buffer pool usage for only below the bar buffer usage.

Use these commands throughout the day across varied types of daily and event processing to evaluate your buffer allocations.

Using MONITOR DISKBUFF commands

You can see the types of pages that are in your buffer pools at any point in time using the MONITOR DISKBUFF command. The output of this command displays the types of pages that are in buffers and how many of each type.

MONITOR DISKBUFF FILENAME FCT TBLA TBLB TBLC TBLD TBLE TBLX *TOTAL* -------- --- ------ ------ ------ ------ ------ ------ ------- CCATEMP 0 40 0 0 0 0 0 40 PROC1 1 0 0 0 11 0 0 12 FILETBLX 1 1 10 0 2 0 2 16 TESTZ 1 1 11 0 3 185 0 201 *TOTAL* 3 42 21 0 16 185 2 269