  | 
		
OpenVMS System Management Utilities Reference
Manual
 
 
CREDITS Class
 
 
The CREDITS class displays the send and receive credit counts for each
connection.
 
  
    | Field Name  | 
    Description  | 
   
  
    | 
      INIT_REC
     | 
    
      Initial receive credit extended to the remote system when the
      connection was made.
     | 
   
  
    | 
      MIN_REC
     | 
    
      Minimum receive credit (minimum send credit required by the remote
      system).
     | 
   
  
    | 
      MIN_SEND
     | 
    
      Minimum send credit.
     | 
   
  
    | 
      PEND_REC
     | 
    
      Receive credit not yet extended to the remote system.
     | 
   
  
    | 
      RECEIVE
     | 
    
      Receive credit (send credit held by the remote system).
     | 
   
  
    | 
      SEND
     | 
    
      Current send credit.
     | 
   
 
ERRORS Class
 
 
The ERRORS class displays a count of the errors on each port, along
with information about the feasibility of reinitializing a port.
 
  
    | Field Name  | 
    Description  | 
   
  
    | 
      ERT_COUNT
     | 
    
      Number of port reinitialization attempts remaining.
     | 
   
  
    | 
      ERT_MAX
     | 
    
      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
     | 
    
      Number of errors that have been logged on the port since the system was
      booted. This number includes errors encountered in reinitialization
      attempts as well as recoverable errors, such as virtual circuit
      failure. This is the same error count as that displayed by the DCL
      command SHOW DEVICE.
     | 
   
 
LOCAL_PORTS Class
 
 
The LOCAL_PORTS class displays information about the local system
interface to the cluster, such as the name, number, and status of each
port, and the number of entries in the queues associated with each port.
 
  
    | Field Name  | 
    Description  | 
   
  
    | 
      BUFF_DESCR
     | 
    
      Number of buffer descriptors in use.
     | 
   
  
    | 
      CMDS_QUEUED
     | 
    
      Total number of messages, datagrams, and port commands queued for
      transmission at all priorities by the port.
     | 
   
  
    | 
      COUNTER_OWNER
     | 
    
      Name of the process currently using the port traffic counters.
     | 
   
  
    | 
      DGI_MAP
     | 
    
      A 16-bit bit map displayed as four hexadecimal digits. Each bit in the
      map represents a port in the cluster from which datagram reception has
      been disabled.
     | 
   
  
    | 
      DG_OVRHD_SIZE
     | 
    
      Number of bytes of port header, SCS header, and DECnet header in a
      datagram.
     | 
   
  
    | 
      DGS_FREE
     | 
    
      Number of free datagram buffers currently queued for receive commands.
     | 
   
  
    | 
      FORM_CIRCS
     | 
    
      Number of formative circuits (circuits in the process of opening) from
      the port.
     | 
   
  
    | 
      FREE_BUFF
     | 
    
      Number of CI buffer descriptors free for use.
     | 
   
  
    | 
      LB_STATUS
     | 
    
      Loopback status of each cable from the port to the star coupler. The
      field applies only to CI. Possible displays are as follows:
      
        
          | 
            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 16-bit bit map displayed as four hexadecimal digits. Each bit in the
      map represents a port in the cluster for which an error was logged.
      Errors are logged when data provided by the configuration database on
      the local system conflicts with data provided by the remote system.
      When a conflict is discovered and an error is logged, virtual circuits
      to the remote system can no longer be established.
     | 
   
  
    | 
      LP_STATUS
     | 
    
      Status of the local port. The port is either on line or off line.
     | 
   
  
    | 
      LP_TYPE
     | 
    
      Device type of the port (CI780, CI750).
     | 
   
  
    | 
      MAX_PORT
     | 
    
      Largest port number to which a virtual circuit open is attempted.
     | 
   
  
    | 
      MSGS_FREE
     | 
    
      Number of free message buffers currently queued for receives commands.
     | 
   
  
    | 
      MSG_HDR_SIZE
     | 
    
      Number of bytes of port header and SCS header in a message.
     | 
   
  
    | 
      NAME
     | 
    
      Device name of the local port.
     | 
   
  
    | 
      OPEN_CIRCS
     | 
    
      Number of virtual circuits open from the port.
     | 
   
  
    | 
      POOL_WAITERS
     | 
    
      Number of processes waiting for nonpaged pool resources for message
      buffers.
     | 
   
  
    | 
      PORT_NUM
     | 
    
      Port number assigned to the port.
     | 
   
  
    | 
      PRT_MAP
     | 
    
      A 16-bit bit map displayed as three hexadecimal 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.
     | 
   
 
