[Digital logo]
[HR]

OpenVMS System Management Utilities Reference Manual


Previous | Contents

PURGE

Deletes all known file entries for images installed without the /NOPURGE qualifier.

Requires the CMKRNL privilege. Also requires the SYSGBL privilege to create system global sections and the PRMGBL privilege to create permanent global sections.


Format

PURGE


PARAMETERS

None.

DESCRIPTION

The PURGE command deletes all known file entries for images installed without the /NOPURGE qualifier.

If a process is accessing global sections when the PURGE command is entered, the global sections are deleted only after the operation initiated by the process completes. However, once the command is entered, no additional processes can access the global sections because they are marked for deletion.


Example

INSTALL> PURGE

The command in this example deletes all images except those installed with the /NOPURGE qualifier. The image files remain unaffected. Writable global sections are written back to disk upon their removal as known images.


REMOVE

Deletes a known image. The REMOVE command is identical to the DELETE command.

Requires the CMKRNL privilege. Also requires the SYSGBL privilege to create system global sections and the PRMGBL privilege to create permanent global sections.


Format

REMOVE file-spec


PARAMETER

file-spec

Names the file specification of a known image.

DESCRIPTION

The REMOVE command deletes an entry from the known file list. The image's entry on the known file list and any global sections created for the image are deleted. The image file remains unaffected. Writable global sections are written back to disk upon their removal as known images.

If a process is accessing global sections when the REMOVE command is entered, the global sections are deleted only after the operation initiated by the process completes. However, once the command is entered, no additional processes can access the global sections because they are marked for deletion.


Example

INSTALL> REMOVE GRPCOMM

The command in this example deletes the entry for the known image GRPCOMM from the known image file list.


REPLACE

Replaces a known image entry with another version of the image, or with modified attributes. The REPLACE command is a synonym for the DELETE command.

Requires the CMKRNL privilege. Also requires the SYSGBL privilege to create system global sections and the PRMGBL privilege to create permanent global sections.


Format

REPLACE file-spec


PARAMETER

file-spec

Names the file specification of an image installed as a known image.

DESCRIPTION

The REPLACE command updates a known file to the latest, or to a specified version found in the specified directory, or in another directory if the file-spec parameter uses a search list.

You can use the REPLACE command to modify the attributes of currently installed images. Either specify new qualifiers, or change the value of qualifiers used when installing the image with the CREATE (or ADD) command. If you specify no qualifiers, the new image retains the same attributes as the old one. If the REPLACE command modifies neither the installed image file nor its attributes, the REPLACE command allows continued sharing of global sections.

If a process is accessing global sections when the REPLACE command is entered, the global sections are deleted only after the operation initiated by the process completes. However, once the command is entered, no additional processes can access the global sections because they are marked for deletion.


QUALIFIERS

/ACCOUNTING

/NOACCOUNTING (default)

Enables image-level accounting for selected images even if image accounting is disabled on the local node (by using the DCL command SET ACCOUNTING/DISABLE=IMAGE). When image accounting is enabled on the local node, it logs all images, and the /NOACCOUNTING qualifier has no effect.

/EXECUTE_ONLY

/NOEXECUTE_ONLY (default)

The /EXECUTE_ONLY qualifier is meaningful only to main programs. It allows the image to activate shareable images to which the user has execute access but no read access. All shareable images referenced by the program must be installed, and OpenVMS RMS uses trusted logical names, those created for use in executive or kernel mode.

You cannot specify this qualifier for an executable image linked with the /TRACEBACK qualifier.

/HEADER_RESIDENT

/NOHEADER_RESIDENT

Installs the file as a known image with a permanently resident header (native mode images only). An image installed header resident is implicitly installed open.

/LOG

/NOLOG (default)

Lists the newly created known file entry along with any associated global sections created by the installation.

/OPEN

/NOOPEN

Installs the file as a permanently open known image.

/PRIVILEGED[=(priv-name[,...])]

/NOPRIVILEGED[=(priv-name[,...])]

Installs the file as a known image with the privileges specified. Then, if the image is not located on the system volume, the image is implicitly installed open.

The /PRIVILEGED qualifier applies only to executable images.

You cannot specify this qualifier for an executable image linked with the /TRACEBACK qualifier.

For a complete listing of privileges, see Table 11-2.

/PROTECTED

/NOPROTECTED (default)

Installs the file as a known image that is protected from user-mode and supervisor-mode write access. You can write into the image only from executive or kernel mode. The /PROTECTED qualifier together with the /SHARE qualifier are used to implement user-written services, which become privileged shareable images.

/PURGE (default)

/NOPURGE

Specifies that the image can be removed by a purge operation; if you specify /NOPURGE, you can remove the image only by a delete or remove operation.

