[an error occurred while processing this directive]

HP OpenVMS Systems Documentation

Content starts here

HP OpenVMS System Management Utilities Reference Manual


Previous Contents Index

This command displays MOP downline load information in the LAN volatile device database for device EXA0.

#5

LANCP> SHOW DEVICE/PARAMETERS IRA0
Device Parameters IRA0:
             Value  Parameter
             -----  ---------
            Normal  Controller mode
          External  Internal loopback mode
 00-00-93-58-5D-32  Hardware LAN address
        Token Ring  Communication medium
           Enabled  Functional address mode
                No  Full duplex enable
                No  Full duplex operational
                16  Line speed (megabits/second)
           16 Mbps  Ring speed
               STP  Line media
           Enabled  Early token release
          Disabled  Monitor contender
               200  SR cache entries
                 2  SR discovery timer
                60  SR Aging Timer
           Enabled  Source routing
                 3  Authorized access priority
 AA-00-04-00-92-FF  Upstream neighbor
                 0  Ring number
      

This command displays status and parameters information for Token ring device IRA0.

#6

LANCP> SHOW DEVICE/REVISION EWF0
Device Revisions EWF0:
                  Value  Component
                  -----  ---------
               02000041  Device hardware revision
      08020110 00000004  Port driver revision
      08020172 00000001  LAN common routines revision
      

This command displays revision information for Ethernet device EWF0:.

#7

LANCP> SHOW DEVICE/SR_ENTRY ICA0
Source Routing Cache Table ICA0:
   LAN address      State    XmtTmo   RcvTmo  StaleTmo DiscvTmo
-----------------   -----   -------- -------- -------- --------
AA-00-04-00-92-FF   LOCAL   00000028 00000028 00000245 00000000
      

This command displays source routing entry information for Token Ring device ICA0.

SHOW DLL or MOPDLL

Displays the current state of MOP downline load services for the system, including devices for which MOP loading is enabled and counters information.

Format

SHOW DLL or MOPDLL


Parameters

None.

Qualifier

/OUTPUT=file-name

Creates the specified file and directs output to it.

Example


LANCP>SHOW DLL
LAN DLL Status:
 EXA enabled in exclusive mode for known nodes only,
       data size 1482 bytes
 FXA disabled

       #Loads  Packets    Bytes     Last load time     Last loaded
       ------  -------    -----  --------------------  ------------
 EXA      5     1675    4400620  22-SEP-2002 10:27.51    GALAXY
 FXA      0        0          0

      

On this node, there are two LAN devices, EXA (DEMNA) and FXA (DEMFA). MOP downline load service is enabled on EXA in exclusive mode.

Requests are answered only for nodes that are defined in the LANACP node database. The image data size in the load messages is 1482 bytes. There have been five downline loads, the last one occurring on node GALAXY at 10:27. Finally, there are no recorded downline loads for FXA, which is currently disabled for downline load service.

SHOW LOG

Displays recent downline load activity (the last 2048 bytes of log data written to the log file SYS$MANAGER:LAN$ACP.LOG).

Format

SHOW LOG


Parameters

None.

Qualifier

/OUTPUT=file-name

Creates the specified file and directs output to it.

Example


LANCP> SHOW LOG

SYS$MANAGER:LAN$ACP.LOG latest contents:

17-MAR-2001 07:29:51.71  Volunteered to load request on EXA0 from HELENA
    Requested file:  LAVC$SYSDEVICE:<SYS1A.>[SYSCOMMON.SYSLIB]NISCS_LOAD.EXE
17-MAR-2001 07:29:53.00  Load succeeded for HELENA on EXA0
    MOP V3 format, System image,
LAVC$SYSDEVICE:<SYS1A.>[SYSCOMMON.SYSLIB]NISCS_LOAD.EXE
    Packets:  84 sent, 84 received
    Bytes:    121492 sent, 168 received, 120988 loaded
    Elapsed time:  00:00:01.09, 110998 bytes/second
17-MAR-2001 07:29:53.60  Could not respond to load request on EXA0 from AJAX,
file not found
    Requested file:  LAN$DLL:READ_ADDR.SYS
17-MAR-2001 07:29:54.46  Could not respond to load request on EXA0 from AJAX,
file not found
    Requested file:  LAN$DLL:READ_ADDR.SYS
17-MAR-2001 07:29:57.36  Volunteered to load request on EXA0 from HELENA
    Requested file:  LAVC$SYSDEVICE:<SYS1A.>[SYSCOMMON.SYSLIB]NISCS_LOAD.EXE