MEMBERS Class
 
 
The MEMBERS class contains information about active systems in the
cluster, such as their identification numbers and membership status.
 
  
    | Field Name  | 
    Description  | 
   
  
    | 
      ACK_LM
     | 
    
      Maximum number of OpenVMS Cluster messages the remote system can
      receive before sending an acknowledgment.
     | 
   
  
    | 
      ACKR_SQ
     | 
    
      Sequence number of the last acknowledgment received over the cluster
      connection.
     | 
   
  
    | 
      CNX_STATE
     | 
    
      State of the cluster connection. Possible displays are as follows:
      
        
          | 
            ACCEPT
           | 
          
            Initial connection is accepted.
           | 
         
        
          | 
            CLOSED
           | 
          
            Connection is closed.
           | 
         
        
          | 
            CONNECT
           | 
          
            Initial connection is being accepted.
           | 
         
        
          | 
            DEAD
           | 
          
            No connection is possible.
           | 
         
        
          | 
            DISCONNECT
           | 
          
            Disconnection is in progress.
           | 
         
        
          | 
            NEW
           | 
          
            No attempt to make a connection has been made yet.
           | 
         
        
          | 
            OPEN
           | 
          
            Connection is open.
           | 
         
        
          | 
            REACCEPT
           | 
          
            Connection is accepting the reconnect request.
           | 
         
        
          | 
            RECONNECT
           | 
          
            Connection is attempting to reconnect.
           | 
         
        
          | 
            WAIT
           | 
          
            Timeout is in progress.
           | 
         
       
     | 
   
  
    | 
      CSID
     | 
    
      Cluster system identification number. This number is unique over the
      life of the cluster. Unlike SYS_ID, this identification number may
      change when the system reboots.
     | 
   
  
    | 
      DIR_WT
     | 
    
      Lock manager distributed directory weight.
     | 
   
  
    | 
      EXPECTED_VOTES
     | 
    
      Maximum number of votes that an individual node can encounter. Used as
      an initial estimate for computing CL_EXPECTED_VOTES. The cluster
      manager sets this number using the EXPECTED_VOTES system parameter. It
      is possible for this field to display a number smaller than the
      EXPECTED_VOTES parameter setting if the REMOVE_NODE option was used to
      shut down a cluster member or the SET CLUSTER/EXPECTED_VOTES DCL
      command was used since this node was last rebooted. The dynamic value
      for EXPECTED_VOTES used clusterwide is the CL_EXPECTED_VOTES field,
      which is described in the CLUSTER class category of ADD (Field).
     | 
   
  
    | 
      PROTOCOL
     | 
    
      Protocol version number and ECO level of the connection management
      software.
     | 
   
  
    | 
      QDVOTES
     | 
    
      Number of votes the remote system recommends be contributed by the
      quorum disk. Normally, the cluster manager sets this number using the
      system parameter QDSKVOTES.
     | 
   
  
    | 
      QF_ACTIVE
     | 
    
      Indicates whether the remote system's quorum file is accessible.
     | 
   
  
    | 
      QF_SAME
     | 
    
      Indicates whether the local and remote systems agree about which disk
      is the quorum disk.
     | 
   
  
    | 
      QF_WATCHER
     | 
    
      Remote system has an active connection to the quorum disk and can
      verify its connection for members unable to access the disk directly.
     | 
   
  
    | 
      QUORUM
     | 
    
      Derived from EXPECTED_VOTES and calculated by the connection manager.
      It represents an initial value for the minimum number of votes that
      must be present for this node to function. The dynamic QUORUM value is
      the CL_QUORUM field, which is described in the CLUSTER class category
      of ADD (Field).
     | 
   
  
    | 
      RCVD_SQ
     | 
    
      Sequence number of the last message received over the OpenVMS Cluster
      connection.
     | 
   
  
    | 
      RECNXINTERVAL
     | 
    
      Displays the time (in seconds) that the connection manager will wait
      before timing out the corresponding connection. It is the maximum of
      the value contained in the system parameter RECNXINTERVAL on the local
      node and the amount of time it would take for the connection manager on
      the remote node to discover that the connection is broken.
     | 
   
  
    | 
      SEND_SQ
     | 
    
      Sequence number of the next message to be sent over the OpenVMS Cluster
      connection.
     | 
   
  
    | 
      STATUS
     | 
    
      Status of the node in the cluster. Possible displays are as follows:
      
        
          | 
            blank
           | 
          
            System is not being considered as a cluster member.
           | 
         
        
          | 
            BRK_MEM
           | 
          
            System is a member of the cluster, but the connection manager has lost
            communication with it.
           | 
         
        
          | 
            BRK_NEW
           | 
          
            System has just booted, but has not yet joined the cluster and the
            connection manager has lost communication with it.
           | 
         
        
          | 
            BRK_NON
           | 
          
            Connection manager has lost communication with the system and the
            system is no longer a member of the cluster.
           | 
         
        
          | 
            BRK_REM
           | 
          
            Connection manager has lost communication with the system, and the
            system has been removed from the cluster.
           | 
         
        
          | 
            MEMBER
           | 
          
            System is participating in the cluster.
           | 
         
        
          | 
            NEW
           | 
          
            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
           | 
          
            System is not a member of the cluster.
           | 
         
        
          | 
            REMOVED
           | 
          
            System has been removed from the cluster.
           | 
         
       
     | 
   
  
    | 
      SW_VERS
     | 
    
      Indicator of the software version running on the node.
     | 
   
  
    | 
      TRANSITION_TIME
     | 
    
      Time of the system's last change in membership status. (See the STATUS
      field.)
     | 
   
  
    | 
      UNACKED
     | 
    
      Number of unacknowledged OpenVMS Cluster messages received by the
      remote system.
     | 
   
  
    | 
      VOTES
     | 
    
      Number of votes the remote node contributes toward quorum. Normally,
      the cluster manager sets this number with the system parameter VOTES.
     | 
   
  
    | 
      WARMCDRPS
     | 
    
      Number of CDRPs on the CDRP free queue.
     | 
   
 
