Museum

Home

Lab Overview

Retrotechnology Articles

⇒ Online Manual

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

ADD

DEFAULT_KEYPAD

DEFINE

DESELECT

EXIT

HELP

INITIALIZE

MOVE

PAN

REFRESH

REMOVE

SAVE

SCROLL

SELECT

SET

WRITE

Changes

Classes

Fields

Procedure

CLUSTER

SYSTEMS

MEMBERS

CIRCUITS

CONNECTIONS

COUNTERS

CREDITS

LOCAL_PORTS

ERRORS

CL_QUORUM

CL_VOTES

QD_NAME

QF_VOTE

CL_QDVOTES

MEMSEQ

FORMED

LAST_TRANSITION

NODE

SYS_ID

HW_VERS

HW_TYPE

SOFTWARE

NUM_CIRCUITS

DG_SIZE

MSG_SIZE

INCARNATION

INCN_TIME

CSID

SEND_SQ

RCVD_SQ

ACKR_SQ

DIR_WT

UNACKED

ACK_LIM

CNX_STATE

PROTOCOL

WARMCDRPS

VOTES

QUORUM

QDVOTES

QF_SAME

QF_ACTIVE

STATUS

TRANSITION_TIME

LPORT_NAME

RPORT_NUM

RP_OWNER

RP_TYPE

NUM_CONNECTIONS

CIR_STATE

REM_STATE

CABLE_STATUS

RP_REVISION

RP_FUNCTIONS

SCS_WAITERS

LOC_PROC_NAME

REM_PROC_NAME

CON_STATE

LOC_CONID

REM_CONID

SCS_STATE

DGS_SENT

DGS_RCVD

DGS_DSCRD

MSGS_SENT

MSGS_RCVD

BLKS_SENT

BLKS_REQ

KB_SENT

KB_RCVD

KB_MAPPED

CR_WAITS

BDT_WAITS

SEND

MIN_SEND

RECEIVE

PEND_REC

INIT_REC

MIN_REC

NAME

LP_STATUS

PORT_NUM

DGS_FREE

MSGS_FREE

COUNTER_OWNER

POOL_WAITERS

MSG_HDR_SIZE

DG_OVRHD_SIZE

LP_TYPE

OPEN_CIRCS

FORM_CIRCS

CMDS_QUEUED

RSPS_QUEUED

MAX_PORT

PRT_MAP

DGI_MAP

LOG_MAP

LB_STATUS

ERT_COUNT

ERT_MAX

NUM_ERRORS

ACKR_SQ

ACK_LIM

BDT_WAITS

BLKS_REQ

BLKS_SENT

CABLE_STATUS

CIR_STATE

CL_QDVOTES

CL_QUORUM

CL_VOTES

CNX_STATE

CON_STATE

CR_WAITS

CSID

DGS_DSCRD

DGS_RCVD

DGS_SENT

DG_SIZE

DIR_WT

FORMED

HW_TYPE

HW_VERS

INCARNATION

INCN_TIME

INIT_REC

KB_MAPPED

KB_RCVD

KB_SENT

LAST_TRANSITION

LOC_CONID

LOC_PROC_NAME

LPORT_NAME

MEMSEQ

MIN_REC

MIN_SEND

MSGS_RCVD

MSGS_SENT

MSG_SIZE

NODE

NUM_CIRCUITS

NUM_CONNECTIONS

PEND_REC

PROTOCOL

QDVOTES

QD_NAME

QF_ACTIVE

QF_SAME

QF_VOTE

QUORUM

RCVD_SQ

RECEIVE

REM_CONID

REM_PROC_NAME

REM_STATE

RPORT_NUM

RP_FUNCTIONS

RP_OWNER

RP_REVISION

RP_TYPE

SCS_STATE

SCS_WAITERS

SEND

SEND_SQ

SOFTWARE

STATUS

SYS_ID

TRANSITION_TIME

UNACKED

VOTES

WARMCDRPS

CMDS_QUEUED

COUNTER_OWNER

DGI_MAP

DGS_FREE

DG_OVRHD_SIZE

ERT_COUNT

ERT_MAX

FORM_CIRCS

LB_STATUS

LOG_MAP

LP_STATUS

LP_TYPE

MAX_PORT

MSGS_FREE

MSG_HDR_SIZE

NAME

NUM_ERRORS

OPEN_CIRCS

POOL_WAITERS

PORT_NUM

PRT_MAP

RSPS_QUEUED

SHOW CLUSTER — VMS 4.6

Additional information available:

ADDDEFAULT_KEYPADDEFINEDESELECTEXITHELP
INITIALIZEMOVEPANREFRESHREMOVESAVESCROLL
SELECTSETWRITE

ChangesClassesFieldsProcedure

Changes

       New Commands                    Obsolete Commands
      --------------                  -------------------
        DEFINE/KEY                           SHOW
        DESELECT
        MOVE UP value
         ... DOWN value
         ... LEFT value
         ... RIGHT value
        PAN  UP value
         ... DOWN value
         ... LEFT value
         ... RIGHT value
        REFRESH
        SAVE [file-spec]
        SCROLL UP value
           ... DOWN value
           ... LEFT value
           ... RIGHT value
        SELECT [window]
        SET AUTO_POSITIONING ON
                         ... OFF
        SET FUNCTION EDIT
                 ... SCROLL
                 ... MOVE
                 ... PAN
        WRITE [/ALL] [file-spec]

Classes

 The classes available for display are:

   CLUSTER       SYSTEMS    MEMBERS   CIRCUITS
   CONNECTIONS   COUNTERS   CREDITS   LOCAL_PORTS
   ERRORS

Additional information available:

CLUSTERSYSTEMSMEMBERSCIRCUITSCONNECTIONSCOUNTERS
CREDITSLOCAL_PORTSERRORS

CLUSTER

 The cluster class contains information about the cluster in general.
 This class includes information such as the time the cluster was
 formed, the time of the last transaction, and the cluster quorum.

