OpenVMS I/O User's Reference Manual

Document revision date: 19 July 1999

OpenVMS I/O User's Reference Manual

Contents

Index

Several protocol errors are also included in a separate subblock. The protocol errors item code is LAT$_ITM_PROTOCOL_ERRORS and has LAT$V_STRING set (the size of the subblock is contained in the first byte following the item code). The item codes and the events they represent are listed in Table 5-21.

Table 5-21 Protocol Error Item Codes
Item Codes Meaning

LAT$_ITM_CTPRO_IVM (LOCAL) Invalid message type received.

LAT$_ITM_CTPRO_ISM (LOCAL) Invalid start message received.

LAT$_ITM_CTPRO_IVS (LOCAL) Invalid sequence number received.

LAT$_ITM_CTPRO_NIZ (LOCAL) Zero-node index received.

LAT$_ITM_CTPRO_ICI (LOCAL) Node circuit index out of range.

LAT$_ITM_CTPRO_CSI (LOCAL) Node circuit sequence invalid.

LAT$_ITM_CTPRO_NLV (LOCAL) Node circuit index no longer valid.

LAT$_ITM_CTPRO_HALT (LOCAL) Circuit was forced to halt.

LAT$_ITM_CTPRO_MIZ (LOCAL) Invalid master slot index.

LAT$_ITM_CTPRO_SIZ (LOCAL) Invalid slave slot index.

LAT$_ITM_CTPRO_CRED (LOCAL) Invalid credit field.

LAT$_ITM_CTPRO_RCSM (LOCAL) Repeat creation of slot by master.

LAT$_ITM_CTPRO_RDSM (LOCAL) Repeat disconnection of slot by master.

++ LAT$_ITM_CTPRO_INVCLASS (LOCAL) Indicates the number of times a LAT message was received with an invalid service class specified in that message (local node only).

++ LAT$_ITM_CTPRO_EXCSTART (LOCAL) Indicates that a remote node attempted to start up too many LAT sessions. When a virtual circuit is started between two LAT nodes, the maximum number of sessions on that virtual circuit is negotiated. If the master node attempts to create more sessions than the maximum number of sessions on a virtual circuit, then the operating system rejects the excess connections and increments this counter.

**Table 5-21 Protocol Error Item Codes**
Item Codes	Meaning
LAT$_ITM_CTPRO_IVM (LOCAL)	Invalid message type received.
LAT$_ITM_CTPRO_ISM (LOCAL)	Invalid start message received.
LAT$_ITM_CTPRO_IVS (LOCAL)	Invalid sequence number received.
LAT$_ITM_CTPRO_NIZ (LOCAL)	Zero-node index received.
LAT$_ITM_CTPRO_ICI (LOCAL)	Node circuit index out of range.
LAT$_ITM_CTPRO_CSI (LOCAL)	Node circuit sequence invalid.
LAT$_ITM_CTPRO_NLV (LOCAL)	Node circuit index no longer valid.
LAT$_ITM_CTPRO_HALT (LOCAL)	Circuit was forced to halt.
LAT$_ITM_CTPRO_MIZ (LOCAL)	Invalid master slot index.
LAT$_ITM_CTPRO_SIZ (LOCAL)	Invalid slave slot index.
LAT$_ITM_CTPRO_CRED (LOCAL)	Invalid credit field.
LAT$_ITM_CTPRO_RCSM (LOCAL)	Repeat creation of slot by master.
LAT$_ITM_CTPRO_RDSM (LOCAL)	Repeat disconnection of slot by master.
++ LAT$_ITM_CTPRO_INVCLASS (LOCAL)	Indicates the number of times a LAT message was received with an invalid service class specified in that message (local node only).
++ LAT$_ITM_CTPRO_EXCSTART (LOCAL)	Indicates that a remote node attempted to start up too many LAT sessions. When a virtual circuit is started between two LAT nodes, the maximum number of sessions on that virtual circuit is negotiated. If the master node attempts to create more sessions than the maximum number of sessions on a virtual circuit, then the operating system rejects the excess connections and increments this counter.

+VAX specific.
++Alpha specific.

Table 5-22 lists the item codes that are returned for the LAT$C_ENT_SERVICE entity type. As in Table 5-17, item codes noted as LOCAL are returned only if the information being returned is for a locally offered service. Item codes noted as REMOTE are returned only if the information being returned is for a service offered by a remote node. Item codes noted as BOTH are returned for both types of services.

Table 5-22 LAT$C_ENT_SERVICE Item Codes
Item Codes Meaning

LAT$_ITM_SERVICE_NAME
(BOTH, SUMMARY) Service name.