SYSTEMS Class
 
 
The SYSTEMS class lists information about all systems in the cluster,
such as their identification numbers, node names, hardware types, and
software versions.
 
  
    | Field Name  | 
    Description  | 
   
  
    | 
      DG_SIZE
     | 
    
      Maximum number of bytes of application data in datagrams sent over the
      circuit.
     | 
   
  
    | 
      HW_TYPE
     | 
    
      System hardware type (for example, VAXstation 3100 or HS70). (Enclose
      the system type between double quotation marks.)
     | 
   
  
    | 
      HW_VERS
     | 
    
      Hardware configuration and revision levels of the remote system.
     | 
   
  
    | 
      INCARNATION
     | 
    
      Unique 16-digit hexadecimal number established when the system is
      booted.
     | 
   
  
    | 
      INCN_TIME
     | 
    
      Incarnation number expressed as a time (dd-mmm-yy hh:mm).
     | 
   
  
    | 
      MSG_SIZE
     | 
    
      Maximum number of bytes of application data in messages sent over the
      circuit.
     | 
   
  
    | 
      NODE
     | 
    
      Node name of the remote system. Normally, the cluster manager sets the
      node name using the system parameter SCSNODE. The node name should be
      the same as the DECnet node name.
     | 
   
  
    | 
      NUM_CIRCUITS
     | 
    
      Number of virtual circuits between the local system and remote systems.
     | 
   
  
    | 
      SOFTWARE
     | 
    
      Name and version of the operating system currently running on the
      remote system.
     | 
   
  
    | 
      SYS_ID
     | 
    
      Identification number of the remote system. Normally, the cluster
      manager sets this number using the system parameters SCSSYSTEMID and
      SCSSYSTEMIDH. This number should be the same as the DECnet node number.
     | 
   
 
 
Qualifiers
None.
 
 
Description
The ADD (Field) command enables and adds specific fields of information
to a SHOW CLUSTER display. When you add a field for a class that is not
currently being displayed, the class heading of that field is added to
the display. The qualifier /ALL on any ADD (Class) command adds all
fields in the class to the display.
To remove a field from the SHOW CLUSTER display, enter the REMOVE
(Field) command.
  
 
Examples
 
This command enables the CREDITS class field SEND and adds it to the
SHOW CLUSTER display.
  
  
    | #2 | 
   
    
       
      