Additional information available:

CL_QUORUMCL_VOTESQD_NAMEQF_VOTECL_QDVOTES
MEMSEQFORMEDLAST_TRANSITION

CL_QUORUM

 The CL_QUORUM field displays the number of votes required for the
 cluster to have quorum.

CL_VOTES

 THE CL_VOTES field displays the total number of quorum votes
 currently being contributed by all cluster members and the quorum
 disk.

QD_NAME

 The full device name of the quorum disk.

QF_VOTE

 The QF_VOTE field indicates whether or not the quorum disk is
 contributing any votes.

CL_QDVOTES

 The CL_QDVOTES field displays the number of quorum votes currently
 being contributed by the quorum disk.

MEMSEQ

 The MEMSEQ field displays the membership state sequence number.

FORMED

 The time at which the cluster was formed.
 (DD-MMM-YY HH:MM).

LAST_TRANSITION

 The LAST_TRANSITION time is the time at which a system last left
 or joined the cluster.  (DD-MMM-YY HH:MM)

SYSTEMS

 The systems class contains information about the systems in the cluster.
 This class includes information such as system ID, node name, type of
 system, type of software, software version, the number of virtual
 circuits, etc.

 The fields which make up the systems class are:

Additional information available:

NODESYS_IDHW_VERSHW_TYPESOFTWARENUM_CIRCUITS
DG_SIZEMSG_SIZEINCARNATIONINCN_TIME

NODE

 The NODE field displays the nodename of the remote system.
 The nodename is determined by the SYSGEN parameter SCSNODE
 and should be the same the DECnet nodename.


 NOTE:  The node-names displayed in this field can be used with the
        ADD and REMOVE SYSTEM/NODE=(node-name,...) commands.

SYS_ID

 The SYS_ID field displays identification number of the remote system.
 This ID number is determined by the sysgen parameters SCSSYSTEMID and
 SCSSYSTEMIDH.  The system-id should be the same as the DECnet node
 address.


 NOTE:  The system-ids displayed in this field can be used with the
        ADD and REMOVE SYSTEM/ID=(system-id,...) commands.

HW_VERS

   If the remote system is an HSC then the twelve bytes displayed
 in this field reflect the hardware type and microcode level of one
 of six requestors in the HSC.  The left byte in each pair is the
 hardware type, the right byte is the microcode version.  If zeros
 appear in both bytes, then the requestor is not present.  The
 requestors are numbered 2 through 7 as shown in the following
 table.  T is the hardware type.  V is the microcode version.

    Req. 7    Req. 6    Req. 5    Req. 4    Req. 3    Req. 2
 +----+----+----+----+----+----+----+----+----+----+----+----+
 |  T   V  |  T   V  |  T   V  |  T    V |  T    V |  T    V |
 +----+----+----+----+----+----+----+----+----+----+----+----+


   If the remote system is a VAX, then the lower four bytes
 reflect the contents of the system ID register for the processor.
 The upper two bytes are unused.  The remaining six bytes are
 processor specific and are defined as shown in the following table:

            B3        B4        B5        B6        B7       B8
       +---------+---------+---------+---------+---------+---------+
 8600  |                 unused                |     Processor     |
       +---------+---------+---------+---------+---------+---------+
  785  |  WCS 1  | flags 2 |        WCS        |PCS/WCS 3|   PCS   |
       +---------+---------+---------+---------+---------+---------+
  782  |  WCS 1  | flags 2 |        WCS        |   PCS   |   FPLA  |
       +---------+---------+---------+---------+---------+---------+
  780  |  WCS 1  | flags 2 |        WCS        |   PCS   |   FPLA  |
       +---------+---------+---------+---------+---------+---------+
  750  |                           unused                          |
       +---------+---------+---------+---------+---------+---------+

  All fields unless noted below refer to microcode revision levels.

  1 WCS size
  2 FPA, G and H floating flags
  3 PCS/WCA match revision

HW_TYPE

 The HW_TYPE field displays the type of hardware or processor type
 of the remote system.


 NOTE:  The hardware-types displayed in this field can be used with
        the ADD and REMOVE SYSTEM/TYPE=(hw-type,...) commands.

SOFTWARE

 The SOFTWARE field displays the name and version of the operating
 system being run on the remote system.

NUM_CIRCUITS

 The NUM_CIRCUITS field displays a count of the number of virtual
 circuits established between the local and the remote system.

DG_SIZE

 The DG_SIZE field displays the maximum number of bytes of application
 data in datagrams transferred over the circuit.

MSG_SIZE

 The MSG_SIZE field displays the maximum number of bytes of application
 data in messages transferred over the circuit.

INCARNATION

 The value displayed in the INCARNATION field is a unique 16 digit
 (hex) number established when the system is booted.

INCN_TIME

 The INCN_TIME is the incarnation number expressed as a time
 (DD-MMM-YY HH:MM)

 For additional informaton, see HELP classes SYSTEMS INCARNATION.

MEMBERS

 The members class contains information about  the systems that are
 actively participating in the cluster.  This class includes fields
 such  as  the  system's cluster-wide ID number and the system's
 membership status in the cluster.

 The fields which make up the MEMBERS class are:

Additional information available:

CSIDSEND_SQRCVD_SQACKR_SQDIR_WTUNACKEDACK_LIM
CNX_STATEPROTOCOLWARMCDRPSVOTESQUORUM
QDVOTESQF_SAMEQF_ACTIVESTATUSTRANSITION_TIME

CSID

 The Cluster System ID.

SEND_SQ

 The SEND_SQ field displays the sequence number of the next message
 to be sent via the VAXcluster connection.

RCVD_SQ

 The RCVD_SQ field displays the sequence number of the last message
 to be received via the VAXcluster connection.

ACKR_SQ

 The ACKR_SQ field displays the sequence number of the last
 acknowledge received via the VAXcluster connection.