/RESIDENT[=([NO]CODE,[NO]DATA)]

On Alpha systems, causes image code sections or read-only data sections to be placed in the granularity hint regions and compresses other image sections, which remain located in process space. If you do not specify the /RESIDENT qualifier, neither code nor data is installed resident. If you specify the /RESIDENT qualifier without keyword arguments, code is installed resident, and data is not installed resident.

The image must be linked using the /SECTION_BINDING=(CODE,DATA) qualifier. An image installed with resident code or data is implicitly installed /HEADER_RESIDENT and /SHARED.

/SHARED

/NOSHARED

Installs the file as a shared known image and creates global sections for the image sections that can be shared. An image installed shared is implicitly installed open.

/WRITABLE

/NOWRITABLE

Installs the file as a writable known image as long as you also specify the /SHARED qualifier. The /WRITABLE qualifier only applies to images with image sections that are shareable and writable. The /WRITABLE qualifier is automatically negated if the /NOSHARED qualifier is specified.

Example

INSTALL> REPLACE GRPCOMM /ACCOUNTING/NOOPEN

The command in this example replaces the known image GRPCOMM with the latest version of the image, while enabling image accounting and removing the OPEN attribute from this version.

The full name of the file specification is assumed to be SYS$SYSTEM:GRPCOMM.EXE.


Chapter 12
LAN Control Program (LANCP) Utility

12.1 LANCP Description

The LAN Control Program (LANCP) utility allows you to configure and control the LAN software on OpenVMS systems. You can use LANCP to:

12.2 LANCP Usage Summary

You can use the LANCP utility to:

Format

LANCP [command]


PARAMETER

command

Specifies a LANCP command. This parameter is optional. If no command is specified, the utility displays its prompt and waits for command input.

DESCRIPTION

To invoke LANCP, enter the following command at the DCL command prompt:
$ RUN SYS$SYSTEM:LANCP

The LANCP utility responds by displaying the LANCP> prompt, at which you can enter any LANCP command described in this chapter.

You can also invoke LANCP by using the MCR command or by defining LANCP as a foreign command.

To use the MCR command, at the DCL command prompt, enter:

$ MCR LANCP

To define LANCP as a foreign command, either at the DCL prompt or in a startup or login command file, enter:

$ LANCP :== $SYS$SYSTEM:LANCP

Then you can enter the LANCP command at the DCL prompt to invoke the utility and enter LANCP commands.

When you enter the LANCP or MCR LANCP command:


Note

Some LANCP commands require special privileges.

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

For information about the LANCP utility, enter the HELP command at the LANCP> prompt.

12.3 LANCP Commands

This section describes and provides examples of the LANCP commands. Table 12-1 summarizes the LANCP commands.

Table 12-1 LANCP Commands
Command Function
@ (Execute Procedure) Executes a command procedure.
CLEAR DLL++ Same as the CLEAR MOPDLL command. Clears MOP downline load counters for all nodes and devices.
CLEAR DEVICE Deletes a device from the LAN volatile device database.
CLEAR MOPDLL Clears MOP downline load counters for all nodes and devices.
CLEAR NODE Deletes a node from the LAN volatile node database.
CONNECT NODE Connects to a LAN device, such as a terminal server, that implements a management interface using the MOP console carrier protocol.
CONVERT DEVICE_DATABASE Converts an OpenVMS V6.2 format device database to an OpenVMS V7.1 format device database.
CONVERT NODE_DATABASE Converts an OpenVMS V6.2 format node database to an OpenVMS V7.1 format node database.
DEFINE DEVICE Enters a device into the LAN permanent device database or modifies an existing entry.
DEFINE NODE Enters a node into the LAN permanent node database or modifies an existing entry.
EXIT Stops execution of LANCP and returns control to the DCL command level.
HELP Provides online help information about the LANCP utility.
LIST DEVICE Displays information in the LAN permanent device database.
LIST NODE Displays information in the LAN permanent node database.
PURGE DEVICE Deletes a device from the LAN permanent device database.
PURGE NODE Deletes a node from the LAN permanent node database.
SET ACP Modifies the operation of the LANACP LAN Server process.
SET DEVICE (parameters)++ Modifies device parameters.
SET DEVICE (volatile device database) Enters a device into the LAN volatile device database or modifies an existing entry.
SET NODE Enters a node into the LAN volatile node database or modifies an existing entry.
SHOW CONFIGURATION Displays a list of LAN devices on the system.
SHOW DEVICE Displays information in the LAN volatile device database.
SHOW DLL++ Displays the current state of MOP downline load services.
SHOW LOG Displays recent downline load activity.
SHOW MOPDLL Displays the current state of MOP downline load services.
SHOW NODE Displays information in the LAN volatile node database.
SPAWN Creates a subprocess of the current process.
TRIGGER NODE Issues a request to reboot to a remote node.
UPDATE DEVICE++ Updates firmware image for a device.


