OpenVMS System Management Utilities Reference Manual

Note that you can specify the /STATUS qualifier with the SHOW NODE command to display information about the local node only (for example, the command SHOW NODE /STATUS FOREIGN_NODE is not supported).

DESCRIPTION

This command displays information about a specified node or, if you do not specify a node name, about your local node. With the /ALL qualifier, the SHOW NODE command displays information about all nodes known to your local node. Depending on the qualifiers you use, you can display node counters, node status, the node identification string, the LAT protocol version running on the node, and the values set for the node's characteristics.

Examples

```
LATCP> SHOW NODE/FULL 
```
This command produces the following display of information about the local node:
```
Node Name:   LTC                            LAT Protocol Version:      5.2 
Node State:  On               
Node Ident:  LTC - Engineering Development 
 
Incoming Connections:  Enabled              Incoming Session Limit:   None 
Outgoing Connections:  Enabled              Outgoing Session Limit:   None 
Service Responder:     Disabled 
 
Circuit Timer (msec):        80             Keepalive Timer (sec):      20 
Retransmit Limit (msg):      20             Node Limit (nodes):       None 
Multicast Timer (sec):       20             CPU Rating:                  8 
Maximum Unit Number:       9999 
 
User Groups:     43, 73 
Service Groups:  7-9, 13, 23, 40, 43, 45, 66, 72-73, 89, 120-127, 248-255 
 
Service Name     Status      Rating  Identification 
LTVMS            Available     31 D  . 
```
This display indicates that the local node LTC is in the On state, which means LAT connections can be created on the node. LTC is running Version 5.2. of the LAT protocol. The identification of the node is "LTC - Engineering Development". Because this is the local node, the display does not give the address of a LAN device. Use the SHOW LINK command to find addresses of devices on the local node. The display for the status of remote nodes, as shown in Example 2, gives the Ethernet address of that node.
Both incoming and outgoing connections can be made on node LTC, the number of sessions is unlimited. The display indicates the values of various timers and lists the groups that are enabled. Users on the local node can access service nodes belonging to user groups 43 and 73. Locally offered services can be accessed by nodes belonging to the service groups listed.
The display indicates that the CPU rating of the local node is 8. The display shows that the node offers a service named LTVMS. This service is available and its rating is 31 D (dynamic). (An S would indicate the rating is static.)

LATCP> SHOW NODE/FULL RWWUP

This command displays the following about the remote node RWWUP:

Node Name:   RWWUP                          LAT Protocol Version:      5.2 
Node State:  Reachable                      Address:     AA-00-04-00-11-10 
Node Ident:  . 
 
Incoming Connections:  Enabled 
 
Circuit Timer (msec):        80 
Multicast Timer (sec):       20 
 
Service Groups:  7, 13, 42-43, 45, 66, 70-72, 75-82, 88-89 
 
Service Name     Status      Rating  Identification 
NAC              Available     28    . 
SYSMGR           Available     28    .

This display indicates that remote node RWWUP is reachable and runs Version 5.2 of the LAT protocol. The display includes the Ethernet address of node RWWUP. Because incoming connections are enabled, you can connect to a service on node RWWUP, provided that your node belongs to one of the service groups listed in the display.
Node RWWUP offers two services: NAC and SYSMGR. Both are available.

LATCP> SHOW NODE/ALL/BRIEF

This command displays the following about all nodes known to the local node:

Node Name            Status       Identification 
----------------     -----------  ---------------------------------------------- 
ABLAN                Reachable     Unauthorized access is prohibited. 
ASKWEN               Reachable     . 
CHUNK                Reachable     A member of the MAIN VMScluster 
          . 
          . 
          . 
UTOO                 On            Can be healthy at the Center 
VULCUN               Reachable     Beam me up 
ZENX                 Reachable     ZENX

This command indicates the status (whether a node is reachable) and identification of all nodes known to the local node. The display includes the status of the local node UTOO. The status can be either On, Off, or Shut. Here it is On.

$ LCP :== $LATCP 
$ LCP SHOW NODE /STATUS

The SHOW NODE /STATUS produces the following display:

Node Name:   NODE1                          LAT Protocol Version:      5.2 
Node State:  On 
Node Ident:  Test system         
 
                           Current   Highest   Maximum 
                           -------   -------   ------- 
Active Circuits:                 1         2      1023 
Connected Sessions:              1         6    260865 
Incoming Queue Entries:          0         0        24 
Outgoing Queue Entries:          0         1     32767 
Unprocessed Announcements:       0         7       500 
Unprocessed Solicits:            0         2       250 
 
Local Services:                  1         2       255 
Available Services:            188       194       N/A 
Reachable Nodes:               166       172       N/A 
 
Discarded Nodes:                 0

SHOW PORT

Displays the status and LAT characteristics of ports on the local node.

Format

SHOW PORT [port-name]

PARAMETER

port-name
Specifies the name of the port for which information is displayed. If you do not specify a port name, the SHOW PORT command displays the characteristics for all LTAn: ports on a node.
Do not use the /APPLICATION, /DEDICATED, /FORWARD, /INTERACTIVE, or /LIMITED qualifiers with a specific port name.

QUALIFIERS

/APPLICATION
Generates a display of all application ports.
/BRIEF
Displays port type, port status, and the remote node name, port, and service associated with the port. This is the default if you do not specify a port name with the SHOW PORT command.
/COUNTERS
Displays the counters kept for the port. Do not use the /BRIEF or /FULL qualifiers with this qualifier.
/DEDICATED
Generates a display of all dedicated ports.
/FORWARD
Generates a display of all LAT ports used for either outgoing LAT connections or local LAT management functions.
/FULL
Displays the following information:

Port type
Port status
Target port name, node name, and service name associated with the port
Remote node name, port, and service associated with the port if a connection is currently active

/INTERACTIVE
Generates a display of all LAT ports used for incoming interactive connections.
/LIMITED
Generates a display of all limited LTA devices on the system (previously established with the CREATE PORT /LIMITED or SET PORT /LIMITED command).

DESCRIPTION

If a port is an application port, the display lists the remote node name, remote port name, and remote service name that you specified in the SET PORT command.
If the port is a dedicated port, the display lists the service name that you specified in the SET PORT command.
If LATCP shows the port as Interactive in the display, a user on a terminal server or on a node that supports outgoing LAT connections is currently using the port.
For all ports with active sessions, the remote node sends its node name and port name to your local node. These names are listed in the display.

Examples

```
LATCP> SHOW PORT /FULL 
```
This command produces the following type of display. The display reflects the characteristics set by the command examples given with the SET PORT command.
```
Local Port Name:   _LTA16:           Local Port Type:  Forward 
Local Port State:  Inactive 
Connected Link: 
 
 Target Port Name:                      Actual Port Name:                     
 Target Node Name:     LATCP$MGMT_PORT  Actual Node Name:                     
 Target Service Name:                   Actual Service Name:                  
 
-------------------------------------------------------------------------------- 
 
Local Port Name:   _LTA17:           Local Port Type:  Interactive 
Local Port State:  Active 
Connected Link:    LAT$LINK 
 
 Target Port Name:                      Actual Port Name:     PORT_1 
 Target Node Name:                      Actual Node Name:     MY_DS200_SERVER 
 Target Service Name:                   Actual Service Name:                  
 
-------------------------------------------------------------------------------- 
 
Local Port Name:   _LTA19:           Local Port Type:  Application (Queued) 
Local Port State:  Active 
Connected Link:    LAT$LINK 
 
 Target Port Name:                      Actual Port Name:                     
 Target Node Name:     TLAT1            Actual Node Name:     TLAT1 
 Target Service Name:  PRINTER          Actual Service Name:  PRINTER           
 
-------------------------------------------------------------------------------- 
 
Local Port Name:   _LTA21:           Local Port Type:  Dedicated 
Local Port State:  Inactive 
Connected Link:   
 
 Target Port Name:                      Actual Port Name:                     
 Target Node Name:                      Actual Node Name:                     
 Target Service Name:  GRAPHICS         Actual Service Name:                  
 
-------------------------------------------------------------------------------- 
 
Local Port Name:   _LTA22:           Local Port Type:  Application (Queued) 
Local Port State:  Active 
Connected Link:    LAT$LINK 
 
 Target Port Name:     LN02             Actual Port Name:     LN02 
 Target Node Name:     TS33EW           Actual Node Name:     TS33EW 
 Target Service Name:                   Actual Service Name:                  
 
-------------------------------------------------------------------------------- 
```
The display in this example shows information about all the ports on the local node. The display shows information for each of the four types of ports:
- Forward: a port used for outgoing LAT connections or for executing local management functions and LATCP commands. Port LTA16: is a forward port. The display shows that the port is currently inactive---no current LAT connection exists. The target node name of LATCP$MGMT_PORT indicates that LATCP is using this port to execute the LATCP commands entered by the user. If the display listed a node and service name, it would mean that the port is being used for an outgoing connection.
- Interactive: a port created as a result of an incoming LAT connection request from another node or terminal server. Port LTA17: is an interactive port connected with port PORT_1 on the terminal server MY_DS200_SERVER.
- Application: a port used for solicited connections to devices on terminal servers or to application services on remote LAT service nodes. Port LTA22: is an application port. The port maps to port LN02 (a printer) on a terminal server node TS33EW. The display indicates that server TS33EW queues connection requests from the local node. Port LTA19: is also an application port. The port maps to the service PRINTER on terminal server TLAT1.
- Dedicated: a port dedicated to a local application service. Port LTA21: is dedicated to the service GRAPHICS.
The target port name, target node name, and target service name are the names specified with the SET PORT command. They are passed to the remote node or terminal server when the connection request is made.
The actual port name, actual node name, and actual service name are the names returned by the remote node when it accepts the connection request. They may differ from the corresponding target names (specified with the SET PORT command) if the remote node translates the names. For example, terminal servers that accept connections to LAT service names usually return the name of the port to which the connection was actually directed.

