MONITOR LINK command: Difference between revisions

From m204wiki
Jump to navigation Jump to search
No edit summary
No edit summary
 
(One intermediate revision by the same user not shown)
Line 1: Line 1:
==Overview==
==Overview==
For the summary, syntax, and usage notes, see [[MONITOR command: Intersystem network entities]].
For the summary, syntax, and usage notes, see [[MONITOR command: Intersystem network entities]].


==Output==
==Output==
 
<p>The output of <var>MONITOR LINK</var>, except for UL/DB2, is a display with two lines of headings and multiple lines of values. The upper line (the only line for UL/DB2) of headings is a summary line. Its headings, which depend on the intersystem facility monitored, are a subset of those shown in the table below.</p>
<p>The output of MONITOR LINK, except for UL/DB2, is a display with two lines of headings and multiple lines of values. The upper line (the only line for UL/DB2) of headings is a summary line. Its headings, which depend on the intersystem facility monitored, are a subset of those shown in the table below.</p>
<table>
<table>
<caption>MONITOR LINK summary line</caption>
<caption>MONITOR LINK summary line</caption>
      
      
<tr> <th>
<tr class="head"> <th>Display heading</th> <th>Displays...</th> </tr>
<p>Display heading</p>
</th> <th>
<p>Displays...</p>
</th> </tr>
 
<tr> <th><var>
<tr> <th><var>
<p>LOCAL I.D. </p>
<p>LOCAL I.D. </p>
Line 83: Line 76:
<p>TRAN/PROTO </p>
<p>TRAN/PROTO </p>
</var></th> <td>
</var></th> <td>
<p>Communications transmission method and protocol. Possible transport values are:</p>
<p>Communications transmission method and protocol. Possible transport values are:</p>
<ul>
<ul>
<li>CRAM </li>
<li>CRAM </li>
Line 111: Line 104:
    
    
</table>
</table>
<p>The lower line of MONITOR LINK headings are for details of each bound session. Detail line headings are shown in the table below.</p>
<p>The lower line of <var>MONITOR LINK</var> headings are for details of each bound session. Detail line headings are shown in the table below.</p>
<table>
<table>
<caption>MONITOR LINK detail line</caption>
<caption>MONITOR LINK detail line</caption>
      
      
<tr> <th>
<tr class="head"> <th>Display heading</th> <th>Meaning</th> </tr>
<p>Display heading</p>
</th> <th>
<p>Meaning</p>
</th> </tr>
    
    
<tr> <th><var>
<tr> <th><var>
Line 181: Line 170:
==Examples==
==Examples==
===Horizon for VTAM link===
===Horizon for VTAM link===
<p> The following is an example of a MONITOR LINK display for a Horizon link: </p>
<p> The following is an example of a <var>MONITOR LINK</var> display for a Horizon link: </p>
<p class="code"><nowiki>MONITOR LINK HEADQTRS
<p class="code"><nowiki>MONITOR LINK HEADQTRS
LOCAL I.D.  MAXSES  BNDSES  CONVS  FLGS  TRAN/PROTO
LOCAL I.D.  MAXSES  BNDSES  CONVS  FLGS  TRAN/PROTO
Line 235: Line 224:


===Horizon for TCP/IP link===
===Horizon for TCP/IP link===
<p>The following is an example of a MONITOR LINK display for a Horizon for TCP/IP link, using IPv6 network addresses. (IPv6 addresses are supported on IBM z/OS systems only.) </p>
<p>The following is an example of a <var>MONITOR LINK</var> display for a Horizon for TCP/IP link, using IPv6 network addresses. (IPv6 addresses are supported on IBM z/OS systems only.) </p>
<p class="code"><nowiki>MONITOR LINK TCPSQL
<p class="code"><nowiki>MONITOR LINK TCPSQL
LOCAL I.D.
LOCAL I.D.
Line 248: Line 237:
       REMOTE ID: ::FFFF:10.204.204.116
       REMOTE ID: ::FFFF:10.204.204.116
</nowiki></p>
</nowiki></p>
<p>In the previous example:</p>
<p>In this example:</p>
<ul>  
<ul>  
<li>
<li>
Line 288: Line 277:
<p> </p>
<p> </p>
===TPROCESS link===
===TPROCESS link===
<p>The following is an example of a MONITOR LINK display for a CICS TPROCESS link: </p>
<p>The following is an example of a <var>MONITOR LINK</var> display for a CICS TPROCESS link: </p>
<p class="code"><nowiki>MONITOR LINK LK4CICS
<p class="code"><nowiki>MONITOR LINK LK4CICS
LOCAL I.D.  MAXSES  BNDSES  CONVS  FLGS  TRAN/PROTO
LOCAL I.D.  MAXSES  BNDSES  CONVS  FLGS  TRAN/PROTO