LAT$_ITM_SERVICE_STATUS
(BOTH, SUMMARY) Status of the specified service. Possible values are:

LAT$C_AVAILABLE Service available.

LAT$C_UNAVAILABLE Service unavailable.

LAT$_ITM_SERVICE_TYPE (LOCAL,SUMMARY) Type of service. Possible values are:

LAT$C_ST_GENERAL General timesharing service.

LAT$C_ST_APPLICATION Special application service associated with ports dedicated to accepting connections to this service.

LAT$_ITM_IDENTIFICATION (BOTH, SUMMARY) Service identification string, as advertised by the highest rated node that currently offers the service.

Service node information is presented as a list of service node subblocks, with each subblock containing information about one particular node that offers the service. The subblock item code LAT$_ITM_SVC_NODE_BLOCK has the LAT$V_STRING bit set to 1, and the string length byte actually contains the length of the entire subblock. Each subblock itself is an itemlist and consists of the item codes listed in Table 5-23.

Table 5-23 Service Node Subblock Item Codes
Item Codes Meaning

LAT$_ITM_NODE_NAME (BOTH) Name of a LAT node that offers the selected service.

LAT$_ITM_STATE
(LOCAL) Current state of the LAT protocol on the local node. Possible values are:

LAT$C_ON New connections are allowed, and the LAT protocol is running.

LAT$C_OFF New connections are not allowed, and any current connections are abnormally terminated. The LAT protocol is not running.

LAT$C_SHUT No new connections are allowed. Currently active connections are still maintained. The LAT protocol remains running only until the last active session is disconnected, at which time the node is placed in the OFF state.

LAT$_ITM_NODE_STATUS (REMOTE) Current status of the remote node. This item code is present only if a LAT virtual circuit does not currently exist to the remote node. Possible values are:

LAT$C_REACHABLE Remote node is reachable.

LAT$C_UNREACHABLE Remote node is unreachable.

LAT$C_UNKNOWN Remote node status is unknown.

LAT$_ITM_CONNECTED_COUNT
(REMOTE) Number of LAT sessions from the local node to this remote node. This item code replaces the LAT$_ITM_NODE_STATUS item code for remote nodes to which a LAT virtual circuit currently exists.

LAT$_ITM_RATING
(BOTH) LAT service rating associated with the service.

LAT$_ITM_RATING_TYPE (LOCAL) Type of LAT rating calculation being done by this node. Possible values are LAT$C_STATIC and LAT$C_DYNAMIC.

LAT$_ITM_IDENTIFICATION
(BOTH) Identification string associated with the service.

Service counters information is presented as a counters subblock. The subblock item code LAT$_ITM_COUNTERS has the LAT$V_STRING bit set, and the string length byte actually contains the length of the entire subblock. Each subblock itself is an itemlist and consists of the item codes listed in Table 5-24.

Table 5-24 Service Counters Subblock Item Codes
Item Codes Meaning

LAT$_ITM_CTSRV_SSZ (BOTH) Seconds since zeroed.

LAT$_ITM_CTSRV_MCNA (BOTH) Outgoing connections attempted (the number of times the local node has attempted to connect to the service offered on a remote node).

LAT$_ITM_CTSRV_MCNC (BOTH) Outgoing connections completed (the number of times the local node successfully connected to the service offered on a remote node).

LAT$_ITM_CTSRV_SCNA (BOTH) Incoming connections accepted (the number of times the local node has accepted a connection request from a remote node to the locally offered service).

LAT$_ITM_CTSRV_SCNR (BOTH) Incoming connections rejected (the number of times the local node rejected a connection request from a remote node to the locally offered service).

LAT$_ITM_DED_PORT_BLOCK
(LOCAL) If the selected service is an application service offered by the local node, a list of one or more port subblocks is included in the itemlist. These subblocks describe the dedicated port or ports associated with this application service, with each subblock describing one particular port. The subblock item code LAT$_ITM_DED_PORT_BLOCK has the LAT$V_STRING bit set, and the string length byte actually contains the length of the entire subblock. Each subblock itself is an itemlist and currently consists only of the following item code:

LAT$_ITM_PORT_NAME (LOCAL) Name of the dedicated port

++ LAT$_ITM_PASSWORD_FAILURE Indicates password failures.

+VAX specific.
++Alpha specific.

Table 5-25 lists the item codes that are returned for the LAT$C_ENT_LINK entity type.

Table 5-25 LAT$C_ENT_LINK Item Codes
Item Codes Meaning

LAT$_ITM_LINK_NAME (SUMMARY) Link name (such as LAT$LINK).