17-MAR-2001 07:29:58.49  Volunteered to load request on EXA0 from AJAX
    Requested file:  LAVC$SYSDEVICE:<SYS10.>[SYSCOMMON.SYSLIB]NISCS_LOAD.EXE
17-MAR-2001 07:29:59.49  Load succeeded for HELENA on EXA0
    MOP V3 format, System image,
LAVC$SYSDEVICE:<SYS1A.>[SYSCOMMON.SYSLIB]NISCS_LOAD.EXE
    Packets:  84 sent, 84 received
    Bytes:    121492 sent, 168 received, 120988 loaded
    Elapsed time:  00:00:01.73, 69935 bytes/second
17-MAR-2001 07:30:03.66  Volunteered to load request on EXA0 from AJAX
    Requested file:  LAN$DLL:ONE.SYS
17-MAR-2001 07:30:04.05  Load succeeded for AJAX on EXA0
    MOP V3 format, System image, LAN$DLL:ONE.SYS
    Packets:  9 sent, 9 received
    Bytes:    11354 sent, 18 received, 11300 loaded
    Elapsed time:  00:00:00.04, 282500 bytes/second
17-MAR-2001    Requested file:  LAN$DLL:ONE.SYS
17-MAR-2001 07:30:05.18  Load succeeded for AJAX on EXA0
    MOP V3 format, System image, LAN$DLL:ONE.SYS
    Packets:  9 sent, 9 received
    Bytes:    11354 sent, 18 received, 11300 loaded
    Elapsed time:  00:00:00.04, 282500 bytes/second


      

This command displays the last 2048 bytes of log data written to the log file SYS$MANAGER:LAN$ACP.LOG.

SHOW NODE

Displays information in the LAN volatile node database.

Format

SHOW NODE node-name


Parameter

node-name

Specifies the name of a node in the LAN volatile node database. The name can include up to 63 characters associated with the node address. If you do not specify a node name, all nodes are displayed.

Qualifiers

/ALL

Displays information for all nodes in the LAN volatile node database. If you specify a node name, all matching nodes are selected; for example, A/ALL selects all nodes beginning with A.

/OUTPUT=file-name

Creates the specified file and directs output to that file. If the file extension is .com, the output is in the form of a list of DEFINE NODE or SET NODE commands. The resulting command file can be used to create the LAN node databases.

/TOTAL

Display counter totals only, for the nodes selected.

Examples

#1

LANCP> SHOW NODE
Node Listing:

GALAXY (08-00-2B-2C-51-28):
 MOP DLL: Load file: APB.EXE
          Load root: $64$DIA24:<SYS11.>
          Boot type: Alpha satellite

ZAPNOT (08-00-2B-18-7E-33):
 MOP DLL: Load file: NISCS_LOAD.EXE
          Load root: LAVC$SYSDEVICE:<SYS10.>
          Boot type: VAX satellite

CALPAL (08-00-2B-08-9F-4C):
 MOP DLL: Load file: READ_ADDR.SYS
          Last file: LAN$DLL:APB_X5WN.SYS
          Boot type: Other
          2 loads requested, 1 volunteered
          1 succeeded, 0 failed
          Last request was for a system image, in MOP V4 format
          Last load initiated 12-JUN-2002 09:11:17 on EXA0 for 00:00:06.65
          527665 bytes, 4161 packets, 0 transmit failures

Unnamed (00-00-00-00-00-00):

Totals:
  Requests received    2
  Requests volunteered 1
  Successful loads     1
  Failed loads         0
  Packets sent         2080
  Packets received     2081
  Bytes sent           523481
  Bytes received       4184
  Last load            CALPAL at 12-JUN-2002 09:11:17.29





      

This example shows output from a command issued on a local node on which there are three nodes defined (GALAXY, ZAPNOT, and CALPAL). CALPAL has issued two load requests:

  • The first request is the multicast request from CALPAL that the local node volunteered to accept.
  • The second request is the load request sent directly to the local node by CALPAL for the actual load data. The elapsed time from the second load request to completion of the load was 6.65 seconds.
#2

LANCP> SHOW NODE VAXSYS

      

Displays node characteristics and counters information from the LAN volatile node database for node VAXSYS.

#3

LANCP> SHOW NODE/ALL VAX

      

Displays node characteristics and counters information from the LAN volatile node database for all nodes whose name begins with VAX.