DIR_WT

 The DIR_WT field displays the Lock Manager distributed directory
 weight.

UNACKED

 The UNACKED field displays the number of unacknowledged VAXcluster
 messages received by the remote system.

ACK_LIM

 The ACK_LIM field displays the maximum number of VAXcluster messages
 that can be received by the remote system before an acknowledgement
 reply is sent.

CNX_STATE

 The CNX_STATE field displays the state of the VAXcluster connection.
 The possible displays are:

        ACCEPT      Accepting the initial connection.
        CLOSED      The connection is closed.
        CONNECT     Attempting the initial connection.
        DEAD        No connection is possible.
        DISCONNECT  A disconnection is in progress.
        NEW         No attempt to make a connection has been made yet.
        OPEN        The connection is open.
        REACCEPT    The connection is accepting the reconnect request.
        RECONNECT   The connection is attempting to reconnect.
        WAIT        A time-out is in progress.

PROTOCOL

 The PROTOCOL field displays the protocol version number and ECO
 level of the connection management software.

WARMCDRPS

 The WARMCDRPS field displays a count of the number of CDRPS on the
 CDRP free queue.

VOTES

 The VOTES field displays the number of votes the remote system
 contributes toward quorum.  The number of votes contributed is
 determined by the SYSGEN VOTES parameter.

QUORUM

 The QUORUM field displays the recommended quorum value set for the
 remote system.  The recommended quorum value for a node is
 determined by the SYSGEN QUORUM parameter.

QDVOTES

 The QDVOTES field displays number of votes which the remote system
 recommends be contributed by the quorum disk.  The recommended
 number of votes is determined by the SYSGEN QDVOTES parameter.

QF_SAME

 The QF_SAME field indicates whether or not the remote system and
 local system agree as to which disk is the quorum disk.

QF_ACTIVE

 The QF_ACTIVE field indicates whether or not the remote system's
 quorum file is accessable.

STATUS

 The STATUS field indicates the remote system's membership status in
 the cluster.  The possible displays are:

        (blank)  The system is not being considered for cluster
                 membership.

        BRK_MEM  The system is a member of the cluster, but the
                 connection manager has lost communication with it.

        BRK_NEW  The system has just booted, but has not yet joined
                 the cluster and the connection manager has lost
                 communication with it.

        BRK_NON  The connection manager has lost communication with
                 the system and the system is no longer a member of
                 the cluster.  It is now a non-member.

        BRK_REM  The connection manager has lost communication with
                 the system and the system has been removed from the
                 cluster.

        MEMBER   The system is participating in the cluster (A default
                 SYSGEN parameter allows 90 seconds delay before a
                 failing system is removed from cluster membership
                 status.)

        NEW      The system has just booted, but has not yet joined
                 the cluster.  If this system would normally be a member
                 of the cluster, and is displaying NEW in this field,
                 you can expect that the display will eventually change
                 to MEMBER.

        NON      The system is not a member of the cluster.

        REMOVED  The system has been removed from the cluster.

TRANSITION_TIME

 The TRANSITION_TIME field displays the time at which the system's
 membership status last transitioned.

 For additional information, see HELP classes MEMBERS STATUS.

CIRCUITS

 The circuits class contains information about the virtual circuits on a
 system.  This class includes fields such as local port name, remote port
 type and number, number of connections on the circuit, circuit state, etc.

 The fields which make up the circuits class are:

Additional information available:

LPORT_NAMERPORT_NUMRP_OWNERRP_TYPE
NUM_CONNECTIONSCIR_STATEREM_STATECABLE_STATUS
RP_REVISIONRP_FUNCTIONSSCS_WAITERS

LPORT_NAME

 The LPORT_NAME field displays the VMS device name of the local port
 associated with the circuit.

RPORT_NUM

 The RPORT_NUM field displays the number of the port on the remote
 system associated with the circuit.

RP_OWNER

 The RP_OWNER field displays the port number of the owner of the port
 on the remote system.

RP_TYPE

 The RP_TYPE field displays the type of port on the remote system
 associated with the circuit.  The possible displays are:

        CI780   The remote port is a CI780.
        CI750   The remote port is a CI750.
        HSC50   The remote port is an HSC50.
        CINT    The remote port is a CI node tester.
        PASSTH  The remote port is in pass-through mode.

NUM_CONNECTIONS

 The NUM_CONNECTIONS field is a count of the number of connections
 established on the circuit between the local and remote system.

CIR_STATE

 The CIR_STATE field displays the state of the virtual circuit.  The
 circuit may be OPEN, CLOSED, in one of the open or close in
 progress states, or VC_FAIL.  The possible displays are:

        CLOSED   The circuit is closed.
        OPEN     The circuit is opened.
        ST_REC   The circuit has a start received.
        ST_SENT  The circuit has a start sent.
        VC_FAIL  A virtual circuit failure is in progress.

REM_STATE

 The REM_STATE field indicates the state of port on the remote system.
 The possible displays are:

        DISAB     The remote port is disabled.
        ENAB      The remote port is enabled.
        M_DISAB   The remote port is in maintenance mode, and is
                  disabled.
        M_ENAB    The remote port is in maintenance mode and is
                  enabled.
        M_UNINIT  The remote port is in maintenance mode, and has
                  not been initialized.
        UNINIT    The remote port has not been initialized.

CABLE_STATUS

 The CABLE_STATUS field indicates status of the path for the circuit
 from the CI interface on the local system to the CI interface on the
 remote system.  The field indicates which of the two paths (A and B)
 are good, or if the cables are crossed.  The possible displays are:

           -     Paths A and B are bad.
          A-     Path A is good.
           -B    Path B is good.
          A-B    Paths A and B are good.
        CROSSED  The cables are crossed.

RP_REVISION

 The RP_REVISION field indicates the hardware and/or microcode
 revision number of port on the remote system.

RP_FUNCTIONS

 The RP_FUNCTIONS field displays the function mask of port on the
 remote system.