++Alpha only

@ (Execute Procedure)

Executes a command procedure or requests the command interpreter to read subsequent command input from a specific file or device.

Format

@ file-spec


PARAMETER

file-spec

Specifies either the input device or the file for the preceding command, or the command procedure to be executed.

QUALIFIERS

None.

Example

$ CREATE COUNT.COM
SHOW DEVICE/COUNTERS
SPAWN WAIT 00:01:00
@COUNT
[Ctrl/Z]
$ RUN SYS$SYSTEM:LANCP
LANCP> @COUNT
 
Device Counters EXA0: 
             Value  Counter 
             -----  ------- 
        4294967295  Seconds since last zeroed 
          38731696  Data blocks received 
          28378137  Multicast blocks received 
           2621447  Receive failure 
        4294967295  Bytes received 
        3203299230  Multicast bytes received 
                 1  Data overrun 
          13771761  Data blocks sent 
            672064  Multicast packets transmitted 
            662415  Blocks sent, multiple collisions 
            502863  Blocks sent, single collision 
           1056303  Blocks sent, initially deferred 
        1462759444  Bytes sent 
          76562996  Multicast bytes transmitted 
          40042529  Send failure 
                 0  Collision detect check failure 
                 0  Unrecognized frame destination 
                 0  System buffer unavailable 
                 0  User buffer unavailable
 
 

This example creates and runs a command procedure, COUNT.COM, that displays device counters once every minute.


CLEAR DEVICE

Deletes a device from the LAN volatile device database. Requires SYSPRV privilege.

Format

CLEAR DEVICE device-name


PARAMETER

device-name

Supplies the LAN controller device name. 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.

For example, you can specify a DEMNA controller as either EXA, EXA0, or EXA0:. To select all LAN devices, omit the device name and include the /ALL qualifier.


QUALIFIER

/ALL

Deletes all LAN devices in the LAN volatile device database. If you specify a device name, all matching LAN devices are selected, for example: E to select all Ethernet devices, F for FDDI, I for Token Ring, EW to select all Ethernet PCI Tulip devices.

Example

LANCP> CLEAR DEVICE EXA0

This command deletes device EXA0 from the LAN volatile device database.


CLEAR DLL

This command is the same as the CLEAR MOPDLL command.

CLEAR MOPDLL

This command clears MOP downline load counters from the LAN volatile device and node databases for all nodes and devices. Requires SYSPRV privilege.

Format

CLEAR MOPDLL


PARAMETERS

None.

QUALIFIERS

None.

Example

LANCP> CLEAR MOPDLL
 

This command clears MOP downline load counters from the LAN volatile device and node databases for all nodes and devices.


CLEAR NODE

Deletes a node from the LAN volatile node database. Requires SYSPRV privilege.

Format

CLEAR NODE node-name


PARAMETER

node-name

Supplies the name of a node in the LAN volatile node database.

QUALIFIER

/ALL

Deletes all LAN nodes in the LAN volatile node database. If you specify a node name, all matching nodes are selected; for example, A/ALL deletes all nodes whose name begins with A.

Example

LANCP> CLEAR NODE VAXSYS
 

This command deletes the node VAXSYS from the LAN volatile node database.


CONNECT NODE

Opens a MOP console carrier connection to the specified node. This allows a local terminal to act as the console for a remote system.

Format

CONNECT 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 the connection. For example, you can specify a DEMNA controller as EXA, EXA0, or EXA0:.

/DISCONNECT=disconnect-character

Specifies a character that you can use to terminate the connection to the remote node. To terminate a connection, press Ctrl/disconnect-character. You can select any ASCII character from @ through Z, except C, M, Q, S, Y; the default disconnect character is D.

/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.

/V3 or /V4

Indicates that MOP Version 3 or Version 4 formatted messages, respectively, are to be used to make the connection. By default, LANCP determines the format by sending MOP Request ID messages to the remote node first in MOP Version 4 format, then in Version 3 format, repeating this process until a response is received or timeout occurs.

You can specify the format:

Examples

  1. LANCP> CONNECT NODE GALAXY/DEVICE=EWA0 
    

    This command attempts a console-carrier connection to node GALAXY using the Ethernet device EWA0.
  2. LANCP> CONNECT NODE 08-00-2B-11-22-33/DEVICE=EWA0/PASSWORD=0123456789AB 
    

    This command attempts a console-carrier connection to the given node address using the Ethernet device EWA0, with the specified password.

CONVERT DEVICE_DATABASE

Converts an OpenVMS V6.2 format device database to an OpenVMS 7.1 format device database. Requires SYSPRV privilege.

