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.
PURGE
None.
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.
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.
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.
REMOVE file-spec
file-spec
Names the file specification of a known image.
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.
INSTALL> REMOVE GRPCOMM
The command in this example deletes the entry for the known image GRPCOMM from the known image file list.
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.
REPLACE file-spec
file-spec
Names the file specification of an image installed as a known image.
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.
/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.
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.
You can use the LANCP utility to:
- Set LAN parameters to customize your LAN environment.
- Display LAN settings and counters.
- Provide MOP downline load support for devices such as terminal servers, x-terms, and LAN-based printers, and for booting satellites in an OpenVMS Cluster environment. This provides an alternative to the traditional method of using DECnet software.
LANCP [command]
command
Specifies a LANCP command. This parameter is optional. If no command is specified, the utility displays its prompt and waits for command input.
To invoke LANCP, enter the following command at the DCL command prompt:$ RUN SYS$SYSTEM:LANCPThe 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 LANCPTo define LANCP as a foreign command, either at the DCL prompt or in a startup or login command file, enter:
$ LANCP :== $SYS$SYSTEM:LANCPThen 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:
- Without specifying any command qualifiers, the LANCP utility displays the LANCP> prompt, at which you can enter commands.
- With command qualifiers, the LANCP utility terminates after it executes the command and returns you to the DCL command prompt.
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.
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. |
Executes a command procedure or requests the command interpreter to read subsequent command input from a specific file or device.
@ file-spec
file-spec
Specifies either the input device or the file for the preceding command, or the command procedure to be executed.
None.
$ 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.
Deletes a device from the LAN volatile device database. Requires SYSPRV privilege.
CLEAR DEVICE device-name
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.
/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.
LANCP> CLEAR DEVICE EXA0
This command deletes device EXA0 from the LAN volatile device database.
This command is the same as the CLEAR MOPDLL command.
This command clears MOP downline load counters from the LAN volatile device and node databases for all nodes and devices. Requires SYSPRV privilege.
CLEAR MOPDLL
None.
None.
LANCP> CLEAR MOPDLL
This command clears MOP downline load counters from the LAN volatile device and node databases for all nodes and devices.
Deletes a node from the LAN volatile node database. Requires SYSPRV privilege.
CLEAR NODE node-name
node-name
Supplies the name of a node in the LAN volatile node database.
/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.
LANCP> CLEAR NODE VAXSYS
This command deletes the node VAXSYS from the LAN volatile node database.
Opens a MOP console carrier connection to the specified node. This allows a local terminal to act as the console for a remote system.
CONNECT NODE node-specification
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.
/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:
- To allow connection to nodes that do not support Request ID messages
- As a means of getting around implementation problems with one of the formats
Examples
LANCP> CONNECT NODE GALAXY/DEVICE=EWA0
LANCP> CONNECT NODE 08-00-2B-11-22-33/DEVICE=EWA0/PASSWORD=0123456789AB
Converts an OpenVMS V6.2 format device database to an OpenVMS 7.1 format device database. Requires SYSPRV privilege.
CONVERT DEVICE_DATABASE device_database
None.
None.
Converts an OpenVMS V6.2 format node database to an OpenVMS V7.1 format node database. Requires SYSPRV privilege.
CONVERT NODE_DATABASE node_database
None.
None.
Enters a device into the LAN permanent device database or modifies an existing entry. Requires SYSPRV privilege.
DEFINE DEVICE device-name
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.
/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-KeywordMeaning 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]
![]()
6048P023.HTM OSSG Documentation 26-NOV-1996 12:42:52.29Copyright © Digital Equipment Corporation 1996. All Rights Reserved.