SCS_WAITERS

 The SCS_WAITERS field displays a count of the number of connections
 waiting to send SCS control messages on the virtual circuit.

CONNECTIONS

 The connections class contains information about the connection established
 over a virtual circuit.  This class includes fields such as the names and
 ID  numbers of the local and remote processes, and the state of the
 connection.

 The fields which make up the connections class are:

Additional information available:

LOC_PROC_NAMEREM_PROC_NAMECON_STATELOC_CONID
REM_CONIDSCS_STATE

LOC_PROC_NAME

 The LOC_PROC_NAME field displays the name of the process on the
 local system associated with the connection.

REM_PROC_NAME

 The REM_PROC_NAME field displays the name of the process on the
 remote system associated with the connection.  This information is
 not available for connections in the listen state.

CON_STATE

 The CON_STATE field displays the state of the connection.
 The possible displays are:

        ACCP_SENT  An accept request has been sent.
        CLOSED     The connection is closed.
        CON_ACK    A connect request has been sent and acknowledged.
        CON_REC    A connect request has been received.
        CON_SENT   A connect request has been sent.
        DISC_ACK   A disconnect is acknowledged.
        DISC_MTCH  A disconnect request has matched.
        DISC_REC   A disconnect request has been received.
        DISC_SENT  A disconnect request has been sent.
        LISTEN     The connection is in the listen state.
        OPEN       The connection is open.
        REJ_SENT   A reject has been sent.
        VC_FAIL    The virtual circuit has failed.

LOC_CONID

 The LOC_CONID field displays the identification number of the
 process on the local system associated with the connection.

REM_CONID

 The REM_CONID field displays the identification number of the
 process on the remote system associated with the connection.  This
 information is not available for connections in the listen state.

SCS_STATE

 The SCS_STATE field displays the SCS send blocked state.  If the
 an SCS control message is waiting to be sent over the connection,
 the SCS send blocked state indicates what kind of message is
 waiting to be sent.  The possible displays are:

        ACCP_PEND  Waiting to send an accept request.
        CLEAR      Not blocked.
        CON_PEND   Waiting to send a connection request.
        CR_PEND    Waiting to send credit.
        DCR_PEND   Waiting to send credit in preparation for a
                   disconnect.
        DISC_PEND  Waiting to send a disconnect request.
        REJ_PEND   Waiting to send a reject request.

COUNTERS

 The counters class displays the counts for the total accumulated
 traffic over a connection for the life of the connection.  This
 class includes fields such as the number of application datagrams
 sent and received, the number of application messages sent and
 received, and the number of kilobytes sent and requested in block
 transfer mode.

Additional information available:

DGS_SENTDGS_RCVDDGS_DSCRDMSGS_SENTMSGS_RCVD
BLKS_SENTBLKS_REQKB_SENTKB_RCVDKB_MAPPED
CR_WAITSBDT_WAITS

DGS_SENT

 The DGS_SENT field is a count of the number of application
 datagrams sent over the connection from the local to the remote
 system.

DGS_RCVD

 The DGS_RCVD field is a count of the number of application
 datagrams received from the remote system by the local system
 and given to the sysap.

DGS_DSCRD

 The DGS_DSCRD field is a count of the number of application
 datagrams discarded by PADRIVER.

MSGS_SENT

 The MSGS_SENT field is a count of the number of messages sent
 over the connection from the local to the remote system.

MSGS_RCVD

 The MSGS_RCVD field is a count of the number of messages received
 over the connection by the local system from the remote system.

BLKS_SENT

 The BLKS_SENT field is a count of the number of block send datas
 initiated to block transfer data from the local to the remote
 system.

BLKS_REQ

 The BLKS_REQ field is a count of the number of block request datas
 initiated to block transfer data from the remote to the local
 system.

KB_SENT

 The KB_SENT field is a count of the number of kilobytes of data
 sent from the local to the remote system via send datas.

KB_RCVD

 The KB_RCVD field is a count of the number of kilobytes of data
 received by the local from the remote system via request datas.

KB_MAPPED

 The KB_MAPPED field displays the number of kilobytes mapped for
 block transfer.

CR_WAITS

 The CR_WAITS field is a count of the number of times this connection
 had to wait for send credit.

BDT_WAITS

 The BDT_WAITS field is a count of the number of times this connection
 had to wait for a buffer descriptor.

CREDITS

 The credits class displays the send and receive credit counts for each
 connection.  This class includes fields that indicate the minimum, current
 and initial credit counts.

 The fields which make up the credits class are:

Additional information available:

SENDMIN_SENDRECEIVEPEND_RECINIT_RECMIN_REC

SEND

 Current send credit.

MIN_SEND

 Minimum send credit.

RECEIVE

 Receive credit. (Send credit held by remote.)

PEND_REC

 Receive credit not yet extended to remote.

INIT_REC

 Initial receive credit extended to remote when connection was made.

MIN_REC

 Minimum receive credit. (Minimum send credit required by remote.)

LOCAL_PORTS

 The local ports class displays information regarding the CI interface on
 the  local system. This class includes fields such as the port name, port
 number,  port status, and the number of entries in the queues associated
 with each  port.

 The fields which make up the local port class are:

Additional information available:

NAMELP_STATUSPORT_NUMDGS_FREEMSGS_FREE
COUNTER_OWNERPOOL_WAITERSMSG_HDR_SIZEDG_OVRHD_SIZE
LP_TYPEOPEN_CIRCSFORM_CIRCSCMDS_QUEUED
RSPS_QUEUEDMAX_PORTPRT_MAPDGI_MAPLOG_MAP
LB_STATUS

NAME

 The VMS device name of the local port.

LP_STATUS

 Status of the local port. (i.e. online, offline)

PORT_NUM

 The port number assigned to the port.

DGS_FREE

 The number of free datagram buffers currently queued for receives.

MSGS_FREE

 The number of free message buffers currently queued for receives.