COMMAND> ADD REM_STATE,REM_CONID,LOC_CONID
      
      
     | 
   
 
This command enables the CIRCUITS class field REM_STATE and the
CONNECTIONS class fields REM_CONID and LOC_CONID, and adds them to the
SHOW CLUSTER display.
  
ADD LOCAL_PORTS
 
Adds all currently enabled LOCAL_PORTS class fields to the SHOW CLUSTER
display.
 
 
Format
ADD LOCAL_PORTS
  
 
Parameters
None.
 
 
Qualifier
/ALL
 Specifies that all fields in this class are added to the display.
 
 
Description
The ADD LOCAL_PORTS command adds LOCAL_PORTS class information to the
SHOW CLUSTER display. This information includes data for all currently
enabled fields in the LOCAL_PORTS class. By default, the NAME,
LP_STATUS (port status), PORT_NUM (port number), DGS_FREE (free
datagrams queued), MSGS_FREE (free messages queued), OPEN_CIRCS (open
circuits), and FORM_CIRCS (formative circuits) fields are enabled. For
a list of valid LOCAL_PORTS class fields, see the ADD (Field) command.
Use the ADD LOCAL_PORTS command with the REMOVE LOCAL_PORTS command to
turn the display of LOCAL_PORTS class information on and off. If you
remove the LOCAL_PORTS class from the display and add it again without
changing any fields, all of the same fields are displayed again. If,
however, you remove the LOCAL_PORTS class and add new LOCAL_PORTS class
fields, all previously enabled fields are disabled, and only the newly
added fields are displayed.
  
 
Examples
 
  
    | #1 | 
   
    
       
      
COMMAND> ADD LOCAL_PORTS
      
      
     | 
   
 
This command adds LOCAL_PORTS class information to the display. This
information includes all enabled LOCAL_PORTS class fields.
  
  
    | #2 | 
   
    
       
      
COMMAND> REMOVE LOCAL_PORTS
COMMAND> ADD LB_STATUS
COMMAND> REMOVE LOCAL_PORTS
   .
   .
   .
COMMAND> ADD LOCAL_PORTS
        
      
     | 
   
 
The ADD LOCAL_PORTS command in this example sequence adds LOCAL_PORTS
class information to the SHOW CLUSTER display. The first command
removes the LOCAL_PORTS class from the display. The second command, ADD
LB_STATUS, adds the LOCAL_PORTS class field LB_STATUS to the display.
As a result, all other LOCAL_PORTS class fields are disabled. When the
LOCAL_PORTS class is removed and added again, only the LB_STATUS field
is displayed.
  
ADD MEMBERS
 
Adds all currently enabled MEMBERS class fields to the SHOW CLUSTER
display.
 
 
Format
ADD MEMBERS
  
 
Parameters
None.
 
 
Qualifier
/ALL
 Specifies that all fields in this class are added to the display.
 
 
Description
The ADD MEMBERS command adds MEMBERS class information to the SHOW
CLUSTER display. This information includes data for all currently
enabled fields in the MEMBERS class. By default, the STATUS field is
enabled. For a list of valid MEMBERS class fields, see the ADD (Field)
command.
Use the ADD MEMBERS command with the REMOVE MEMBERS command to turn the
display of MEMBERS class information on and off. If you remove the
MEMBERS class from the display and add it again without changing any
fields, all of the same fields are displayed again. If, however, you
remove the MEMBERS class and add new MEMBERS class fields, all
previously enabled fields are disabled, and only the newly added fields
are displayed.
  
 
Examples
 
This command adds MEMBERS class information to the display. This
information includes all enabled MEMBERS class fields.
  
  
    | #2 | 
   
    
       
      
COMMAND> REMOVE MEMBERS
COMMAND> ADD VOTES
COMMAND> REMOVE MEMBERS
   .
   .
   .
COMMAND> ADD MEMBERS
      
      
     | 
   
 
The ADD MEMBERS command in this example sequence adds MEMBERS class
information to the SHOW CLUSTER display. The first command removes the
MEMBERS class from the display. The second command, ADD VOTES, adds the
MEMBERS class field VOTES to the display. As a result, all other
MEMBERS class fields are disabled. When the MEMBERS class is removed
and added again, only the VOTES field is displayed.
  
  
  
		 |