Latest revision as of 23:07, 28 March 2017

Overview

For the summary, syntax, and usage notes, see MONITOR command: Intersystem network entities.

Output

The output of MONITOR LINK, except for UL/DB2, is a display with two lines of headings and multiple lines of values. The upper line (the only line for UL/DB2) of headings is a summary line. Its headings, which depend on the intersystem facility monitored, are a subset of those shown in the table below.

MONITOR LINK summary line
Display heading Displays...

LOCAL I.D.

One of the following:

  • Local LU name (from SNA Communications Server APPL definition)
  • CRAM or IUCV channel name
  • Host machine's internet address or, if multiple addresses available, ANY
  • Blank (no meaning)

MAXSES

One of the following:

  • Maximum number of sessions (connections, for CRAM/IUCV) allowed
  • Maximum number of threads allowed (DB2THRD parameter value)

MAXCON

Maximum number of concurrent connections allowed

BNDSES

One of the following:

  • Number of currently bound sessions (connections, for CRAM and IUCV)
  • Number of threads currently in use or on the chain

CONNEC

Number of currently established connections

CONVS

One of the following:

  • Number of active conversations
  • Threads currently active to DB2

FLGS

Link status flags; possible values are:

  • A (active)
  • S (stopped)
  • C (being closed)

TRAN/PROTO

Communications transmission method and protocol. Possible transport values are:

  • CRAM
  • IUCV
  • LOCL (local)
  • TCP/IP (if CMS)
  • TCSE/IP (if z/OS)
  • TCVS/IP (if z/VSE)
  • TERM (terminal)
  • SNA Communications Server
  • Possible protocol values are:

    • MSTR, master (for CRAM SQL, IUCV SQL, and TPROCESS)
    • XFER, transfer (for Transfer Control)
    • LU62, LU 6.2 (for Horizon and Parallel Query Option/204)
    • CAF, Call Attach Facility (for UL/DB2)

PORT#

Server port number that remote clients use to connect to the link

The lower line of MONITOR LINK headings are for details of each bound session. Detail line headings are shown in the table below.

MONITOR LINK detail line
Display heading Meaning

USER

External user number (blank, if a conversation is not active)

PROCESS

Process name (blank, if a conversation is not active)

SENDS

Number of physical sends (zero, if a conversation is not active)

RECVS

Number of physical receives (zero, if a conversation is not active)

FLGS

Session status flags; possible values are:

  • B (bind or connection established)
  • F (first speaker)
  • I (inbound)
  • L (local bid is in progress)
  • O (outbound)
  • R (remote bid has been accepted)
  • S CNOS source (Model 204 initiated the connection)
  • T CNOS target (partner initiated the connection)
  • X CNOS control session

PROCESSGRP

Processgroup name (the word OBSOLETE appears to the right if this is a connection that belongs to an obsolete processgroup)

REMOTE I.D.

One of the following:

  • Remote partner LU name (blank, for CRAM SQL and IUCV SQL), with the word OBSOLETE appearing to the right if the session belongs to an obsolete processgroup
  • Internet address of partner remote node

Examples

Horizon for VTAM link

The following is an example of a MONITOR LINK display for a Horizon link:

MONITOR LINK HEADQTRS LOCAL I.D. MAXSES BNDSES CONVS FLGS TRAN/PROTO ---------- ------ ------ ----- ---- ---------- BOSTM204 4 2 2 A VTAM/LU62 USER PROCESS SENDS RECVS FLGS PROCESSGRP REMOTE I.D. ----- -------- ----- ----- ---- ---------- ----------- 3 PROCESS1 5 4 BI DENVER DENVM204 OBSOLETE 4 PROCESS1 5 4 BI DENVER DENVM204

In this example:

  • HEADQTRS is defined to SNA Communications Server as BOSTM204.

  • There can be as many as four bound sessions on this link (MAXSES=4). This limit was established by the SESSIONS parameter of the DEFINE LINK command.

  • The transport mechanism is SNA Communications Server, and the communication protocol is LU 6.2 (TRAN/PROTO=VTAM/LU62).

  • The link is active (FLGS=A), and there are currently two bound sessions using the link (BNDSES=2), both of which have active conversations (CONVS=2).

  • Both sessions have active conversations using process PROCESS1.

  • Each conversation has issued a number of physical SNA Communications Server sends and receives (SENDS, RECVS).

  • Both conversations are inbound (FLGS=BI), and the processes belong to processgroup DENVER. That the conversations are inbound implies that process PROCESS1, which is used by these conversations, is a server process.

  • The HEADQTRS link is being used for conversations with the remote partner whose LU name is DENVM204 (REMOTE I.D.=DENVM204).

  • User 3 is running with an "obsolete" processgroup, meaning that the processgroup was stopped and a DEFINE PROCESSGROUP command was issued to change the processgroup definition for subsequent usage.

  • User 4 is running with the most recent version of the processgroup definition.