COUNTER_OWNER

 The name of the process currently using the port traffic counters.

POOL_WAITERS

 The number of processes waiting for non-paged pool resources for message
 buffers.

MSG_HDR_SIZE

 The number of bytes of port header and SCS header in a message.

DG_OVRHD_SIZE

 The number of bytes of port header, SCS header, and DECnet header in a
 datagram.

LP_TYPE

 The device type of the local port.  (i.e. CI780, CI750, HSC)

OPEN_CIRCS

 The number of virtual circuits open from the port.

FORM_CIRCS

 The number of formative circuits from the port.
 (i.e. virtual circuits with open in progress)

CMDS_QUEUED

 Total number of messages, datagrams, and port commands queued for
 transmission at all priorities by the port.

RSPS_QUEUED

 Total number of responses of all kinds received from the port, but not yet
 processed.

MAX_PORT

 The largest port number to which we try to open a virtual circuit.

PRT_MAP

 A sixteen bit bit-map displayed as 3 hex digits. Each bit in the map
 represents a port in the cluster that has been recognized by the host
 system.

DGI_MAP

 A sixteen bit bit-map displayed as 4 hex digits.  Each bit in the map
 represents a port in the cluster from which datagram reception has been
 disabled.

LOG_MAP

 A sixteen bit bit-map displayed as 4 hex digits.  Each bit in the map
 represents a port in the cluster for which an error has been logged
 upon the discovery of conflicting data between the information in the
 configuration database on the local system and the information
 provided by the remote system.  Once set, establishment of a virtual
 circuit to the remote system is no longer allowed.

LB_STATUS

 The loop-back status of each cable from the port to the star coupler.
 The possible displays are:

        A-B  Loopback tests pass on paths A and B.
        A-   Loopback tests pass on path A.
         -B  Loopback tests pass on path B.
         -   Loopback tests failed on paths A and B
        N/A  Loopback tests are not being done.

ERRORS

 The errors class displays a running count of the errors on each port along
 with the current number or reinitialization attempts remaining and the
 maximum number of times reinitialization can be attempted.

 The fields which make up the errors class are:

Additional information available:

ERT_COUNTERT_MAXNUM_ERRORS

ERT_COUNT

 The number of port reinitialization attempts remaining.

ERT_MAX

 The total number of times a recovery from fatal port errors can be
 attempted by shutting down all virtual circuits and connections and
 reinitializing the port.

NUM_ERRORS

 The number of errors that have been logged on the port since the system
 was booted.  This includes errors encountered in reinitialization attempts
 as well as recoverable errors such as virtual circuit failure.


Fields

 The fields available for display are:

 ACKR_SQ         ACK_LM          BDT_WAITS      BLKS_REQ        BLKS_SENT
 CABLE_STATUS    CIR_STATE       CL_QDVOTES     CL_QUORUM       CL_VOTES
 CNX_STATE       CON_STATE       CR_WAITS       CSID            DGS_DSCRD
 DGS_RCVD        DGS_SENT        DG_SIZE        DIR_WT          FORMED
 HW_TYPE         HW_VERS         INCARNATION    INCN_TIME       INIT_REC
 KB_MAPPED       KB_RCVD         KB_SENT        LAST_TRANSITION LOC_CONID
 LOC_PROC_NAME   LPORT_NAME      MEMSEQ         MIN_REC         MIN_SEND
 MSGS_RCVD       MSGS_SENT       MSG_SIZE       NODE            NUM_CIRCUITS
 NUM_CONNECTIONS PEND_REC        PROTOCOL       QDVOTES         QD_NAME
 QF_ACTIVE       QF_SAME         QF_VOTE        QUORUM          RCVD_SQ
 RECEIVE         REM_CONID       REM_PROC_NAME  REM_STATE       RPORT_NUM
 RP_FUNCTIONS    RP_OWNER        RP_REVISION    RP_TYPE         SCS_STATE
 SCS_WAITERS     SEND            SEND_SQ        SOFTWARE        STATUS
 SYS_ID          TRANSITION_TIME UNACKED        VOTES           WARMCDRPS
 CMDS_QUEUED     COUNTER_OWNER   DGI_MAP        DGS_FREE        DG_OVRHD_SIZE
 ERT_COUNT       ERT_MAX         FORM_CIRCS     LB_STATUS       LOG_MAP
 LP_STATUS       LP_TYPE         MAX_PORT       MSGS_FREE       MSG_HDR_SIZE
 NAME            NUM_ERRORS      OPEN_CIRCS     POOL_WAITERS    PORT_NUM
 PRT_MAP         RSPS_QUEUED


Additional information available:

ACKR_SQACK_LIMBDT_WAITSBLKS_REQBLKS_SENT
CABLE_STATUSCIR_STATECL_QDVOTESCL_QUORUM
CL_VOTESCNX_STATECON_STATECR_WAITSCSID
DGS_DSCRDDGS_RCVDDGS_SENTDG_SIZEDIR_WTFORMED
HW_TYPEHW_VERSINCARNATIONINCN_TIMEINIT_REC
KB_MAPPEDKB_RCVDKB_SENTLAST_TRANSITIONLOC_CONID
LOC_PROC_NAMELPORT_NAMEMEMSEQMIN_RECMIN_SEND
MSGS_RCVDMSGS_SENTMSG_SIZENODENUM_CIRCUITS
NUM_CONNECTIONSPEND_RECPROTOCOLQDVOTESQD_NAMEQF_ACTIVE
QF_SAMEQF_VOTEQUORUMRCVD_SQRECEIVEREM_CONID
REM_PROC_NAMEREM_STATERPORT_NUMRP_FUNCTIONS
RP_OWNERRP_REVISIONRP_TYPESCS_STATESCS_WAITERS
SENDSEND_SQSOFTWARESTATUSSYS_IDTRANSITION_TIME
UNACKEDVOTESWARMCDRPSCMDS_QUEUEDCOUNTER_OWNER
DGI_MAPDGS_FREEDG_OVRHD_SIZEERT_COUNTERT_MAX
FORM_CIRCSLB_STATUSLOG_MAPLP_STATUS
LP_TYPEMAX_PORTMSGS_FREEMSG_HDR_SIZE
NAMENUM_ERRORSOPEN_CIRCSPOOL_WAITERS
PORT_NUMPRT_MAPRSPS_QUEUED