#4

LANCP> SHOW NODE/ALL

      

Displays node characteristics and counters information from the LAN volatile node database for all nodes.

#5

LANCP> SHOW NODE/ALL/OUTPUT=TMP.INI

      

Writes a list of all nodes to the file TMP.INI.

SPAWN

Creates a subprocess of the current process. The SPAWN command copies the context of the subprocess from the current process.

Format

SPAWN [command-string]


Parameter

command-string

A string of commands to be executed in the context of the created subprocess. After the command string is executed, control returns to LANCP.

Qualifiers

None.

Example


LANCP> SPAWN

$ MC LANCP
LANCP> DEFINE NODE BOOM/ROOT=LAVC$SYSDEVICE:<SYS22.>
LANCP> SPAWN SEARCH LAVC$SYSDEVICE:[*.SYSEXE]MOD*.DAT BOOM

******************************
LAVC$SYSDEVICE:[SYS1A.SYSEXE]MODPARAMS.DAT;1

SCSNODE="BOOM    "
LANCP> DEFINE NODE BOOM/ROOT=LAVC$SYSDEVICE:<SYS1A.>

      

In this example, you enter the node information for a node, but are unsure of the root, so you spawn to search MODPARAMS.DAT for the node name and then correct the root.

TRIGGER NODE

Issues a request to reboot to a remote node.

Rather than specify the format to send MOP Version 3 or 4, the LANCP utility sends one message in each format to the target node.


Format

TRIGGER NODE node-specification


Parameter

node-specification

Supplies either the node name or the node address of the target node. If you supply the node name, the node address is obtained by looking up the node name in the LAN volatile node database. If you supply the node address, the corresponding node need not be defined in the LAN volatile node database. The canonical form of the address consists of 6 hexadecimal byte characters separated by hyphens. Use a colon as the separator character to indicate the bit-reversed form of the address.

Qualifiers

/DEVICE=device-name

Specifies the LAN controller device name to be used for sending the trigger boot messages. For example, you can specify a DEMNA controller as EXA, EXA0 or EXA0:.

/PASSWORD=16hexdigits

Supplies the password to be used when the connection is initiated, in hexadecimal (for example, /PASSWORD=0123456789ABCDEF). The default password is zero. You can omit leading zeros.

Examples

#1

LANCP> TRIGGER NODE GALAXY/DEVICE=EWA0
      

This command sends MOP trigger boot messages to node GALAXY using Ethernet device EWA0.

#2

LANCP> TRIGGER NODE 08-00-2B-11-22-33/DEVICE=EWA0/PASSWORD=0123456789AB
      

This command sends MOP trigger boot messages to the given node address using the Ethernet device EWA0, with indicated password.

UPDATE DEVICE

Resets a LAN device. Requires SYSPRV privilege.


Format

UPDATE DEVICE device-name


Parameter

device-name

Specifies a device to be reset. The device name has the form ddcu where dd is the device code, c is the controller designation, and u is the unit number. LAN devices are specified as the name of the template device which is unit 0. For example, the first DE435 Ethernet device is specified as EWA0, the second as EWB0.

Qualifiers

/RESET

Specifies that the device is to be reset.

Example


LANCP> UPDATE DEVICE EWA0/RESET

      

Resets Ethernet device EWA0.


Chapter 13
LAT Control Program (LATCP) Utility

13.1 LATCP Description

The LAT Control Program (LATCP) utility is used to configure and control the LAT software on OpenVMS systems. You can use LATCP to:
  • Specify operational characteristics for your node and its services
  • Turn the state of the LAT port driver (LTDRIVER) on and off
  • Display the status of LAT services and service nodes in the network
  • Display the status of links created on your LAT node
  • Display the status of your LAT node
  • Show and zero LAT counters
  • Create, delete, and manage LAT ports
  • Recall previously entered LATCP commands so that you can execute them again without having to retype them
  • Create subprocesses so that you can execute DCL commands without exiting from LATCP

13.2 LATCP Usage Summary

LATCP allows you to control the LAT software on a node and to obtain information from it. For example, you can use LATCP to create services on the local node, to associate a port on the local node with a service or device on a remote terminal server, and to display information about services offered on the local node or on other nodes in the network.