LATCP> SHOW PORT LTA1 /COUNTERS

This command produces a display that lists counter information for the LTA1 device.

Port Name:  _LTA1: 
 
Seconds Since Zeroed:                66 
Remote Accesses:                      0   Framing Errors:             0 
Local Accesses:                       0   Parity Errors:              0 
Bytes Transmitted:                    0   Data Overruns:              0 
Bytes Received:                       0   Password Failures:          0 
Solicitations Accepted:               1 
Solicitations Rejected:               1 
Incoming Solicits Accepted:           0 
Incoming Solicits Rejected:           0 
Last disconnect reason code:         18 
    (%LAT-F-LRJDELETED, queue entry deleted by server)

SHOW QUEUE_ENTRY

Displays information about requests, or entries, queued on the local node.

Format

SHOW QUEUE_ENTRY [queue-entry-id]

PARAMETER

queue-entry-id
Specifies the identification number (ID) of the queued entry for which information is displayed. If you do not specify a value for this parameter, information about all queued entries is displayed.

QUALIFIERS

/BRIEF
Displays the following information about the queued entries:

Position
Entry ID
Source node
Service
Port name

This is the default display.
/FULL
In addition to the information displayed by the /BRIEF qualifier, the /FULL qualifier provides the following information for each node:

Node queue position
Service queue position
Node address
Soliciting Link

DESCRIPTION

The SHOW QUEUE_ENTRY command displays information about requests, or entries, queued on the local node. You can display information about a specific entry by including the queue entry ID on the command line or you can display information about all entries (the default). Use the DELETE QUEUE_ENTRY command to delete specific entries from the queue.

Examples

LATCP> SHOW QUEUE_ENTRY

This command produces the following type of display:

Position  Entry ID  Source Node       Service           Port Name 
--------  --------  ----------------  ----------------  --------- 
   1      79EC      NODE1             LAT_LIMITED       
   2      7AEC      NODE2             LAT_LIMITED       
   3      7CEC      NODE3             LAT_LIMITED

LATCP> SHOW QUEUE_ENTRY/FULL

This command produces the following type of display:

Entry ID:                 7AEC           Remote Node: NODE1 
Node Queue Position:         1           Address:     08-00-2B-0A-A0-A0 
Service Queue Position:      1 
 
 Target Port:     
 Target Service:  LAT_LIMITED 
 Soliciting Link: LAT$LINK 
 
-------------------------------------------------------------------------------- 
 