ACKR_SQ

 The ACKR_SQ field displays the sequence number of the last
 acknowledge received via the VAXcluster connection.

ACK_LIM

 The ACK_LIM field displays the maximum number of VAXcluster messages
 that can be received by the remote system before an acknowledgement
 reply is sent.

BDT_WAITS

 The BDT_WAITS field is a count of the number of times this connection
 had to wait for a buffer descriptor.

BLKS_REQ

 The BLKS_REQ field is a count of the number of block request datas
 initiated to block transfer data from the remote to the local
 system.

BLKS_SENT

 The BLKS_SENT field is a count of the number of block send datas
 initiated to block transfer data from the local to the remote
 system.

CABLE_STATUS

 The CABLE_STATUS field indicates status of the path for the circuit
 from the CI interface on the local system to the CI interface on the
 remote system.  The field indicates which of the two paths (A and B)
 are good, or if the cables are crossed.  The possible displays are:

           -     Paths A and B are bad.
          A-     Path A is good.
           -B    Path B is good.
          A-B    Paths A and B are good.
        CROSSED  The cables are crossed.

CIR_STATE

 The CIR_STATE field displays the state of the virtual circuit.  The
 circuit may be OPEN, CLOSED, in one of the open or close in
 progress states, or VC_FAIL.  The possible displays are:

        CLOSED   The circuit is closed.
        OPEN     The circuit is opened.
        ST_REC   The circuit has a start received.
        ST_SENT  The circuit has a start sent.
        VC_FAIL  A virtual circuit failure is in progress.

CL_QDVOTES

 The CL_QDVOTES field displays the number of quorum votes currently
 being contributed by the quorum disk.

CL_QUORUM

 The CL_QUORUM field displays the number of votes required for the
 cluster to have quorum.

CL_VOTES

 THE CL_VOTES field displays the total number of quorum votes
 currently being contributed by all cluster members and the quorum
 disk.

CNX_STATE

 The CNX_STATE field displays the state of the VAXcluster connection.
 The possible displays are:

        ACCEPT      Accepting the initial connection.
        CLOSED      The connection is closed.
        CONNECT     Attempting the initial connection.
        DEAD        No connection is possible.
        DISCONNECT  A disconnection is in progress.
        NEW         No attempt to make a connection has been made yet.
        OPEN        The connection is open.
        REACCEPT    The connection is accepting the reconnect request.
        RECONNECT   The connection is attempting to reconnect.
        WAIT        A time-out is in progress.

CON_STATE

 The CON_STATE field displays the state of the connection.
 The possible displays are:

        ACCP_SENT  An accept request has been sent.
        CLOSED     The connection is closed.
        CON_ACK    A connect request has been sent and acknowledged.
        CON_REC    A connect request has been received.
        CON_SENT   A connect request has been sent.
        DISC_ACK   A disconnect is acknowledged.
        DISC_MTCH  A disconnect request has matched.
        DISC_REC   A disconnect request has been received.
        DISC_SENT  A disconnect request has been sent.
        LISTEN     The connection is in the listen state.
        OPEN       The connection is open.
        REJ_SENT   A reject has been sent.
        VC_FAIL    The virtual circuit has failed.

CR_WAITS

 The CR_WAITS field is a count of the number of times this connection
 had to wait for send credit.

CSID

 The Cluster System ID.

DGS_DSCRD

 The DGS_DSCRD field is a count of the number of application
 datagrams discarded by PADRIVER.

DGS_RCVD

 The DGS_RCVD field is a count of the number of application
 datagrams received from the remote system by the local system
 and given to the sysap.

DGS_SENT

 The DGS_SENT field is a count of the number of application
 datagrams sent over the connection from the local to the remote
 system.

DG_SIZE

 The DG_SIZE field displays the maximum number of bytes of application
 data in datagrams transferred over the circuit.

DIR_WT

 The DIR_WT field displays the Lock Manager distributed directory
 weight.

FORMED

 The time at which the cluster was formed.
 (DD-MMM-YY HH:MM).

HW_TYPE

 The HW_TYPE field displays the type of hardware or processor type
 of the remote system.


 NOTE:  The hardware-types displayed in this field can be used with
        the ADD and REMOVE SYSTEM/TYPE=(hw-type,...) commands.

HW_VERS

   If the remote system is an HSC then the twelve bytes displayed
 in this field reflect the hardware type and microcode level of one
 of six requestors in the HSC.  The left byte in each pair is the
 hardware type, the right byte is the microcode version.  If zeros
 appear in both bytes, then the requestor is not present.  The
 requestors are numbered 2 through 7 as shown in the following
 table.  T is the hardware type.  V is the microcode version.

    Req. 7    Req. 6    Req. 5    Req. 4    Req. 3    Req. 2
 +----+----+----+----+----+----+----+----+----+----+----+----+
 |  T   V  |  T   V  |  T   V  |  T    V |  T    V |  T    V |
 +----+----+----+----+----+----+----+----+----+----+----+----+


   If the remote system is a VAX, then the lower four bytes
 reflect the contents of the system ID register for the processor.
 The upper two bytes are unused.  The remaining six bytes are
 processor specific and are defined as shown in the following table:

            B3        B4        B5        B6        B7       B8
       +---------+---------+---------+---------+---------+---------+
 8600  |                 unused                |     Processor     |
       +---------+---------+---------+---------+---------+---------+
  785  |  WCS 1  | flags 2 |        WCS        |PCS/WCS 3|   PCS   |
       +---------+---------+---------+---------+---------+---------+
  782  |  WCS 1  | flags 2 |        WCS        |   PCS   |   FPLA  |
       +---------+---------+---------+---------+---------+---------+
  780  |  WCS 1  | flags 2 |        WCS        |   PCS   |   FPLA  |
       +---------+---------+---------+---------+---------+---------+
  750  |                           unused                          |
       +---------+---------+---------+---------+---------+---------+

  All fields unless noted below refer to microcode revision levels.

  1 WCS size
  2 FPA, G and H floating flags
  3 PCS/WCA match revision