LAT$_ITM_STATE (SUMMARY) State of the link. Possible values are:

LAT$C_ON New connections are allowed, and the LAT protocol is running.

LAT$C_OFF New connections are not allowed, and any current connections are abnormally terminated. The LAT protocol is not running.

LAT$C_SHUT No new connections are allowed. Currently active connections are still maintained. The LAT protocol remains running only until the last active session is disconnected, at which time the node is placed in the OFF state.

LAT$_ITM_DEVICE_NAME (SUMMARY) The name of the LAN device used for the link.

LAT$_ITM_DATALINK_ADDRESS The LAN device's current physical address for the link.

LAT$_ITM_DECNET_ADDRESS Indicates whether the link attempts to use the default DECnet LAN address when starting the data link controller (enabling the LAT protocol). Possible values are:

LAT$C_DISABLED DECnet LAN address use disabled.

LAT$C_ENABLED DECnet LAN address use enabled (this is the default).

Link counters information is presented as a counters subblock. The subblock item code LAT$_ITM_COUNTERS has the LAT$V_STRING bit set, and the string length byte actually contains the length of the entire subblock. Because the link counters are independent of the protocol type, they include not only LAT messages and events, but also all other protocol messages and events (that is, DECnet) associated with the same LAN device. The counters are actually maintained by the LAN device driver and are identified within the subblock by the nonprotocol-specific item codes listed in Table 5-26.

Table 5-26 Link Counters Item Codes
Item Codes Meaning

NMA$C_CTLIN_ZER Seconds since zeroed

NMA$C_CTLIN_DBR Messages received

NMA$C_CTLIN_DBS Messages transmitted

NMA$C_CTLIN_MBL Multicast messages received

NMA$C_CTLIN_MBS Multicast messages transmitted

NMA$C_CTLIN_BRC Bytes received

NMA$C_CTLIN_BSN Bytes transmitted

NMA$C_CTLIN_MBY Multicast bytes received

NMA$C_CTLIN_MSN Multicast bytes transmitted

NMA$C_CTLIN_RFL Receive errors

NMA$C_CTLIN_SFL Transmit errors

NMA$C_CTLIN_OVR Data overrun

NMA$C_CTLIN_UBU User buffer unavailable

NMA$C_CTLIN_SBU System buffer unavailable

NMA$C_CTLIN_LBE Local buffer errors

NMA$C_CTLIN_BS1 Messages sent, single collisions

NMA$C_CTLIN_BSM Messages sent, multiple collisions

NMA$C_CTLIN_BID Messages sent, initially deferred

NMA$C_CTLIN_CDC Transmit collision detection check failure

**Table 5-26 Link Counters Item Codes**
Item Codes	Meaning
NMA$C_CTLIN_ZER	Seconds since zeroed
NMA$C_CTLIN_DBR	Messages received
NMA$C_CTLIN_DBS	Messages transmitted
NMA$C_CTLIN_MBL	Multicast messages received
NMA$C_CTLIN_MBS	Multicast messages transmitted
NMA$C_CTLIN_BRC	Bytes received
NMA$C_CTLIN_BSN	Bytes transmitted
NMA$C_CTLIN_MBY	Multicast bytes received
NMA$C_CTLIN_MSN	Multicast bytes transmitted
NMA$C_CTLIN_RFL	Receive errors
NMA$C_CTLIN_SFL	Transmit errors
NMA$C_CTLIN_OVR	Data overrun
NMA$C_CTLIN_UBU	User buffer unavailable
NMA$C_CTLIN_SBU	System buffer unavailable
NMA$C_CTLIN_LBE	Local buffer errors
NMA$C_CTLIN_BS1	Messages sent, single collisions
NMA$C_CTLIN_BSM	Messages sent, multiple collisions
NMA$C_CTLIN_BID	Messages sent, initially deferred
NMA$C_CTLIN_CDC	Transmit collision detection check failure

Table 5-27 lists additional link counter item codes of the LINK entity.

Table 5-27 Link Counters Item Codes
Item Codes Meaning

LAT$_ITM_CTLAT_RMSG Count of LAT messages received through link

LAT$_ITM_CTLAT_RBYT Count of bytes for LAT received through link

LAT$_ITM_CTLAT_XMSG Count of LAT messages transmitted through link

LAT$_ITM_CTLAT_XBYT Count of bytes for LAT transmitted through link

LAT$_ITM_CTLAT_MUL_RMSG Count of LAT multicast messages received through link

LAT$_ITM_CTLAT_MUL_RBYT Count of multicast bytes for LAT received through link