Entry ID:                 7CEC           Remote Node: NODE2 
Node Queue Position:         2           Address:     AA-00-04-00-37-DD 
Service Queue Position:      2 
 
 Target Port:     
 Target Service:  LAT_LIMITED 
 Soliciting Link: LAT$LINK

SHOW SERVICE

Displays the status and LAT characteristics of LAT services known to the local node.

Format

SHOW SERVICE [service-name]

PARAMETERS

service-name
Specifies the name of the service for which information will be displayed. If you do not specify a service name, LATCP displays information about all services known to the node.
You can also specify any valid wildcard for this parameter. For example, the SHOW SERVICE LAT_* command displays the status and characteristics of all services that begin with the LAT_ prefix.

QUALIFIERS

/BRIEF
Displays the status and identification string of the service.
/COUNTERS
Displays the counters kept for the service. Do not use the /BRIEF or /FULL qualifier with this qualifier. The following table lists and describes the counters:

Counter Description

Remote Counters

Connections attempted The total number of times the local node attempted to connect to the service offered on a remote node.

Connections completed The total number of times the local node successfully connected to the service offered on a remote node.

Local Counters

Connections accepted The total number of times the local node accepted a connection request from a remote node to a locally offered service.

Connections rejected The total number of times the local node rejected a connection request from a remote node to a locally offered service.

Password failures The total number of connect requests to the service which were rejected due to password violation errors.

/FULL
Displays the status, identification string, and type of service, and the values set for service characteristics. This qualifier also displays the status of all service nodes offering the service.
/LOCAL
Displays information about services offered by the local node only. You can use this qualifier with the /BRIEF, /COUNTERS, or /FULL qualifier.

Counter	Description
Remote Counters
Connections attempted	The total number of times the local node attempted to connect to the service offered on a remote node.
Connections completed	The total number of times the local node successfully connected to the service offered on a remote node.
Local Counters
Connections accepted	The total number of times the local node accepted a connection request from a remote node to a locally offered service.
Connections rejected	The total number of times the local node rejected a connection request from a remote node to a locally offered service.
Password failures	The total number of connect requests to the service which were rejected due to password violation errors.

DESCRIPTION

This command displays information about services. If you do not specify a service name, the command displays information about all services known to your local node. If you do not specify a service name but specify the /LOCAL qualifier, the command displays information about all services offered by your local node.
Depending on whether you use the /BRIEF, /COUNTERS, or /FULL qualifier, you can display the status, identification string, and type of service, the status of all service nodes offering the service, the values set for service characteristics, and service counters.

Examples

```
LATCP> SHOW SERVICE NODE1 /FULL 
```
This command produces the following display of information about service NODE1. This service is offered by the local node.
```
Service Name:    NODE1                    Service Type:  General 
Service Status:  Available                Connections:   Enabled 
Service Password: Enabled                 Queueing:      N/A 
Service Ident:    NODE1 - Test system             
 
Node Name            Status      Rating   Identification 
LAV                  On            31 D   . 
LATP                 Reachable     48     . 
LITTN                Reachable     37     . 
LTDRV                Reachable     82     . 
```
The display in this example indicates that the locally offered service NODE1 is available and its service type is general, meaning that it is a general timesharing service (in contrast to a dedicated application service). The display also lists the status of all the nodes that offer the service. The local node is LAV. The status of the local node can be either On, Off, or Shut. Here node LAV's status is On. The status of the other nodes indicates whether they are reachable. The display lists the ratings of each service node, indicating their relative capacity to accept new connections. The D next to the locally offered service indicates that node LAV computes its rating dynamically. An S would indicate that the node's rating was set permanently by the node's system manager.
```
LATCP> SHOW SERVICE OFFICE/FULL 
```
This command produces the following display of information about the service OFFICE, which is offered by a remote node:
```
Service Name:    OFFICE                  
Service Status:  Available 
Service Ident:   . 
 
Node Name            Status      Rating   Identification 
BURGIL               Reachable    121     . 
DARWIN               Reachable     43     . 
```
The display in this example indicates that the service is available. The display also indicates the status and other information about the nodes that offer the service, BURGIL and DARWIN.

SPAWN