INCARNATION

 The value displayed in the INCARNATION field is a unique 16 digit
 (hex) number established when the system is booted.

INCN_TIME

 The INCN_TIME is the incarnation number expressed as a time
 (DD-MMM-YY HH:MM)

 For additional information, see HELP field INCARNATION.

INIT_REC

 Initial receive credit extended to remote when connection was made.

KB_MAPPED

 The KB_MAPPED field displays the number of kilobytes mapped for
 block transfer.

KB_RCVD

 The KB_RCVD field is a count of the number of kilobytes of data
 received by the local from the remote system via request datas.

KB_SENT

 The KB_SENT field is a count of the number of kilobytes of data
 sent from the local to the remote system via send datas.

LAST_TRANSITION

 The LAST_TRANSITION time is the time at which a system last left
 or joined the cluster.  (DD-MMM-YY HH:MM)

LOC_CONID

 The LOC_CONID field displays the identification number of the
 process on the local system associated with the connection.

LOC_PROC_NAME

 The LOC_PROC_NAME field displays the name of the process on the
 local system associated with the connection.

LPORT_NAME

 The LPORT_NAME field displays the VMS device name of the local port
 associated with the circuit.

MEMSEQ

 The MEMSEQ field displays the membership state sequence number.

MIN_REC

 Minimum receive credit. (Minimum send credit required by remote.)

MIN_SEND

 Minimum send credit.

MSGS_RCVD

 The MSGS_RCVD field is a count of the number of messages received
 over the connection by the local system from the remote system.

MSGS_SENT

 The MSGS_SENT field is a count of the number of messages sent
 over the connection from the local to the remote system.

MSG_SIZE

 The MSG_SIZE field displays the maximum number of bytes of application
 data in messages transferred over the circuit.

NODE

 The NODE field displays the nodename of the remote system.
 The nodename is determined by the SYSGEN parameter SCSNODE
 and should be the same the DECnet nodename.


 NOTE:  The node-names displayed in this field can be used with the
        ADD and REMOVE SYSTEM/NODE=(node-name,...) commands.

NUM_CIRCUITS

 The NUM_CIRCUITS field displays a count of the number of virtual
 circuits established between the local and the remote system.

NUM_CONNECTIONS

 The NUM_CONNECTIONS field is a count of the number of connections
 established on the circuit between the local and remote system.

PEND_REC

 Receive credit not yet extended to remote.

PROTOCOL

 The PROTOCOL field displays the protocol version number and ECO
 level of the connection management software.

QDVOTES

 The QDVOTES field displays number of votes which the remote system
 recommends be contributed by the quorum disk.  The recommended
 number of votes is determined by the SYSGEN QDVOTES parameter.

QD_NAME

 The full device name of the quorum disk.

QF_ACTIVE

 The QF_ACTIVE field indicates whether or not the remote system's
 quorum file is accessable.

QF_SAME

 The QF_SAME field indicates whether or not the remote system and
 local system agree as to which disk is the quorum disk.

QF_VOTE

 The QF_VOTE field indicates whether or not the quorum disk is
 contributing any votes.

QUORUM

 The QUORUM field displays the recommended quorum value set for the
 remote system.  The recommended quorum value for a node is
 determined by the SYSGEN QUORUM parameter.

RCVD_SQ

 The RCVD_SQ field displays the sequence number of the last message
 to be received via the VAXcluster connection.

RECEIVE

 Receive credit. (Send credit held by remote.)

REM_CONID

 The REM_CONID field displays the identification number of the
 process on the remote system associated with the connection.  This
 information is not available for connections in the listen state.

REM_PROC_NAME

 The REM_PROC_NAME field displays the name of the process on the
 remote system associated with the connection.  This information is
 not available for connections in the listen state.

REM_STATE

 The REM_STATE field indicates the state of port on the remote system.
 The possible displays are:

        DISAB     The remote port is disabled.
        ENAB      The remote port is enabled.
        M_DISAB   The remote port is in maintenance mode, and is
                  disabled.
        M_ENAB    The remote port is in maintenance mode and is
                  enabled.
        M_UNINIT  The remote port is in maintenance mode, and has
                  not been initialized.
        UNINIT    The remote port has not been initialized.

RPORT_NUM

 The RPORT_NUM field displays the number of the port on the remote
 system associated with the circuit.

RP_FUNCTIONS

 The RP_FUNCTIONS field displays the function mask of port on the
 remote system.

RP_OWNER

 The RP_OWNER field displays the port number of the owner of the port
 on the remote system.

RP_REVISION

 The RP_REVISION field indicates the hardware and/or microcode
 revision number of port on the remote system.

RP_TYPE

 The RP_TYPE field displays the type of port on the remote system
 associated with the circuit.  The possible displays are:

        CI780   The remote port is a CI780.
        CI750   The remote port is a CI750.
        HSC50   The remote port is an HSC50.
        CINT    The remote port is a CI node tester.
        PASSTH  The remote port is in pass-through mode.

SCS_STATE

 The SCS_STATE field displays the SCS send blocked state.  If the
 an SCS control message is waiting to be sent over the connection,
 the SCS send blocked state indicates what kind of message is
 waiting to be sent.  The possible displays are:

        ACCP_PEND  Waiting to send an accept request.
        CLEAR      Not blocked.
        CON_PEND   Waiting to send a connection request.
        CR_PEND    Waiting to send credit.
        DCR_PEND   Waiting to send credit in preparation for a
                   disconnect.
        DISC_PEND  Waiting to send a disconnect request.
        REJ_PEND   Waiting to send a reject request.