LAT$_ITM_CTLAT_MUL_XMSG Count of LAT multicast messages transmitted through link

LAT$_ITM_CTLAT_MUL_XBYT Count of multicast bytes for LAT transmitted through link

LAT$_ITM_LAT_DEV_CTR_BLOCK This block contains the LAT-specific counters for the specified link. Counters returned in this block are the ones defined above (with CTLAT in their name). These counters are LAT-specific for the link (device). They do not include counts from other protocols using the same adapter.

**Table 5-27 Link Counters Item Codes**
Item Codes	Meaning
LAT$_ITM_CTLAT_RMSG	Count of LAT messages received through link
LAT$_ITM_CTLAT_RBYT	Count of bytes for LAT received through link
LAT$_ITM_CTLAT_XMSG	Count of LAT messages transmitted through link
LAT$_ITM_CTLAT_XBYT	Count of bytes for LAT transmitted through link
LAT$_ITM_CTLAT_MUL_RMSG	Count of LAT multicast messages received through link
LAT$_ITM_CTLAT_MUL_RBYT	Count of multicast bytes for LAT received through link
LAT$_ITM_CTLAT_MUL_XMSG	Count of LAT multicast messages transmitted through link
LAT$_ITM_CTLAT_MUL_XBYT	Count of multicast bytes for LAT transmitted through link
LAT$_ITM_LAT_DEV_CTR_BLOCK	This block contains the LAT-specific counters for the specified link. Counters returned in this block are the ones defined above (with CTLAT in their name). These counters are LAT-specific for the link (device). They do not include counts from other protocols using the same adapter.

The counter item codes listed in Table 5-27 are used by LATCP in the display generated by the $SHOW LINK /COUNTER command. The display looks similiar to the following:

Link Name: LAT$LINK Device Name: _XQA1: Seconds Since Zeroed: 65535 Messages Received: 7080630 Messages Sent: 2135394 LAT Messages Received: 1484817 LAT Messages Sent: 2086167 Multicast Msgs Received: 5578139 Multicast Msgs Sent: 10775 LAT Multicast Msgs Received: 5093417 LAT Multicast Msgs Sent: 9142 Bytes Received: 678189475 Bytes Sent: 1312778402 LAT Bytes Received: 107809441 LAT Bytes Sent: 1278118808 Multicast Bytes Received: 602984574 Multicast Bytes Sent: 1696264 LAT Multicast Bytes Received: 565264261 LAT Multicast Bytes Sent: 1448342 System Buffer Unavailable: 1638401 User Buffer Unavailable: 1 Unrecognized Destination: 65537 Data Overrun: 1 Receive Errors: 7 Transmit Errors: 1 Receive Errors (bitmask = 001) - Transmit Errors (bitmask = 001) - Block Check Error: Yes Excessive Collisions: Yes Framing Error: No Carrier Check Failure: No Frame Too Long: No Short Circuit: No Frame Status Error: No Open Circuit: No Frame Length Error: No Frame Too Long: No Remote Failure To Defer: No Transmit Underrun: No Transmit Failure: No CSMACD Specific Counters ------------------------ Transmit CDC Failure: 1 Messages Transmitted - Single Collision: 5208 Multiple Collisions: 4732 Initially Deferred: 0

Table 5-28 lists the item codes that are returned for the LAT$C_ENT_PORT entity type.

Table 5-28 LAT$C_ENT_PORT Item Codes
Item Codes Meaning

LAT$_ITM_PORT_NAME SUMMARY Name of the port (such as _LTA15:).

LAT$_ITM_PORT_TYPE SUMMARY Type of port. Possible values are:

LAT$C_PT_FORWARD Forward port used for outgoing LAT connections or for management functions.

LAT$C_PT_INTERACTIVE Interactive port created as the result of an incoming LAT connection request.

LAT$C_PT_APPLICATION Application port for solicited connections.

LAT$C_PT_DEDICATED Dedicated port associated with a local service.

LAT$_ITM_QUEUED Controls whether the solicited connection requests queued or nonqueued access. Possible values are:

LAT$C_DISABLED Queued access disabled.

LAT$C_ENABLED Queued access enabled (this is the default).

LAT$_ITM_SERVICE_CLASS Indicates the class driver with which the device is communicating. This item code can be used only with an entity status of LAT$C_ENTS_NEW. Therefore, the service class must be specified when the device is created. An attempt to change the service class of an existing device returns SS$_BADPARAM. Possible values are:

LAT$C_SERVCLASS_INTERACTIVE Service class 1, TTDRIVER (this is the default).