Horizon for TCP/IP link

The following is an example of a MONITOR LINK display for a Horizon for TCP/IP link, using IPv6 network addresses. (IPv6 addresses are supported on IBM z/OS systems only.)

MONITOR LINK TCPSQL LOCAL I.D. ---------- :: MAXCON CONNEC CONVS FLGS TRAN/PROTO PORT# ------ ------ ----- ---- ---------- ----- 49 1 1 A TCSE/IP 6688 USER PROCESS SENDS RECVS FLGS PROCESSGRP REMOTE I.D. ----- -------- ----- ----- ---- ---------- ----------- 13 CCARCL 3 4 BI CTCP10 REMOTE ID: ::FFFF:10.204.204.116

In this example:

  • The Local ID has been placed on a separate line because, if IPv6, it can be up to 45 bytes in length.

  • There can be as many as 49 concurrent connections on this link (MAXCON=49). This limit was established by the CONNECTIONS parameter of the DEFINE LINK command.

  • The transport mechanism is TCPSE, and the communication protocol is IP.

  • The link is active (FLGS=A), and one connection is currently established (CONNEC=1), which has an active conversation (CONVS=1).

  • The Horizon for TCP/IP link has a port number (PORT#) that clients use when connecting to the link.

  • CCARCL is the required Model 204 process. In the course of the conversations, CCARCL has issued a number of physical sends and receives (SENDS, RECVS) for user 13.

  • The connection has an active conversation using CCARCL. The conversation is inbound (FLGS=BI), and the process belongs to processgroup CTCP10.

  • The remote address specified on the CTCP10 processgroup definition is ::FFFF:10.204.204.116. The remote ID is kept on the same line unless longer than 15 bytes, in which case it is put on a separate line.

  • The session partner address for user 13 is an IPv4 application, but it is held as an IPv4-mapped IPv6 address so that it can communicate with the IPv6 host.

TPROCESS link

The following is an example of a MONITOR LINK display for a CICS TPROCESS link:

MONITOR LINK LK4CICS LOCAL I.D. MAXSES BNDSES CONVS FLGS TRAN/PROTO ---------- ------ ------ ----- ---- ---------- 0 1 1 A TERM/MSTR USER PROCESS SENDS RECVS FLGS PROCESSGRP ----- -------- ----- ----- ---- ---------- 5 PS4CICS 0 0 BFO PGP4CICS

In this example:

  • TPROCESS entity definitions do not include LOCALID or REMOTEID parameters. A TPROCESS connection uses the existing terminal path (CRAM channel) between the CICS terminal and Model 204.

  • Only one connection at a time is allowed on this link. The DEFINE LINK command has no SESSIONS parameter (MAXSES=0).

  • The link is active (FLGS=A), and there is currently an established connection (BNDSES=1), which has an active conversation (CONVS=1).

  • The user thread number (displayed in Model 204 journal/audit trail user statistics) of the conversation is 5 (USER=5).

  • The transport method is to use the existing CRAM channel to the CICS terminal, and the communication protocol is "Parent-Child" (TRAN/PROTO=TERM/MSTR).

  • The conversation uses process PS4CICS. Conversation physical sends and receives (SENDS, RECVS) are not counted.

  • In the conversation, the User Language request initiates ("first speaker") and is considered outbound (FLGS=BFO), and the process belongs to processgroup PGP4CICS.

Monitoring a CNOS link

The value of the TRAN/PROTO option for CNOS is LU62. A link definition does disclose whether a link is CNOS or not. However, when there are sessions on the link, a CNOS session is denoted by an X in the FLGS column, as shown in the following example:

MONITOR LINK LULK1 LOCAL I.D. MAXSES BNDSES CONVS FLGS TRAN/PROTO ---------- ------ ------ ----- ---- ---------- DVCNMB8 50 2 0 A VTAM/LU62 USER PROCESS SENDS RECVS FLGS PROCESSGRP REMOTE I.D. ----- -------- ----- ----- ---- ---------- ----------- 0 0 B CICSRE5 0 0 BX CICSRE5