SCS_WAITERS

 The SCS_WAITERS field displays a count of the number of connections
 waiting to send SCS control messages on the virtual circuit.

SEND

 Current send credit.

SEND_SQ

 The SEND_SQ field displays the sequence number of the next message
 to be sent via the VAXcluster connection.

SOFTWARE

 The SOFTWARE field displays the name and version of the operating
 system being run on the remote system.

STATUS

 The STATUS field indicates the remote system's membership status in
 the cluster.  The possible displays are:

        (blank)  The system is not being considered for cluster
                 membership.

        BRK_MEM  The system is a member of the cluster, but the
                 connection manager has lost communication with it.

        BRK_NEW  The system has just booted, but has not yet joined
                 the cluster and the connection manager has lost
                 communication with it.

        BRK_NON  The connection manager has lost communication with
                 the system and the system is no longer a member of
                 the cluster.  It is now a non-member.

        BRK_REM  The connection manager has lost communication with
                 the system and the system has been removed from the
                 cluster.

        MEMBER   The system is participating in the cluster (A default
                 SYSGEN parameter allows 90 seconds delay before a
                 failing system is removed from cluster membership
                 status.)

        NEW      The system has just booted, but has not yet joined
                 the cluster.  If this system would normally be a member
                 of the cluster, and is displaying NEW in this field,
                 you can expect that the display will eventually change
                 to MEMBER.

        NON      The system is not a member of the cluster

        REMOVED  The system has been removed from the cluster.

SYS_ID

 The SYS_ID field displays identification number of the remote system.
 This ID number is determined by the sysgen parameters SCSSYSTEMID and
 SCSSYSTEMIDH.  The system-id should be the same as the DECnet node
 address.


 NOTE:  The system-ids displayed in this field can be used with the
        ADD and REMOVE SYSTEM/ID=(system-id,...) commands.

TRANSITION_TIME

 The TRANSITION_TIME field displays the time at which the system's
 membership status last changed.

 For additional information, see HELP field STATUS.

UNACKED

 The UNACKED field displays the number of unacknowledged VAXcluster
 messages received by the remote system.

VOTES

 The VOTES field displays the number of votes the remote system
 contributes toward quorum.  The number of votes contributed is
 determined by the SYSGEN VOTES parameter.

WARMCDRPS

 The WARMCDRPS field displays a count of the number of CDRPS on the
 CDRP free queue.

CMDS_QUEUED

 Total number of messages, datagrams, and port commands queued for
 transmission at all priorities by the port.

COUNTER_OWNER

 The name of the process currently using the port traffic counters.

DGI_MAP

 A sixteen bit bit-map displayed as 4 hex digits.  Each bit in the map
 represents a port in the cluster from which datagram reception has been
 disabled.

DGS_FREE

 The number of free datagram buffers currently queued for receives.

DG_OVRHD_SIZE

 The number of bytes of port header, SCS header, and DECnet header in a
 datagram.

ERT_COUNT

 The number of port reinitialization attempts remaining.

ERT_MAX

 The total number of times a recovery from fatal port errors can be
 attempted by shutting down all virtual circuits and connections and
 reinitializing the port.

FORM_CIRCS

 The number of formative circuits from the port.
 (i.e. virtual circuits with open in progress)

LB_STATUS

 The loop-back status of each cable from the port to the star coupler.
 The possible displays are:

        A-B  Loopback tests pass on paths A and B.
        A-   Loopback tests pass on path A.
         -B  Loopback tests pass on path B.
         -   Loopback tests failed on paths A and B
        N/A  Loopback tests are not being done.

LOG_MAP

 A sixteen bit bit-map displayed as 4 hex digits.  Each bit in the map
 represents a port in the cluster for which an error has been logged
 upon the discovery of conflicting data between the information in the
 configuration database on the local system and the information
 provided by the remote system.  Once set, establishment of a virtual
 circuit to the remote system is no longer allowed.

LP_STATUS

 Status of the local port. (i.e. online, offline)

LP_TYPE

 The device type of the local port.  (i.e. CI780, CI750, HSC)

MAX_PORT

 The largest port number to which we try to open a virtual circuit.

MSGS_FREE

 The number of free message buffers currently queued for receives.

MSG_HDR_SIZE

 The number of bytes of port header and SCS header in a message.

NAME

 The VMS device name of the local port.

NUM_ERRORS

 The number of errors that have been logged on the port since the system
 was booted.  This includes errors encountered in reinitialization attempts
 as well as recoverable errors such as virtual circuit failure.

OPEN_CIRCS

 The number of virtual circuits open from the port.

POOL_WAITERS

 The number of processes waiting for non-paged pool resources for message
 buffers.

PORT_NUM

 The port number assigned to the port.

PRT_MAP

 A sixteen bit bit-map displayed as 4 hex digits. Each bit in the map
 represents a port in the cluster that has been recognized by the host
 system.

RSPS_QUEUED

 Total number of responses of all kinds received from the port, but not yet
 processed.


Procedure

 Requests the internal command interpreter to read subsequent command
 input from a specific file or device.  The file may contain any valid
 interactive command.  Command files may be nested to 16 levels.  The
 file type defaults to .COM.

 Format:

        @file-spec


 Note:  If the logical name SHOW_CLUSTER$INIT is defined, then Show
        Cluster will use the directory defined by SHOW_CLUSTER$INIT
        to locate the command file specified.  If SHOW_CLUSTER$INIT
        is not defined Show Cluster will look for the command file
        in the current default directory.

 To execute a command procedure upon invoking SHOW CLUSTER define the
 logical name SHOW_CLUSTER$INIT to equate to the filespec you would like
 SHOW CLUSTER to execute.  The file type defaults to .INI.

Typewritten Software • bear@typewritten.org • Edmonds, WA 98026