LAT$C_SERVCLASS_TESTSERVICE Service class 2, TEST SERVICE.

LAT$C_SERVCLASS_XTRANSPORT Service class 3, X Protocol.

LAT$C_SERVCLASS_FONT Service class 4, X fonts.

LAT$_ITM_DISPLAY_NUMBER Display number value for the device. This field has meaning for services classes 3 and 4 (X) only. It returns a value of 0 for all other service classes.

LAT$_ITM_DISCONNECT_REASON Reason (if any) for the last disconnect on the port. If it is not a 0--19 LAT rejection code, it is a LAT message code. The 0--19 LAT rejection code meanings are listed in Table 5-32.

LAT$_ITM_CONNECTED_SERVICE_NAME ¹ Name of service to which this port is connected. For forward and application ports, this is the name of the remote service to which the port is connected (if any). For interactive and dedicated ports, this is the name of the local service that accepted the remote-initiated connection.

LAT$_ITM_CONNECTED_NODE_NAME ¹ Name of remote node to which this port is connected.

LAT$_ITM_CONNECTED_PORT_NAME ¹ Name of remote port to which this port is connected.

LAT$_ITM_CONNECTED_LINK_NAME ¹ Name of the link on which the LAT connection exists.

LAT$_ITM_TARGET_SERVICE_NAME ² Target service name for connection of forward or application ports. For dedicated ports, this item code specifies the local service with which the port is associated.

LAT$_ITM_TARGET_NODE_NAME ² Target node name for connection of forward or application ports.

LAT$_ITM_TARGET_PORT_NAME ² Target port name for connection of forward or application ports.

++ LAT$_ITM_NODE_QUEUE_POSITION Indicates current node queue position for connect request. Returned during SENSEMODE of port entity.

++ LAT$_ITM_SERVICE_QUEUE_POSITION Indicates current service queue position for connect request. Returned during SENSEMODE of port entity.

LAT$_ITM_PORT_STATE Current port state. Possible values are:

LAT$C_PT_STATE_INACTIVE Port is inactive.

LAT$C_PT_STATE_CONNECTING Port connection in progress but not complete.

LAT$C_PT_STATE_ACTIVE Port has active LAT connection.

LAT$C_PT_STATE_DISCONNECTING PORT LAT connection in process of terminating.

¹Returned only when the LTA port has an active LAT connection.
²Shows information about how the port is set up. May be returned even if there is no current LAT connection.
+VAX specific.
++Alpha specific.

On Alpha systems, the item codes for queue entries are listed in Table 5-29.

Table 5-29 LAT SENSMODE Queue Entries (Alpha Only)
Item Code Meaning

LAT$_ITM_QUEUED_ENTRY_ID (SUMMARY) Indicates by string the queue entry ID name.

LAT$_ITM_NODE_QUEUE_POSITION (SUMMARY) Indicates the current position of entry in node wide queue.

LAT$_ITM_SERVICE_QUEUE_POSITION (SUMMARY) Indicates the current position of entry in service wide queue.

LAT$_ITM_NODE_NAME (SUMMARY) Indicates where the remote node name queue entry came from.

LAT$_ITM_SERVICE_NAME (SUMMARY) Indicates the target service name to which the queue entry is queued (if specified).

LAT$_ITM_PORT_NAME (SUMMARY) Indicates the target port name to which the entry is queued (if specified).

LAT$_ITM_LINK_NAME Returns the link name on which the queued request is active.

LAT$_ITM_DATALINK_ADDRESS Returns the remote node that issued request's data link address.

**Table 5-29 LAT SENSMODE Queue Entries (Alpha Only)**
Item Code	Meaning
LAT$_ITM_QUEUED_ENTRY_ID (SUMMARY)	Indicates by string the queue entry ID name.
LAT$_ITM_NODE_QUEUE_POSITION (SUMMARY)	Indicates the current position of entry in node wide queue.
LAT$_ITM_SERVICE_QUEUE_POSITION (SUMMARY)	Indicates the current position of entry in service wide queue.
LAT$_ITM_NODE_NAME (SUMMARY)	Indicates where the remote node name queue entry came from.
LAT$_ITM_SERVICE_NAME (SUMMARY)	Indicates the target service name to which the queue entry is queued (if specified).
LAT$_ITM_PORT_NAME (SUMMARY)	Indicates the target port name to which the entry is queued (if specified).
LAT$_ITM_LINK_NAME	Returns the link name on which the queued request is active.
LAT$_ITM_DATALINK_ADDRESS	Returns the remote node that issued request's data link address.

Contents

Index

privacy and legal statement

6136PRO_022.HTML