Creates a subprocess, enabling you to execute DCL commands without terminating your LATCP session. The LATCP command SPAWN is similar to the DCL command SPAWN.
To return to your LATCP session, either log out of the subprocess by entering the DCL command LOGOUT, or use the DCL command ATTACH to attach your terminal to the process running LATCP.

Format

SPAWN [DCL-command]

PARAMETER

DCL-command
Specifies a DCL command. If you specify a DCL command, LATCP executes the command in a subprocess. Control returns to LATCP when the DCL command terminates.
If you do not specify a DCL command, LATCP creates a subprocess and you can then enter DCL commands. You can continue your LATCP session by logging out of the spawned subprocess or by attaching to the parent process with the DCL command ATTACH.

DESCRIPTION

The SPAWN command acts exactly like the DCL command SPAWN. You can enter DCL commands (such as to create print queues, change the protection of a device, answer mail, and so forth) without ending your LATCP session.
You cannot use this command to gain access to DCL if you are running LATCP from a captive account.

Example

LATCP> SPAWN
$

This command creates a subprocess at DCL level. You can now enter DCL commands. Log out or enter the DCL command ATTACH to return to the LATCP prompt.

ZERO COUNTERS

Resets the link, node, and service counters maintained by the local node. You must have OPER privilege to use this command.

Format

ZERO COUNTERS

PARAMETERS

None.

QUALIFIERS

/LOG

/NOLOG (default)
Specifies whether LATCP displays a message confirming that the counters were reset. If you do not specify the /LOG or /NOLOG qualifier, the default is that no message will be displayed.
/LINK[=link-name]
Specifies the link (on your local node) for which you want counters reset. If you do not specify a link name, LATCP zeroes counters for the link LAT$LINK.
/NODE[=node-name]
Specifies the node for which you want counters reset. If you do not specify a node name, LATCP zeroes the counters for your local node.
/PORT=port-name
Specifies the port (on your local node) for which you want counters reset.
/SERVICE=service-name
Specifies the service (on your local node) for which you want counters reset.

DESCRIPTION

This command resets counters. You can specify whether you want to reset link, node, or service counters. You must specify either /LINK, /NODE, or /SERVICE.

Example

LATCP> ZERO COUNTERS/SERVICE=LTVM
LATCP> SHOW SERVICE LTVM /COUNTERS
 
Service Name:  LTVM 
 
Seconds Since Zeroed:          9 
Connections Attempted:         0    Connections Accepted:          0 
Connections Completed:         0    Connections Rejected:          0 
Password Failures:             0

This command resets the counters kept for service LTVM. The display produced by the SHOW SERVICE command shows how the ZERO COUNTERS command reset the counters to zero.

Chapter 14
Log Manager Control Program (LMCP) Utility

  6048P031.HTM
  OSSG Documentation
  26-NOV-1996 12:43:05.40

Legal

OpenVMS System Management Utilities Reference Manual

DESCRIPTION

SHOW PORT

Format

SHOW PORT [port-name]

PARAMETER

port-name

QUALIFIERS

/APPLICATION

/BRIEF

/COUNTERS

/DEDICATED

/FORWARD

/FULL

/INTERACTIVE

/LIMITED

DESCRIPTION

SHOW QUEUE_ENTRY

Format

SHOW QUEUE_ENTRY [queue-entry-id]

PARAMETER

queue-entry-id

QUALIFIERS

/BRIEF

/FULL

DESCRIPTION

SHOW SERVICE

Format

SHOW SERVICE [service-name]

PARAMETERS

service-name

QUALIFIERS

/BRIEF

/COUNTERS

/FULL

/LOCAL

DESCRIPTION

SPAWN

Format

SPAWN [DCL-command]

PARAMETER

DCL-command

DESCRIPTION

Example

ZERO COUNTERS

Format

ZERO COUNTERS

PARAMETERS

QUALIFIERS

/LOG

/NOLOG (default)

/LINK[=link-name]

/NODE[=node-name]

/PORT=port-name

/SERVICE=service-name

DESCRIPTION

Example

Chapter 14Log Manager Control Program (LMCP) Utility

Chapter 14
Log Manager Control Program (LMCP) Utility