Format

CONVERT DEVICE_DATABASE device_database


PARAMETERS

None.

QUALIFIERS

None.

CONVERT NODE_DATABASE

Converts an OpenVMS V6.2 format node database to an OpenVMS V7.1 format node database. Requires SYSPRV privilege.

Format

CONVERT NODE_DATABASE node_database


PARAMETERS

None.

QUALIFIERS

None.

DEFINE DEVICE

Enters a device into the LAN permanent device database or modifies an existing entry. Requires SYSPRV privilege.

Format

DEFINE DEVICE device-name


PARAMETER

device-name

Supplies the name of a device to be added to the LAN permanent device database or an entry to be modified. 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

/ALL

Defines data for all LAN devices in the LAN permanent device database. If you specify a device name, all matching LAN devices are selected, for example: E to select all Ethernet devices, F for FDDI, I for Token Ring, EW to select all Ethernet PCI Tulip devices.

/ATMADDRESS=LES

On Alpha systems, defines the LAN emulation server (LES) address for asynchronous transfer mode (ATM). Usually the address is not user specified; this qualifier is used only if you want a specific address. By default the address is determined by software from the configuration server for the LES.

The /ATMADDRESS=LES qualifier's syntax is as follows:

DEFINE DEVICE/ATMADDRESS = ([NO]LES=the ATM server) 
 

/ATMADDRESS=ARP

On Alpha systems, defines the LAN address resolution protocol (ARP) server address for ATM. This qualifier is required before a logical IP subnet (LIS) is enabled if the local host is not the ARP server.

The /ATMADDRESS=ARP qualifier's syntax is as follows:

 
DEFINE DEVICE/ATMADDRESS = (ARP=atm_arp_server) 
 

/CLIP

On Alpha systems, the Classical Internet Protocol (CLIP) qualifier defines a device with the TCP/IP protocol that enables it to see a network as being configured as one or more logical IP subnets (LIS), which allows the Alpha system to transmit Ethernet frames over the ATM network. The /CLIP = ENABLE command causes the system to join the LIS when LANCP initializes. The /CLIP = DISABLE command causes the client to leave the logical IP subnet.

Note that a LIS requires a server, and there must be only one server for each subnet. Communication between subnets can only be performed by a router. Also, there can only be one client for each ATM adapter.

The /CLIP qualifier's syntax with standard Internet dotted notation is as follows:

DEFINE DEVICE/CLIP =(ip_subnet=a.b.c.d, 
                     ip_addr=a.b.c.d, 
                     parent=devnam, 
                     name="ip subnet name", 
                     enable, disable 
                     mode = client|server) 

The meanings for the syntax for /CLIP are as follows:
Keyword/
Sub-Keyword
Meaning
Enable Joins the logical IP subnet.
Disable Causes a client to leave the logical IP subnet.
ip_address= Specifies the IP address of the CLIP client.
subnet_mask= Specifies the subnet mask of the CLIP client.
name= Specifies a name for the LIS to aid in operations and diagnostics.
mode=client Starts up a classical IP only. This is the default.
mode=server Starts up a classical IP server and client. Allows only one node for each LIS when specified.

/DLL

On Alpha systems, same as the /MOPDLL qualifier.

/ELAN

On Alpha systems, the /ELAN qualifier has two values: enable and disable. With /ELAN=ENABLE along with the keyword STARTUP, the LAN emulation is loaded when LANCP starts. With /ELAN=DISABLE, the same parameters used with ENABLE can be invoked.

The /ELAN qualifier's syntax is as follows:

DEFINE DEVICE/ELAN =([parent=parent device,].. 
                     [name="ELAN NAME to join",]... 
                     [size=1516]...[type=CSMACD]...[Enable,] 
                     ...[Disable,]...[Enable=startup,] 
                     ...[Disable=startup,]... 
                     [description = "description string,"]) 
 

The meaning of the syntax for /ELAN is as follows:
Option Meaning
parent The ATM adapter device name. An example of the parent device for ATMworks 350 is: HC n0, where n is the controller number. An example of the parent device for ATMworks 750 is: HW n0, where n is the controller number.
name Optionally specified if you want to join a specific ELAN. The default is null.
size Maximum frame size of the LAN you want to join. Valid sizes are 1516, 4544, 9234, or 18,190 bytes. The default is 1516.
type Support currently only for CSMACD, which is the default.
description A method of describing the ELAN for display purposes only.


Previous | Next | Contents | [Home] | [Comments] | [Ordering info] | [Help]

[HR]

  6048P023.HTM
  OSSG Documentation
  26-NOV-1996 12:42:52.29

Copyright © Digital Equipment Corporation 1996. All Rights Reserved.

Legal