When you use LATCP commands to change LAT characteristics (such as creating a service and associating a port with a service), the changes take effect immediately. However, when the LAT port driver stops, these characteristics are lost. If you want these characteristics to be present the next time you start the LAT port driver, edit LAT$SYSTARTUP.COM by modifying or adding commands to set these characteristics. Then, invoke LAT$STARTUP.COM to start the LAT port driver. (Refer to the HP OpenVMS System Manager's Manual for more information.)


Format

RUN SYS$SYSTEM:LATCP


Description

To invoke LATCP, enter RUN SYS$SYSTEM:LATCP at the DCL command prompt. At the LATCP> prompt, you can enter the LATCP commands described in the following section.

To exit from LATCP, enter the EXIT command at the LATCP> prompt or press Ctrl/Z.

You can also execute a single LATCP command by using a DCL string assignment statement, as shown in the following example:


$ LCP :== $LATCP
$ LCP SET NODE/STATE=ON

LATCP executes the SET NODE command and returns control to DCL.

13.3 LATCP Commands

The following table summarizes the LATCP commands:

Command Function
ATTACH Transfers control from your current process to the specified process.
CREATE LINK Creates LAT data links.
CREATE PORT Creates a logical port on the local node.
CREATE SERVICE Creates a service on a service node.
DEFINE/KEY Assigns a command string to a function key on your keypad.
DELETE LINK Deletes a LAT data link from a node.
DELETE PORT Deletes an application port or dedicated port.
DELETE QUEUE_ENTRY Deletes an incoming queued request from the local node.
DELETE SERVICE Deletes a service on a service node.
EXIT Returns the user to DCL command level.
HELP Displays help text for LATCP commands.
RECALL Recalls LATCP commands that you entered previously so that you can execute them again.
REFRESH Refreshes your display screen, for example, after your display has been overwritten by output from some other source.
SCROLL Allows you to retrieve information that has scrolled off the screen.
SET LINK Modifies characteristics of LAT data links.
SET NODE Specifies LAT characteristics for a node.
SET PORT Maps a logical port on a node to either a remote device on a terminal server or a special application service on a remote LAT service node.
SET SERVICE Changes service characteristics.
SHOW LINK Displays the characteristics of links on your node.
SHOW NODE Displays the characteristics of nodes.
SHOW PORT Displays port characteristics.
SHOW QUEUE_ENTRY Displays information about requests, or entries, queued on the local node.
SHOW SERVICE Displays characteristics of LAT services known to your node.
SPAWN Creates a subprocess.
ZERO COUNTERS Resets the node counters, service counters, and link counters maintained by your node.

ATTACH

Transfers control from your current process to the specified process. The LATCP command ATTACH is similar to the DCL command ATTACH. For example, from the DCL command level you can enter the DCL command SPAWN to create a LATCP subprocess without ending your DCL session, execute several LATCP commands at the LATCP prompt, then use the ATTACH command to return to DCL.

Format

ATTACH [process-name]


Parameter

process-name

Specifies the name of a parent process or spawned subprocess to which control passes. The process must already exist, be part of your current job, and share the same input stream as your current process.

Process names can contain from 1 to 15 alphanumeric characters. If a connection to the specified process cannot be made, LATCP displays an error message.

If you specify the /PID qualifier, do not use the process name parameter. If you omit the /PID qualifier, you must use the process name parameter.

To display processes, use the DCL command SHOW SYSTEM.


Qualifier

/PID=pid

Specifies the process identifier (PID) of the process that will have terminal control. When you specify a PID, you can omit the leading zeros. If you specify a PID, do not use the process name parameter. If you omit the /PID qualifier, you must use the process-name parameter.

Description

The ATTACH command allows you to connect your input stream to another process. You can use ATTACH to change control from one process to another. For example, you can use ATTACH to change control from LATCP to the DCL command level (see the following example). While you are at the DCL command level, LATCP remains in a hibernation state until you use ATTACH to return to it.

You cannot use this command if you are logged in to a captive account. (A captive account is an account set up to restrict user access to the system. You cannot access the DCL command level from a captive account.) You cannot specify both a process name and the /PID qualifier.


Example


$ SET PROCESS/NAME="TOP_LEVEL"
$ SPAWN RUN SYS$SYSTEM:LATCP
LATCP> SHOW NODE/ALL
   .
   .
   .
LATCP> ATTACH "TOP_LEVEL"
$
      

In this example, the user enters the DCL command SPAWN to create a LATCP subprocess and uses LATCP to display the status of all nodes known to the local node. After using LATCP, the user enters the ATTACH command to return to the DCL command level.


Previous Next Contents Index