%ì Librarian T09-20O?HßI‘ŸO}‘ßI‘Ÿ®À¯5µè@hCLEARCommandsCONNECT´CONVERT”DEFINE@üEXITAŽHELP vLANACPC¢LISTO8PURGERdSET‹ŽSHOW¨ÞSPAWNª¾TRIGGER ­¶cßI‘Ÿ 1 Commands< This section describes and provides examples of the LANCP? commands. The following table summarizes the LANCP commands." Command Function7 @ (Execute Procedure) Executes a command procedure.C CLEAR DLL Clears MOP downline load counters for all, nodes and devices.@ CLEAR DEVICE Deletes a device from the LAN volatile* device database.8 CLEAR MOPDLL  Same as the CLEAR DLL command.C 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 aD management interface using the MOP console+ carrier protocol.D CONVERT DEVICE_ Converts the device database to the formatC DATABASE required by the curren t version of LANCP.B CONVERT NODE_DATABASE Converts the node database to the formatC required by the current version of LANCP.@ DEFINE DEVICE Enters a device into the LAN permanentA device database or modifies an existing entry.C DEFINE NODE Enters a node into the LAN permanent nodeA database or modifies an existing entry.> EXIT Stops executio n of LANCP and returns; control to the DCL command level.D HELP Provides online help information about the( LANCP utility.C LIST DEVICE Displays information in the LAN permanent* device database.C LIST NODE Displays information in the LAN permanent( node database.A PURGE DEVICE Deletes a device from the LAN permanent*  device database.D PURGE NODE Deletes a node from the LAN permanent node# database.B SET ACP Modifies the operation of the LANACP LAN) Server process.? SET DEVICE Enters a device into the LAN volatileA device database or modifies an existing; entry and sets device parameters.B SET NODE Enters a node into the LAN volatil e nodeA database or modifies an existing entry.? SHOW CONFIGURATION Displays a list of LAN devices on the! system.B SHOW DEVICE Displays information in the LAN volatileC device database and displays device data.D SHOW DLL Displays the current state of MOP downline( load services.A SHOW LOG Displays recent downline load activity.7 SHOW MO PDLL Same as the SHOW DLL command.B 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. ww­¶cßI‘Ÿ 1 LANACP= The LANACP Server process provides the following services:3 o Maintenance of the LAN volatile  node database5 o Maintenance of the LAN volatile device database o MOP downline load/ To start the LANACP LAN Server process, typeC @SYS$STARTUP:LAN$STARTUP at the DCL prompt, or include this lineD in the SYS$MANAGER:SYSTARTUP_VMS.COM command file to start LANACP# automatically at system startup.@ The following example shows the command line as it appears in! SYS$MANAGER:SYSTARTUP_VMS.COM: $!N $! To start the LANACP LAN server application, remove the comment delimiter" $! from the command line below. $! $! @SYS$STARTUP:LAN$STARTUP $!@ To stop the LANACP LAN Server process, enter the SET ACP/STOP' command at the LANCP utility prompt. 2 Logical_names2 LANACP uses the following system logical names:' Component DescriptionA LAN$DLL system logical Defines the location of downline loadA name files, where the location of the fileB is not provided in the load request orB explicitly defined in the LAN volatileC node database. By default, this will be@ defined as SYS$SYSROOT:[MOM$SYSTEM].A LAN$NODE_DATABASE Defines the name of the LAN permanent> system logical name node database. By default, this isC defined as SYS$COMMON:[SYSEXE]LAN$NODE_) DATABASE.DAT.7 LAN$DEVICE_DATABASE  Defines the name of the LAN9 system logical name permanent device database. By7 default, this is defined as< SYS$SPECIFIC:[SYSEXE]LAN$DEVICE_) DATABASE.DAT.> LAN$ACP system logical Defines the name of the LANACP LAN? name Server process log file, containingA entries describing changes to the LAN@ permanent device and node databases,< and load request and load statusD information. By default, this is defined@ as SYS$SPECIFIC:[SYSMGR]LAN$ACP.LOG. ww­¶cßI‘Ÿ1 @C Executes a command procedure or requests the command interpreterC to read subsequent command input from a specific file or device. Format @ file-spec 2 Parameter file-specB Specifies either the input device or the file for the preceding4 command, or the command procedure to be executed. 2 Qualifiers None. 2 Example $ CREATE COUNT.COM SHOW DEVICE/COUNTERS SPAWN WAIT 00:01:00 @COUNT $ 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 sent2 672064 Multicast packets transmitted5 662415 Blocks sent, multiple collisions2 502863 Blocks sent, single collision4 1056303 Blocks sent, initially deferred 1462759444 Bytes sent0 76562996 Multicast bytes transmitted! 40042529  Send failure3 0 Collision detect check failure3 0 Unrecognized frame destination. 0 System buffer unavailable, 0 User buffer unavailableB This example creates and runs a command procedure, COUNT.COM,5 that displays device counters once every minute. ww­/=eßI‘Ÿ1 CLEAR 2 DEVICEC Deletes a device from the LAN volatile device database. Requires SYSPRV privilege. Format CLEAR DEVICE device-name 3 Parameter device-name? Supplies the LAN controller device name. The device name hasA the form ddcu where dd is the device code, c is the controllerC designation, and u is the unit number. LAN devices are specifiedC as the name of the template device which is unit 0. For example,D the first PCI Ethernet device is specified as EWA0, the second as EWB0.A For example, you can specify a DEMNA controller as either EXA, EXA0, or EXA0:. 3 Qualifier /ALLB Deletes all LAN devices in the LAN volatile device database. IfD you specify a device name, all matching LAN devices are selected,C for example: E to select all Ethernet devices, F for FDDI, I for9 Token Ring, EW to select all PCI Ethernet PCI devices. 3 Example LANCP> CLEAR DEVICE EXA0B This command deletes device EXA0 from the LAN volatile device database. 2 DLL> 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 DLL 3 Parameters None. 3 Qualifiers None. 3 Example LANCP> CLEAR DLL@ This command clears MOP downline load counters from the LANB volatile device and node databases for all nodes and devices. 2 NODE? Deletes a node from the LAN volatile node database. Requires SYSPRV privilege. Format CLEAR NODE node-name 3 Parameter node-nameA Supplies the name of a node in the LAN volatile node database. 3 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. 3 Example LANCP> CLEAR NODE VAXSYSD This command deletes the node VAXSYS from the LAN volatile node database. ww­/=eßI‘Ÿ 1 CONNECT 2 NODE@ Opens a MOP console carrier connection to the specified node.B This allows a local terminal to act as the console for a remote system. Format% CONNECT NODE node-specification 3 Parameter node-specificationB Supplies either the node name or the node address of the targetB node. If you supply the node name, the node address is obtainedD by looking up the node name in the LAN volatile node database. IfB you supply the node address, the corresponding node need not beC defined in the LAN volatile node database. The canonical form ofB the address consists of 6 hexadecimal byte characters separatedA by hyphens. Use a colon as the separator character to indicate( the bit-reversed form of the address. 3 Qualifiers /DEVICE /DEVICE=device-name> Specifies the LAN controller device name to be used for theA connection. For example, you can specify a DEMNA controller as EXA, EXA0, or EXA0:. /DISCONNECT& /DISCONNECT=disconnect-character: Specifies a character that you can use to terminate theB connection to the remote node. To terminate a connection, press@ Ctrl/disconnect-character. You can select any ASCII characterA from @ through Z, except C, M, Q, S, Y; the default disconnect character is D. /PASSWORD /PASSWORD=16hexdigits7 Supplies the password to be used when the connection-  is initiated, in hexadecimal (for example,A /PASSWORD=0123456789ABCDEF). The default password is zero. You can omit leading zeros. /V3A Indicates that MOP Version 3 formatted messages are to be usedB to make the connection. By default, LANCP determines the formatA by sending MOP Request ID messages to the remote node first inA 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:A o To allow connection to nodes that do not support Request ID messagesC o As a means of getting around implementation problems with one of the formats /V4A Indicates that MOP Version 4 formatted messages are to be usedB to make the connection. By default, LANCP determines the formatA by sending MOP Request ID messages to the remote node first inA 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:A o To allow connection to nodes that do not support Request ID messagesC o As a means of getting around implementation problems with one of the formats 3 Examples+ 1.LANCP> CONNECT NODE GALAXY/DEVICE=EWA0? This command attempts a console-carrier connection to node+ GALAXY using the Ethernet device EWA0.L 2.LANCP> CONNECT NODE 08-00-2B-11-22-33/DEVICE=EWA0/PASSWORD=0123456789ABD This command attempts a console-carrier connection to the givenD node address using the Ethernet device EWA0, with the specified password. ww­/=eßI‘Ÿ 1 CONVERT 2 DEVICE_DATABASEC Converts the device database to the format required by LANCP. IfC the database is not updated, LANCP can read the database but not3 update entries in it. Requires SYSPRV privilege. Format- CONVERT DEVICE_DATABASE device_database 3 Paramet!ers None. 3 Qualifiers None. 2 NODE_DATABASEA Converts the node database to the format required by LANCP. IfC the database is not updated, LANCP can read the database but not3 update entries in it. Requires SYSPRV privilege. Format) CONVERT NODE_DATABASE node_database 3 Parameters None. 3 Qualifiers None. ww­ÏÃfßI‘Ÿ 1 DEFINE 2 DEVICE< Enters a device into the LAN permanent device database or9 modifies an existing entry. Requires SYSPRV privilege. Format DEFINE DEVICE device-name 3 Parameter device-nameA Supplies the name of a device to be added to the LAN permanentB device database or an entry to be modified. The device name hasA the form ddcu where dd is the device code, c is the controllerC designation, and u is the unit number. LAN devices are specifiedC as the name of the template device which is unit 0. For example,D the first PCI Ethernet device is specified as EWA0, the second as EWB0. 3 Qualifiers /ALL? Defines data for all LAN devices in the LAN permanent deviceC 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 devices. /ATMADDRESS> On Alpha systems, /ATMADDRESS=LES defines the LAN emulation= server (LES) address for as !ynchronous transfer mode (ATM).? Usually the address is not user specified; this qualifier isC used only if you want a specific address. By default the addressB is determined by software from the configuration server for the LES.8 The /ATMADDRESS=LES qualifier's syntax is as follows:6 DEFINE DEVICE/ATMADDRESS = ([NO]LES=the ATM server)< On Alpha systems, /ATMADDRESS=ARP defines the LAN address@ resolution protocol (ARP) server address for Clasical IP overC ATM. Th"is qualifier is required before a logical IP subnet (LIS)6 is enabled if the local host is not the ARP server.8 The /ATMADDRESS=ARP qualifier's syntax is as follows:2 DEFINE DEVICE/ATMADDRESS = (ARP=atm_arp_server) /CLIPC On Alpha systems, defines the Classical Internet Protocol (CLIP)@ over ATM (RFC1577). The CLIP qualifier implements a data-linkB level device as a client and/or a server in a logical IP subnetA (LIS). This allows the IP protocol to transmit Ethern#et frames> over the ATM network. The /CLIP = ENABLE command causes theA system to join the LIS. 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 oneD server for each subnet. Communication between subnets can only beC performed by a router. 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_address=a.b.c.d,& parent=devnam,. name="ip subnet name",' enable, disable- type = client|server)8 The meanings for the syntax for /CLIP are as follows: Option Meaning< ip_address Specifies the IP address of the CLIP client.= ip_subnet Specifies the subnet mask of the CLIP client.1 parent=devnamSpecif %ies the parent device name.A name Specifies a name for the LIS to aid in operations and diagnostics.A type=client Starts up a classical IP client only. This is the default.@ type=server Starts up a classical IP server. Only one serverC for each LIS is allowed, and the server needs to be started first.; type=(server,Starts)up a classical IP server and client.7 Keywords and their meaning for /CLIP are as f&ollows: Keyword Meaning( Enable Joins the logical IP subnet.; Disable Causes a client to leave the logical IP subnet. /DLL9 /DLL=(enable-option, exclusive-option, size-option, knownclientsonly-option)B Provides the MOP downline load service settings for the device.A Note that defaults apply to creation of an entry in the device? database. If an existing entry is being modified, fields not specified remain unchanged.> You can specify t'he following keywords with this qualifier: o enable-option ENABLE DISABLE (default)B Specify ENABLE or DISABLE to indicate that MOP downline load; service should be enabled or disabled for the device. o exclusive-option EXCLUSIVE! NOEXCLUSIVE (default)A Specify EXCLUSIVE to indicate that no other provider of MOPB downline load service is allowed on the specified LAN deviceA at the same time as (LANACP. Specify NOEXCLUSIVE to indicate= that the LAN MOP downline load service can coexist with? other implementations (in particular, the DECnet Phase IVD implementation that operates the MOP protocol in shared mode). o size-option SIZE=valueB Use SIZE=value to specify the size in bytes of the file data@ portion of each downline load message. The permitted rangeA is 246 to 1482 bytes. The default value is 246 bytes, which> should ) allow any client to load properly. Note that some. clients may not support the larger size.? The recommended size for better load performance and lessD server overhead is the largest size that results in successful> loads of all clients. The 1482 value is derived from theC maximum packet size for CSMA/CD (Ethernet) of 1518 bytes lessB the 802e header and CRC (26 bytes) and MOP protocol overhead (10 bytes).C You can override the size on a per-nod *e basis. See the DEFINE- NODE and SET NODE commands for details. o knownclientsonly-option KNOWNCLIENTSONLY( NOKNOWNCLIENTSONLY (default)A Specify KNOWNCLIENTSONLY to indicate that MOP downline load= requests should be serviced only for clients defined inA the LAN permanent node database. When NOKNOWNCLIENTSONLY isD selected, LANACP searches the LAN$DLL directory for any imagesD requested by clients that are not defined in t+he LAN permanent node database. /ELANC On Alpha systems, the /ELAN qualifier has two values: enable andA disable. With /ELAN=ENABLE along with the keyword STARTUP, theB LAN emulation is loaded when LANACP starts. With /ELAN=DISABLE,7 the same parameters used with ENABLE can be invoked.. The /ELAN qualifier's syntax is as follows:- DEFINE DEVICE/ELAN =(parent=parent device,1 name="ELAN NAME to join",! size=1516,# type=CSMACD Enable, Disable,< description = "description string,") 5 The meaning of the syntax for /ELAN is as follows: Option MeaningC parent The ATM adapter device name. An example of the parentB device for DAPCA is: HWn0, where n is the controllerC number. An example of the parent device for DGLTA is:5 HCn0, where n is the con -troller number.A name Optionally specified if you want to join a specific( ELAN. The default is null.C size Maximum frame size of the LAN you want to join. ValidA sizes are 1516, 4544, or 9234 bytes. The default is 1516.= type Support currently only for CSMACD, which is the default.B descriptionA method of describing the ELAN for display purposes only.8 Keywords and their meanings for /EL.AN are as follows: Keyword MeaningD Enable Begins a join on a specified emulated LAN. It also loads. the driver, if not already loaded.6 Disable Causes a client to leave the emulated LAN. /PVC /PVC=(vci[,...]) /[NO]PVC=(vci[,...])C On Alpha systems, defines the permanent virtual circuit (PVC) toA be used by a Classical IP over ATM client. This is an optional qualifier.B A list of PVCs is defined for use by CLIP clients. This com/mandD should be used before enabling the CLIP client. The PVC has to be% set up manually in the ATM switch.A The vci is the VCI (Virtual Circuit ID) of the PVC to be used. /UPDATE? Adds LAN devices that are not currently in the LAN permanent> device database to that database. The initial entry for the? device uses default values for all parameters. To update the@ permanent database with current information from the volatile> database, use the DEFINE DEVICE comma 0nd with the /VOLATILE_A DATABASE qualifier. You can combine the /UPDATE and /VOLATILE_9 DATABASE qualifiers in a single DEFINE DEVICE command. /VOLATILE_DATABASEB Updates the device entries in the LAN permanent device databaseD with any data currently set in the volatile database. This allowsB you to update the permanent database after changing data in theA volatile database, rather than repeating the commands for each@ updated entry to apply the changes to the permane1nt database. 3 Examples8 1.LANCP> DEFINE DEVICE EXA0/MOPDLL=(ENABLE,EXCLUSIVE)> This command defines LAN device EXA0 to enable LANACP MOP@ downline load service in exclusive mode. The setting of theB KNOWNCLIENTSONLY and SIZE characteristics are not changed. IfC the device entry does not currently exist in the LAN permanent= device database, these settings are set to the defaults.0 2.LANCP> DEFINE DEVICE/ALL/MOPDLL=NOEXCLUSIVEC This command sets a2ll LAN devices defined in the LAN permanentA device database to nonexclusive mode for LANACP MOP downline load service.6 3.LANCP> DEFINE DEVICE/ALL/UPDATE/VOLATILE_DATABASED This command enters all Ethernet devices into the LAN permanentA device database and updates the entry to include the current parameter values. 2 NODED Enters a node into the LAN permanent node database or modifies an- existing entry. Requires SYSPRV privilege. Format3 DEFINE NODE node-name 3 Parameter node-nameD Supplies the name of a node to be added to the LAN permanent nodeC database or an entry to be modified. Typically, the node name isA the same as that given in the system parameter SCSNODE, but itD does not need to be. The node name is limited to 63 characters in length. 3 Qualifiers /ADDRESS /ADDRESS=node-address /NOADDRESS (default)C Associates a LAN address with the node name 4. Specify the address@ as 6 bytes in hexadecimal notation, separated by hyphens. TheD address does not have to be unique (as might be the case when the@ address is not known, so a nonexistent address is specified).D If multiple node addresses are to be associated with a node name,B each combination may be given as a node name with an extension,@ for example, VAXSYS.EXA for the EXA device on node VAXSYS, or4 VAXSYS_1 for the first LAN device on node VAXSYS.D If you do not s5pecify the /ADDRESS qualifier, the setting remains8 unchanged. The /NOADDRESS qualifier clears the field. /ALLA Defines data for all nodes in the LAN permanent node database.C If you specify a node name, all matching nodes are selected; for5 example, A/ALL selects all nodes beginning with A. /BOOT_TYPE /BOOT_TYPE=boot-option /NOBOOT_TYPE> Indicates the type of processing required for downline load? requests. You can specify one of the following ke6ywords with this qualifier:9 o VAX_SATELLITE-an OpenVMS Cluster VAX satellite boot= o ALPHA_SATELLITE-an OpenVMS Cluster Alpha satellite bootA o OTHER-the specified image; a noncluster satellite load that& does not require additional dataB The distinction is necessary, because OpenVMS Cluster satelliteC loads require additional cluster-related data be appended to the@ load image given by the /FILE qualifier. The default value is OTHER.> If you do n7ot specify the /BOOT_TYPE qualifier, the settingB remains unchanged. The /NOBOOT_TYPE qualifier clears the field. /DECNET_ADDRESS /DECNET_ADDRESS=value /NODECNET_ADDRESS> Associates a DECnet address with the node name. Specify the' address in DECnet notation, xx.xxxx.B If you do not specify the /DECNET_ADDRESS=value qualifier, thenA the setting remains unchanged. The /NODECNET_ADDRESS qualifier clears the field. /FILE /FILE=file-spec 8 /NOFILE< Supplies the file name of a boot file to be used when theC downline load request does not include a file name (for example,B with OpenVMS Cluster satellite booting). The file specification is limited to 127 characters.@ If no file name is specified, OpenVMS Cluster satellite loadsD default to APB.EXE where the boot type is set to ALPHA and NISCS_. LOAD.EXE where the boot type is set to VAX.A If you do not specify the /FILE qualifier, the setting remain9s5 unchanged. The /NOFILE qualifier clears the field. /IP_ADDRESS /IP_ADDRESS=value /NOIP_ADDRESSC Associates an IP address with the node name. Specify the address4 in the standard dotted notation, xxx.xxx.xxx.xxx.= If you do not specify the /IP_ADDRESS=value qualifier, the@ setting remains unchanged. The /NOIP_ADDRESS qualifier clears the filed. /ROOT# /ROOT=directory-specification /NOROOTA Supplies the directory spec :ification to be associated with the@ file name. For cluster satellite service, the /ROOT qualifierB specifies the satellite root directory. For noncluster service,A this qualifier specifies the location of the file. If the fileD specification or the file name given in the boot request includes? the directory name, this qualifier is ignored. The directory. specification is limited to 127 characters.A If you do not specify the /ROOT qualifier, the setting remains5 unchanged;. The /NOROOT qualifier clears the field. /SIZE /SIZE=value /NOSIZE? Specifies the size in bytes of the file data portion of each; downline load message. The default is the load data size? specified for the device. The permitted range is 246 to 1482@ bytes. Use a larger size for better load performance and less server overhead.A If you do not specify the /SIZE qualifier, the setting remains7 unchanged. The /NOSIZE qualifier clears the setting.< /V3 /V3 /NOV3A Indicates that only MOP Version 3 formatted messages are to be? used for downline load purposes, regardless of the requestedC format. This allows systems that have a problem with MOP VersionB 4 booting to load. This qualifier causes the requesting node toA fail over from MOP Version 4 to MOP Version 3 when no response1 has been made to a MOP Version 4 load request.? If you do not specify the /V3 qualifier, the setting remains5 = unchanged. The /NOV3 qualifier clears the setting. /VOLATILE_DATABASEC Updates the node entries in the LAN permanent node database with? any data currently set in the volatile database. This allowsB you to update the permanent database after changing data in theA volatile database, rather than repeating the commands for each@ updated entry to apply the changes to the permanent database. 3 Examples: 1.LANCP> DEFINE NODE GALAXY/ADDRESS=08-00-2B-11-22-33 -- > /FILE=NISCS_LOAD.EXE -1 /ROOT=$64$DIA14: -/ /BOOT_TYPE=VAX_SATELLITE? This command sets up node GALAXY in the LAN permanent node< database for booting as a VAX satellite into an OpenVMS Cluster.> The NISCS_LOAD.EXE file is actually located on $64$DIA14:A . The is supplied@ by the LANACP LAN Server process and is not included in the root de ?finition.: 2.LANCP> DEFINE NODE ZAPNOT/ADDRESS=08-00-2B-11-22-33 -& /FILE=APB.EXE -1 /ROOT=$64$DIA14: -1 /BOOT_TYPE=ALPHA_SATELLITE= This command sets up node ZAPNOT for booting as an Alpha' satellite into an OpenVMS Cluster.7 The APB.EXE file is actually located on $64$DIA14:B . Note that the isB supplied by the LANACP LAN Server process and i @s not included in the root definition.: 3.LANCP> DEFINE NODE CALPAL/ADDRESS=08-00-2B-11-22-33 -( /FILE=APB_061.EXE? This command sets up node CALPAL for booting an InfoServerA image. It defines the file that should be loaded when a load> request without a file name is received from node CALPAL.A Because the file does not include a directory specification,C the logical name LAN$DLL defines where to locate the file. YouA could give Adirectory specification using the file name or by using the /ROOT qualifier.> Note that specifying the file name explicitly in the bootC command overrides the file name specified in the node database entry. ww­oJhßI‘Ÿ1 EXITB Stops execution of LANCP and returns control to the DCL command8 level. You can also enter Ctrl/Z at any time to exit. Format EXIT 2 Parameters None. 2 Qualifiers None. 2 ExaBmple LANCP> EXIT $A This command stops execution of LANCP and returns control to the DCL command level. ww­oJhßI‘Ÿ1 HELP< Provides online help information about the LANCP utility. Format HELP [topic] 2 Parameter topic= Specifies a subject for which you want information-a LANCPA command or LANCP command and command keyword. If you enter theA HELP command with a command name only, such as HELP SET, LANCPC disCplays a list of all of the command keywords used with the SET command. 2 Qualifiers None. 2 Example LANCP> HELP DEFINE DEVICE DEFINE DEVICE& DEVICE device-name/qualifiers DEVICE/ALL/qualifiersE Sets device specific parameters for the specified LAN devices.! Requires SYSPRV privilege.& Additional information available: Parameters Qualifiers7 /ALL /ATMADDRESS /DLL /ELAN /MOPDLL /VOLATILE_DATABADSE /UPDATE Examples DEFINE DEVICE Subtopic?C This command provides online help for the LANCP command DEFINE DEVICE. ww­ÑißI‘Ÿ1 LIST 2 DEVICE= Displays information in the LAN permanent device database. Format LIST DEVICE device-name 3 Parameter device-name? Supplies the LAN controller device name. The device name hasA the form ddcu where dd is the device code, c is the controllerC designation E, and u is the unit number. LAN devices are specifiedC as the name of the template device which is unit 0. For example,C the first DE435 Ethernet device is specified as EWA0, the second as EWB0.@ For example, you can specify a DEMNA controller as EXA, EXA0,A or EXA0:. This refers to the LAN template device, for which isC maintained most of the device parameters and counters. Also, the@ device name can refer to a device unit representing an actual= user or protocol. ForF example, the cluster protocol can be@ started on a device as EWA1. You can specify a device unit to, view unit-specific parameter information.B If you do not specify a device name, all devices are displayed.= If you specify a device name, all matching LAN devices are> displayed, for example: E to select all Ethernet devices, FB for FDDI, I for Token Ring, EW to select all Ethernet PCI Tulip devices.& NOTEA If you do not specify Ga qualifier, the utility displays the6 matching devices without additional information. 3 Qualifiers /ALL: Lists all devices in the LAN permanent device database. /CHARACTERISTICSC On Alpha systems, lists status and related information about the3 device. It is the same as /PARAMETERS qualifier. /DLL. Displays MOP downline load characteristics. /MAPD Lists the current configuration of the functional address mapping table. H/MOPDLL Same as /DLL qualifier. /OUTPUT /OUTPUT=file name7 Creates the specified file and directs output to it. /PARAMETERSC On Alpha systems, lists status and related information about the device. /SR_ENTRY= On Alpha systems, lists the contents of the current source routing cache table. 3 Examples 1.LANCP> LIST DEVICE/MOPDLL) Device Listing, permanent database:D --- MOP Downline Load Service I Characteristics ---G Device State Access Mode Clients Data SizeG ------ ----- ----------- ------- ---------H EXA0 Enabled Exclusive KnownClientsOnly 1400 bytesH FXA0 Disabled NoExclusive NoKnownClientsOnly 246 bytesC This command displays MOP downline load information in the LAN5 permanent device database for all known devices.# 2.LANCP> LIST DEVICE/MOPDLL EXA0( Device Listin Jg, permanent database:D --- MOP Downline Load Service Characteristics ---G Device State Access Mode Clients Data SizeG ------ ----- ----------- ------- ---------H EXA0 Enabled Exclusive KnownClientsOnly 1400 bytesC This command displays MOP downline load information in the LAN/ permanent device database for device EXA0. 2 NODE; Displays information in the LAN permanent node daKtabase,, especially MOP downline load information. Format LIST NODE node-name 3 Parameter node-nameD Specifies the node name. The name can include up to 63 charactersB associated with the node address. If no node name is given, all nodes are displayed. 3 Qualifiers /ALLB Displays data for all nodes in the LAN permanent node database.C If you specify a node name, all matching nodes are selected; for5 example, A/ALL selects alLl nodes beginning with A. /OUTPUT /OUTPUT=file-nameA Creates the specified file and directs output to that file. IfB the file extension is .com, the output is in the form of a listB of DEFINE NODE or SET NODE commands. The resulting command file0 can be used to create the LAN node databases. 3 Example LANCP> LIST NODE Node Listing: GALAXY (08-00-2B-2C-51-28): MOP DLL: Load file: APB.EXE+ Load root: $64$DIA24:( M Boot type: Alpha satellite ZAPNOT (08-00-2B-18-7E-33):' MOP DLL: Load file: NISCS_LOAD.EXE0 Load root: LAVC$SYSDEVICE:& 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 failedA Last request was for a system image, in MOP V4 format4 N Last load initiated 30-OCT-1994 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 41849 Last load CALPAL at 10-JUN-1998 09:11:17.29A This ex Oample shows output from a LIST NODE command issued onA a local node on which there are three nodes defined (GALAXY,> ZAPNOT, and CALPAL). CALPAL has issued two load requests:C o The first request is the multicast request from CALPAL that- the local node volunteered to accept.C o The second request is the load request sent directly to theB local node by CALPAL for the actual load data. The elapsedC time from the second load request to completion ofP the load was 6.65 seconds. ww­¯ŒwßI‘Ÿ1 PURGE 2 DEVICED Deletes a device from the LAN permanent device database. Requires SYSPRV privilege. Format PURGE DEVICE device-name 3 Parameter device-name? Supplies the LAN controller device name. The device name hasA the form ddcu where dd is the device code, c is the controllerC designation, and u is the unit number. LAN devices are specifiedC as the name of the Qtemplate device which is unit 0. For example,C the first DE435 Ethernet device is specified as EWA0, the second as EWB0.@ For example, you can specify a DEMNA controller as EXA, EXA0,@ or EXA0:. To select all LAN devices, omit the device name and include the /ALL qualifier. 3 Qualifier /ALLC Deletes all LAN devices in the LAN permanent device database. IfD you specify a device name, all matching LAN devices are selected,C for example: E to select all EtRhernet devices, F for FDDI, I for; Token Ring, EW to select all Ethernet PCI Tulip devices. 3 Example LANCP> PURGE DEVICE/ALLC This command deletes all devices from the LAN permanent device database. 2 NODE@ Deletes a node from the LAN permanent node database. Requires SYSPRV privilege. Format PURGE NODE node-name 3 Parameter node-nameB Supplies the name of a node in the LAN permanent node database. 3 QualifierS /ALL? Deletes all LAN nodes in the LAN permanent 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. 3 Example LANCP> PURGE NODE/ALL? This command deletes all nodes from the LAN permanent node database. ww­¯ŒwßI‘Ÿ1 SET 2 ACPD Modifies the operation of the LANACP LAN Server process. Requires SYSPRV privilege. Format STET ACP 3 Parameters None. 3 Qualifiers /ECHO /ECHO /NOECHO (default)? Enables partial tracing of received and transmitted downline; load messages (the first 32 bytes of the data portion of< each message). Note that the last one or two MOP messages> are displayed in full: the memory load message with clusterD parameters, and the parameter load with transfer address message, where present in the load.C The data is written to a Ulog file SYS$MANAGER:LAN$node-name.LOG.? To obtain the entire contents of each message, use the /FULL qualifier as follows: SET ACP/ECHO/FULL /FULL /FULL /NOFULL (default)B When /ECHO is enabled, displays the entire contents of received* and transmitted downline load messages. /OPCOM /OPCOM (default) /NOOPCOM9 Enables OPCOM messages from LANACP LAN Server process.? Messages are generated by the LANACP LAN Server proceVss when; a device status changes, load requests are received, andA loads complete. These messages are displayed on the operator's: console and included in the log file written by LANACP, SYS$MANAGER:LAN$ACP.LOG. /STOPC Stops the LANACP process. It can be restarted by reexecuting the( SYS$STARTUP:LAN$STARTUP command file. 3 Example LANCP> SET ACP/ECHO/FULL= This command enables tracing of received and transmittedD downline load messages. The /WFULL qualifier displays the entireA contents of received and transmitted downline load messages. 2 DEVICE_parameters Alpha only.< On Alpha systems, sets or modifies LAN device parameters. Requires PHY_IO privilege. Format SET DEVICE device-name 3 Parameter device-name> Specifies a device to be entered in the LAN volatile device? database, or whose parameters are to be modified. The device? name has the form ddcu where dd is the Xdevice code, c is theD controller designation, and u is the unit number. LAN devices areD specified as the name of the template device which is unit 0. ForA example, the first DE435 Ethernet device is specified as EWA0, the second as EWB0. 3 Qualifiers /AGING_TIMER /AGING_TIMER=value> Sets the amount of time in seconds to age Token Ring source> routing cache entries before marking them stale. This timerA expires when no traffic is sent to or received Yfrom the remote@ node in this amount of time. The default value is 60 seconds.? Increase this value when idle connections bounce between the? stale and known states. Setting this value too low may cause4 unnecessary explorer traffic to traverse the LAN. /ALLC Sets data for all LAN devices. If you specify a device name, allB matching LAN devices are selected, for example: E to select allC Ethernet devices, F for FDDI, I for Token Ring, EW to select all Ethernet ZPCI Tulip devices. /ATMADDRESSB On Alpha systems, /ATMADDRESS=LES sets the LAN emulation serverB (LES) address for asynchronous transfer mode (ATM). Usually theD address is not user specified, and this qualifier is used only ifD you want a specific address. By default the address is determined9 by software from the configuration server for the LES.8 The /ATMADDRESS=LES qualifier's syntax is as follows:3 SET DEVICE/ATMADDRESS = ([NO]LES=the ATM server)@ On Alph[a systems, /ATMADDRESS=ARP sets the address resolution@ protocol (ARP) server address for Classical IP over ATM. ThisB qualifier is required before a LIS is enabled if the local host is not the ARP server.8 The /ATMADDRESS=ARP qualifier's syntax is as follows:/ SET DEVICE/ATMADDRESS = (ARP=atm_arp_server) /CACHE_ENTRIES /CACHE_ENTRIES=value? Sets the number of entries to reserve for caching Token RingD source routing address entries. The default value is \200 entries.< If your system directly communicates to a large number of1 systems, you may want to increase this number. /CLIPB Sets the Classical Internet Protocol (CLIP) over ATM (RFC1577).> The CLIP qualifier implements a data-link level device as aC client and/or a server in a logical IP subnet (LIS). This allowsD the IP protocol to transmit Ethernet frames over the ATM network.D The /CLIP = ENABLE command causes the system to join the LIS. TheD /CLIP = DISABLE] command causes the client to leave the logical IP subnet.@ Note that a LIS requires a server, and there must be only oneD server for each subnet. Communication between subnets can only beC performed by a router. There can only be one client for each ATM adapter.= The /CLIP qualifier's syntax with standard Internet dotted notation is as follows:' SET DEVICE/CLIP =(ip_subnet=a.b.c.d,( ip_address=a.b.c.d,# parent=devnam,+ ^ name="ip subnet name",$ enable, disable* type = client|server)8 The meanings for the syntax for /CLIP are as follows: Option Meaning< ip_address Specifies the IP address of the CLIP client.= ip_subnet Specifies the subnet mask of the CLIP client.1 parent=devnamSpecifies the parent device name.A name Specifies a name for the LIS to aid in operations and diagnostics.A type=cl_ient Starts up a classical IP client only. This is the default.@ type=server Starts up a classical IP server. Only one serverC for each LIS is allowed, and the server needs to be started first.; type=(server,Starts)up a classical IP server and client.7 Keywords and their meaning for /CLIP are as follows: Keyword Meaning( Enable Joins the logical IP subnet.; Disable Causes a client to leave the logical IP subnet. ` /CONTENDER /CONTENDER /NOCONTENDER (default)< Specifies that the Token Ring device is to participate in= the Monitor Contention process when it joins the ring. TheB /NOCONTENDER qualifier, directs the device not to challenge the current ring server. /DISCOVERY_TIMER /DISCOVERY_TIMER=valueD Sets the number of seconds to wait for a reply from a remote node@ when performing the source Token Ring routing route discovery+ process. The default avalue is 2 seconds.B If you have nodes that respond slowly on your extended LAN, youD may need to increase this number to reduce the amount of explorer# traffic that traverses your LAN. /DLL9 /DLL=(enable-option, exclusive-option, size-option, knownclientsonly-option)B Provides the MOP downline load service settings for the device.A Note that defaults apply to creation of an entry in the device? database. If an existing entry is being modified, fields bnot specified remain unchanged.> You can specify the following keywords with this qualifier: o enable-option ENABLE DISABLE (default)B Specify ENABLE or DISABLE to indicate that MOP downline load; service should be enabled or disabled for the device. o exclusive-option EXCLUSIVE! NOEXCLUSIVE (default)A Specify EXCLUSIVE to indicate that no other provider of MOPB downline load service is all cowed on the specified LAN deviceA at the same time as LANACP. Specify NOEXCLUSIVE to indicate= that the LAN MOP downline load service can coexist with? other implementations (in particular, the DECnet Phase IVD implementation that operates the MOP protocol in shared mode). o size-option SIZE=valueB Use SIZE=value to specify the size in bytes of the file data@ portion of each downline load message. The permitted rangeA is 246 to 1482 d bytes. The default value is 246 bytes, which> should allow any client to load properly. Note that some. clients may not support the larger size.? The recommended size for better load performance and lessD server overhead is the largest size that results in successful> loads of all clients. The 1482 value is derived from theC maximum packet size for CSMA/CD (Ethernet) of 1518 bytes lessB the 802e header and CRC (26 bytes) and MOP protocol overhead e(10 bytes).C You can override the size on a per-node basis. See the DEFINE- NODE and SET NODE commands for details. o knownclientsonly-option KNOWNCLIENTSONLY( NOKNOWNCLIENTSONLY (default)A Specify KNOWNCLIENTSONLY to indicate that MOP downline load= requests should be serviced only for clients defined inA the LAN permanent node database. When NOKNOWNCLIENTSONLY isD selected, LANACP searches the LAN$DLL directory for any fimagesD requested by clients that are not defined in the LAN permanent node database. /EARLY /EARLY (default) /NOEARLY: Enables Early Token Release on the device. The /NOEARLY+ qualifier, disables Early Token Release. /ELAN? The /ELAN qualifier has two values: enable and disable. WithA /ELAN=ENABLE along with the keyword STARTUP, the LAN emulation= is loaded when LANACP starts. With /ELAN=DISABLE, the same. parameters used with ENABgLE can be invoked.. The /ELAN qualifier's syntax is as follows:- DEFINE DEVICE/ELAN =(parent=parent device,1 name="ELAN NAME to join",! size=1516# type=CSMACD Enable, Disable,< description = "description string,") 5 The meaning of the syntax for /ELAN is as follows: Option MeaningC parent The ATM adapter device nam he. An example of the parentB device for DAPCA is: HWn0, where n is the controllerC number. An example of the parent device for DGLTA is:5 HCn0, where n is the controller number.A name Optionally specified if you want to join a specific( ELAN. The default is null.C size Maximum frame size of the LAN you want to join. ValidA sizes are 1516, 4544, or 9234 bytes. The default is 1516.= type i Support currently only for CSMACD, which is the default.B descriptionA method of describing the ELAN for display purposes only.8 Keywords and their meanings for /ELAN are as follows: Keyword MeaningD Enable Begins a join on a specified emulated LAN. It also loads. the driver, if not already loaded.6 Disable Causes a client to leave the emulated LAN. /FULL_DUPLEX /FULL_DUPLEX /NOFULL_DUPLEX (default)D E jnables full-duplex operation of a LAN device. Before full-duplex? operation results from the use of this qualifier, additionalA device or network hardware setup may be required. Some devicesD may be enabled for full-duplex operation by default. Some devices+ may not allow the setting to be changed.@ The /NOFULL_DUPLEX qualifier, disables full-duplex operation. /MAPB /MAP=(MULTICAST_ADDRESS=address, FUNCTIONAL_ADDRESS=address)( /NOMAP=(MULTICAST_ADDRESS=address) k= Maps a standard multicast address to a functional address.? Token ring devices do not support IEEE 802 standard globallyC defined group addresses. They do support functional addresses. AB functional address is a locally administered group address thatB has 31 possible values. Each functional address sets one bit inD the third through sixth byte of the address and bytes 1 and 2 are( 03-00 (C0:00 in bit reversed format).? The /NOMAP=(MULTICAST_ADDRESS=address) qualifier,l clears the1 mapping established for the specified address.- Specify the functional address as follows:? o The MULTICAST_ADDRESS argument requires a standard 6-byte multicast address.> o The FUNCTIONAL_ADDRESS argument requires only the last 4@ bytes of the functional address (the preceding 03-00 bytes" are automatically prefixed).@ o The address variable, given as hexadecimal byte characters? separated by hyphens, specifies the canonical form of mtheA address. Use a colon as the separator character to indicate+ the bit-reversed form of the address.A For example, to map the multicast address CB-00-01-02-03-04 toD the functional address 03-00-00-80-00-00 on the Token Ring device% IRA0, enter the following command:B SET DEVICE IRA0/MAP=(MULTI=CB-00-01-02-03-04,FUNCT=00:01:00:00)D For the default address mapping, see the following table or issue+ the command SHOW DEVICE/MAP device-name. n Functional4 Multicast Address Address Description3 09-00-2B-00-00-04 03-00-00-00-02-00 ISO ALL ES3 09-00-2B-00-00-05 03-00-00-00-01-00 ISO ALL IS; CF-00-00-00-00-00 03-00-00-08-00-00 Loopback Assistant: AB-00-00-01-00-00 03-00-02-00-00-00 DNA MOP Dump/Load? AB-00-00-02-00-00 03-00-04-00-00-00 DNA MOP Remote Console7 AB-00-00-03-00-00 03-00-08-00-00-00 DNA L1 Routers7 09-00-2B-02-00-00 03-00-08-00-00-00 DNA L2 RoutersD 09-00-2B-02-01-0A o 03-00-08-00-00-00 DNA Phase IV Primary Router5 AB-00-00-04-00-00 03-00-10-00-00-00 DNA EndnodesC 09-00-2B-02-01-0B 03-00-10-00-00-00 DNA Phase IV Prime Unknown4 Destination? 09-00-2B-00-00-07 03-00-20-00-00-00 PCSA NETBIOS EmulationB 09-00-2B-00-00-0F 03-00-40-00-00-00 LAT Service Advertisement< 09-00-2B-02-01-04 03-00-80-00-00-00 LAT Service Solicit= 09-00-2B-02-01-07 03-00-00-02-00-00 LAT Xwindown Service0 p Solicit- 09-00-2B-04-00-00 03-00-00-04-00-00 LAST9 09-00-2B-02-01-00 03-00-00-00-08-00 DNA Name Service6 AdvertisementA 09-00-2B-02-01-01 03-00-00-00-10-00 DNA Name Service Solicit9 09-00-2B-02-01-02 03-00-00-00-20-00 DNA Time Service9 03-00-00-00-00-01 03-00-00-00-00-01 NETBUI Emulation- 03-00-02-00-00-00 03-00-02-00-00-00 RIPL /MAX_BUFFERS /MAX_BUFFERS=valueA Sets the maximum nuqmber of receive buffers to be allocated and- used by the LAN driver for the LAN device. /MEDIA /MEDIA=value o For Token Ring devices:A Selects the type of cable media used to connect the adapterC to the Token Ring Media Access Unit (MAU) for devices that doC not automatically detect this. Acceptable values for this areC either unshielded twisted pair (UTP) or shielded twisted pair& (STP). The default value is STP. o For Ethernet r devices:C Selects the cable connection. Normally, the selection is made> during device initialization using a limited autosensing@ algorithm that selects twisted pair, but fails over to AUIA (Attachment Unit Interface) if twisted pair does not appearD to be functional. Thereafter, a cabling change would require aB reboot of the system to take effect. This command allows you0 to change the selection without rebooting.? Acceptable values are AUI (1s0Base2, 10Base5), TWISTEDPAIR? (10BaseT), and AUTOSENSE (reperform the limited autosense1 algorithm). The default value is AUTOSENSE.> Some devices, such as the DE435, require a jumper change@ on the Ethernet card to switch between 10Base2 and 10Base5A (thinwire and thickwire). Other devices, such as the DE434,; DE436, and DE500, have only twisted pair connections. /MIN_BUFFERS /MIN_BUFFERS=valueA Sets the minimum number of receive bufferts to be allocated and- used by the LAN driver for the LAN device. /PERMANENTA Reads the permanent database and creates device entries in the volatile database. /PERMANENT_DATABASEA Updates the device entries in the LAN volatile device database> with any data currently set in the permanent database. ThisA allows you to update the volatile database after changing dataD in the permanent database, rather than repeating the commands forD each updated entry uto apply the changes to the volatile database. /PVC /PVC=(vci[,...]) /[NO]PVC=(vci[,...]); Sets the permanent virtual circuit (PVC) to be used by a? Classical IP over ATM client. This is an optional qualifier.B A list of PVCs is defined for use by CLIP clients. This commandD should be used before enabling the CLIP client. The PVC has to be% set up manually in the ATM switch.A The vci is the VCI (Virtual Circuit ID) of the PVC to be used. /RING_vPURGER6 Enables the ring purger process of the FDDI device. /SOURCE_ROUTING /SOURCE_ROUTING (default) /NOSOURCE_ROUTINGD Enables source routing on the Token Ring device. If you only have@ one ring in your LAN or you use transparent bridging, use the: /NOSOURCE_ROUTING qualifier to turn off source routing. /SPEED /SPEED=value Sets the speed of the LAN.> For Token Ring, valid values are either 4 or 16, indicating? 4 megabits per se wcond or 16 megabits per second. The default@ value for Token Ring is 16, unless the LAN adapter supports aD nonvolatile mechanism for setting this parameter (as does the DEC Token Ring Controller 700).A For Ethernet, valid values are either 10 or 100, which selectsC the 10 megabits per second Ethernet port or the 100 megabits perB second Fast Ethernet port. The default for Ethernet is to sense? automatically which type of port is connected and select the appropriate spexed. /SR_ENTRY= /SR_ENTRY=(LAN_ADDRESS=address, RI=routing-information)' /NOSR_ENTRY=(LAN_ADDRESS=address)C Statically defines a specific source-routed route for a specific? node. The default value is no routes specified. This caching= remains valid while used or until the aging timer expires.: Use this qualifier only as a last resort when isolating5 communication failures on extended LAN topologies.> The /NOSR_ENTRY=(LAN_ADDRESS=address) qualifier, yclears the1 previously defined static source routed route.9 The address is a standard 6-byte LAN address (given as; hexadecimal byte characters separated by hyphens), which@ specifies the canonical form of the address. Using a colon asA the separator character indicates the bit-reversed form of the address.D The routing-information is the source routing field, specified asC a series of two-byte hexadecimal characters (each byte separatedA by a hyphen). The field czonsists of a two-byte routing control@ field followed by up to 14 two-byte segment identifiers, eachD containing the ring number and the bridge number used in the hop. /TOKEN_ROTATION< Sets the requested token rotation time for the FDDI ring. /TOKEN_TIMEOUT< Sets the restricted token timeout time for the FDDI ring. /TRANSMIT_TIMEOUT8 Sets the valid transmission time for the FDDI device. /UPDATE> Adds LAN devices that are not currently in the LA {N volatile> device database to that database. The initial entry for the? device uses default values for all parameters. To update the@ volatile database with current information from the permanentD database, use the SET DEVICE command with the /PERMANENT_DATABASEA qualifier. You can combine the /UPDATE and /PERMANENT_DATABASE- qualifiers in a single SET DEVICE command. Examples= 1. LANCP> SET DEVICE/CONTENDER/MEDIA=UTP/NOEARLY/SOURCE ICA0B Enables monitor contentio|n, UTP cable media, source routing and; disables early token release for Token Ring device ICA0.$ 2. LANCP> SET DEVICE/MEDIA=TWI EWB0D Sets the media type to twisted pair for the second Tulip Ethernet device, EWB0.( 3. LANCP> SET DEVICE EXA0/MOPDLL=ENABLEA Enables MOP downline load service for device EXA0, leaving the) remaining MOPDLL parameters unchanged.> 4. LANCP> SET DEVICE EXA0/MOPDLL=(ENABLE,EXCLUSIVE,SIZE=1482)B Enables MOP downline load service for device }EXA0, in exclusive> mode with the data transfer size of 1482 bytes, leaving the) remaining MOPDLL parameters unchanged.6 5. LANCP> SET DEVICE EXA0/MOPDLL=(ENABLE,NOEXCLUSIVE)2 LANCP> SET DEVICE FXA0/MOPDLL=(ENABLE,EXCL,KNOWN)> These commands enable LANACP MOP downline load service for:* o LAN device EXA0 in nonexclusive mode> o LAN device FXB0 in exclusive mode for only known clients 2 NODEC Enters a node into the LAN volatile node database or modifies an- e~xisting entry. Requires SYSPRV privilege. Format SET NODE node-name 3 Parameter node-nameC Supplies the name of a node to be added to the LAN volatile nodeC database or an entry to be modified. Typically, the node name isA the same as that given in the system parameter SCSNODE, but itD does not need to be. The node name is limited to 63 characters in length. 3 Qualifiers /ADDRESS /ADDRESS=node-address /NOADDRESS (de fault)C Associates a LAN address with the node name. Specify the address@ as 6 bytes in hexadecimal notation, separated by hyphens. TheD address does not have to be unique (as might be the case when the@ address is not known, so a nonexistent address is specified).D If multiple node addresses are to be associated with a node name,B each combination may be given as a node name with an extension,@ for example, VAXSYS.EXA for the EXA device on node VAXSYS, or4 VAXSYS_1 for th€e first LAN device on node VAXSYS.D If you do not specify the /ADDRESS qualifier, the setting remains8 unchanged. The /NOADDRESS qualifier clears the field. /ALL@ Defines data for all nodes in the LAN volatile node database.C If you specify a node name, all matching nodes are selected; for5 example, A/ALL selects all nodes beginning with A. /BOOT_TYPE /BOOT_TYPE=boot-option /NOBOOT_TYPE> Indicates the type of processing required for downline load ? requests. You can specify one of the following keywords with this qualifier:0 o VAX_SATELLITE-a VAX satellite cluster boot5 o ALPHA_SATELLITE-an Alpha satellite cluster bootC o OTHER-the specified image; noncluster satellite loads that do! not require additional dataB The distinction is necessary, because OpenVMS Cluster satelliteC loads require additional cluster-related data be appended to the@ load image given by the /FILE qualifier. The default valu‚e is OTHER.> If you do not specify the /BOOT_TYPE qualifier, the settingB remains unchanged. The /NOBOOT_TYPE qualifier clears the field. /DECNET_ADDRESS /DECNET_ADDRESS=value /NODECNET_ADDRESS> Associates a DECnet address with the node name. Specify the' address in DECnet notation, xx.xxxx.B If you do not specify the /DECNET_ADDRESS=value qualifier, thenA the setting remains unchanged. The /NODECNET_ADDRESS qualifier clears the field. ƒ/FILE /FILE=file-spec /NOFILE< Supplies the file name of a boot file to be used when theC downline load request does not include a file name (for example,@ OpenVMS Cluster satellite booting). The file specification is limited to 127 characters.@ If no file name is specified, OpenVMS Cluster satellite loadsD default to APB.EXE where the boot type is set to ALPHA and NISCS_. LOAD.EXE where the boot type is set to VAX.A If you do not specify the /FILE„ qualifier, the setting remains5 unchanged. The /NOFILE qualifier clears the field. /IP_ADDRESS /IP_ADDRESS=value /NOIP_ADDRESSC Associates an IP address with the node name. Specify the address4 in the standard dotted notation, xxx.xxx.xxx.xxx.= If you do not specify the /IP_ADDRESS=value qualifier, the@ setting remains unchanged. The /NOIP_ADDRESS qualifier clears the filed. /PERMANENT_DATABASEB Updates the node entries in the LAN vol…atile node database with@ any data currently set in the permanent database. This allowsA you to update the volatile database after changing data in theB permanent database, rather than repeating the commands for each? updated entry to apply the changes to the volatile database. /ROOT# /ROOT=directory-specification /NOROOTA Supplies the directory specification to be associated with the@ file name. For cluster satellite service, the /ROOT qualifierB spe†cifies the satellite root directory. For noncluster service,A this qualifier specifies the location of the file. If the fileD specification or the file name given in the boot request includes? the directory name, this qualifier is ignored. The directory. specification is limited to 127 characters.A If you do not specify the /ROOT qualifier, the setting remains5 unchanged. The /NOROOT qualifier clears the field. /SIZE /SIZE=value /NOSIZE? Specifies‡ the size in bytes of the file data portion of each; downline load message. The default is the load data size? specified for the device. The permitted range is 246 to 1482@ bytes. Use a larger size for better load performance and less server overhead.A If you do not specify the /SIZE qualifier, the setting remains7 unchanged. The /NOSIZE qualifier clears the setting. /V3 /V3 /NOV3A Indicates that only MOP Version 3 formatted messages are to be ˆ? used for downline load purposes, regardless of the requestedC format. This allows systems to load that have a problem with MOPB Version 4 booting. This qualifier causes the requesting node toA fail over from MOP Version 4 to MOP Version 3 when no response1 has been made to a MOP Version 4 load request.? If you do not specify the /V3 qualifier, the setting remains5 unchanged. The /NOV3 qualifier clears the setting. 3 Examples7 1.LANCP> SET NODE VAXSYS/ADDRES ‰S=08-00-2B-11-22-33 -* /FILE=APB.EXE -5 /ROOT=$64$DIA14: -5 /BOOT_TYPE=ALPHA_SATELLITE= This command sets up node VAXSYS for booting as an Alpha satellite into the cluster.7 The APB.EXE file is actually located on $64$DIA14:B . Note that the isB supplied by the LANACP LAN Server process and is not included in the root definition. Š7 2.LANCP> SET NODE VAXSYS/ADDRESS=08-00-2B-11-22-33 -1 /FILE=NISCS_LOAD.EXE -5 /ROOT=$64$DIA14: -3 /BOOT_TYPE=VAX_SATELLITED This command sets up node VAXSYS for booting as a VAX satellite into the OpenVMS Cluster.> The NISCS_LOAD.EXE file is actually located on $64$DIA14:A . The is supplied@ by the LANACP LAN Server process and is n‹ot included in the root definition.< 3.LANCP> SET NODE VAXSYS/ADDRESS=08-00-2B-11-22-33/NOROOT> This command changes the LAN address associated with node6 VAXSYS and clears the current root specification.? 4.SET NODE CALPAL/ADDRESS=08-00-2B-11-22-33/FILE=APB_061.EXE? This command sets up node CALPAL for booting an InfoServerA image. It defines the file that should be loaded when a load< request without file name is received from node CALPAL.A BecŒause the file does not include a directory specification,C the logical name LAN$DLL defines where to locate the file. YouA could give directory specification using the file name or by using the /ROOT qualifier.> Note that specifying the file name explicitly in the bootC command overrides the file name specified in the node database entry. ww­pŽßI‘Ÿ1 SHOW 2 CONFIGURATIOND Displays a list of LAN devices and characteristics on the" system. Format SHOW CONFIGURATION 3 Parameters None. 3 Qualifiers /OUTPUT /OUTPUT=file-name7 Creates the specified file and directs output to it. /USERSC On Alpha systems, shows which protocols are using which template device. 3 Example LANCP> SHOW CONFIGURATION LAN Configuration:6 Device Medium Default LAN Address Version6 ------ ------ ------------------- -------7 EWA0 CSM ŽA/CD 08-00-2B-E4-00-BF 020000237 EWB0 CSMA/CD 08-00-2B-92-A4-0D 020000237 IRA0 Token Ring 00-00-93-58-5D-32 20000223D This example shows the output from a SHOW CONFIGURATION command? that was entered on a node that has three LAN devices, two DE435s, and a DETRA.= The version is the device-specific representation of the@ actual (hardware or firmware) version. In this example, forA two devices on the PCI bus, the actual version is in the lowC byte (2.3 for the DE435 adapters). A device that does not have1 a readable version is shown as version zero.< Consult your device-specific documentation to correlate@ the version returned with a particular hardware or firmware" implementation of the device. 2 DEVICE? Displays information in the volatile device database. If the@ LANACP process is not running, displays a list of current LAN devices. Format SHOW DEVICE device-name 3 Parameter device-name? Supplies the LAN controller device name. The device name hasA the form ddcu where dd is the device code, c is the controllerC designation, and u is the unit number. LAN devices are specifiedC as the name of the template device which is unit 0. For example,C the first DE435 Ethernet device is specified as EWA0, the second as EWB0.@ For example, you can specify a DEMNA controller as EXA, EXA0,A or EXA0:. This refers t ‘o the LAN template device, for which is? maintained most of the device parameters and counters. Also,= the device name can refer to a device unit representing anA actual user or protocol. For example, the cluster protocol canB be started on a device as EWA1. You can specify specific device5 units to view unit-specific parameter information.B If you do not specify a device name, all devices are displayed.= If you specify a device name, all matching LAN devices are> dis’played, for example: E to select all Ethernet devices, FB for FDDI, I for Token Ring, EW to select all Ethernet PCI Tulip devices.& NOTEA If you do not specify a qualifier, the utility displays the6 matching devices without additional information. 3 Qualifiers /ALL, Shows all devices that match device name. /CHARACTERISTICS7 On Alpha systems, same as the /PARAMETERS qualifier. /COUNTERS Displays #“device counters. /DLLC Displays LAN volatile device database information related to MOP downline load for the device. /MAP? Displays the current configuration of the functional address mapping table. /MOPDLL Same as the /DLL qualifier. /OUTPUT /OUTPUT=file-name7 Creates the specified file and directs output to it. /PARAMETERS< Displays status and related information about the device. /REVISION; Displays ”the current firmware revision of the device, if? available or applicable. Not all LAN devices return revisionA information. LAN devices that do not have a revision display a revision of zero. /SR_ENTRYA Displays the contents of the current Token Ring source routing cache table. 3 Examples% 1.LANCP> SHOW DEVICE/COUNTERS EXA0 Device Counters EXA0: Value Counter ----- -------2 259225 Seconds s •ince last zeroed- 5890496 Data blocks received2 4801439 Multicast blocks received( 131074 Receive failure' 764348985 Bytes received1 543019961 Multicast bytes received% 3 Data overrun) 1533610 Data blocks sent6 115568 Multicast packets transmitted9 122578 Blocks sent, multiple collisions6 86000 Blocks sent, single collisi–on8 189039 Blocks sent, initially deferred# 198120720 Bytes sent4 13232578 Multicast bytes transmitted% 7274529 Send failure7 0 Collision detect check failure7 0 Unrecognized frame destination2 0 System buffer unavailable0 0 User buffer unavailable= This command displays counters for Ethernet device EXA0. 2.LANCP> SHOW DEV —ICE/MAP ICA02 Multicast to Functional Address Mapping ICA0:= Multicast address Functional Address Bit-Reversed= ----------------- ------------------ ------------B 09-00-2B-00-00-04 03-00-00-00-02-00 C0:00:00:00:40:00B 09-00-2B-00-00-05 03-00-00-00-01-00 C0:00:00:00:80:00B CF-00-00-00-00-00 03-00-00-08-00-00 C0:00:00:10:00:00B AB-00-00-01-00-00 03-00-02-00-00-00 C0:00:40:00:00:00B AB-00-00-02-00-00 03-00-04-0 ˜0-00-00 C0:00:20:00:00:00B AB-00-00-03-00-00 03-00-08-00-00-00 C0:00:10:00:00:00B 09-00-2B-02-00-00 03-00-08-00-00-00 C0:00:10:00:00:00B 09-00-2B-02-01-0A 03-00-08-00-00-00 C0:00:10:00:00:00B AB-00-00-04-00-00 03-00-10-00-00-00 C0:00:08:00:00:00B 09-00-2B-02-01-0B 03-00-10-00-00-00 C0:00:08:00:00:00B 09-00-2B-00-00-07 03-00-20-00-00-00 C0:00:04:00:00:00B 09-00-2B-00-00-0F 03-00-40-00-00-00 C0:00:02:00:00:00B™ 09-00-2B-02-01-04 03-00-80-00-00-00 C0:00:01:00:00:00B 09-00-2B-02-01-07 03-00-00-02-00-00 C0:00:00:40:00:00B 09-00-2B-04-00-00 03-00-00-04-00-00 C0:00:00:20:00:00B 09-00-2B-02-01-00 03-00-00-00-08-00 C0:00:00:00:10:00B 09-00-2B-02-01-01 03-00-00-00-10-00 C0:00:00:00:08:00B 09-00-2B-02-01-02 03-00-00-00-20-00 C0:00:00:00:04:00B 03-00-00-00-00-01 03-00-00-00-00-01 C0:00:00:00:00:80B 03-00-02-00-00-00 03 š-00-02-00-00-00 C0:00:40:00:00:00D This command displays mapping information for Token Ring device ICA0. 3.LANCP> SHOW DEVICE/MOPDLL' Device Listing, volatile database:D --- MOP Downline Load Service Characteristics ---G Device State Access Mode Clients Data SizeG ------ ----- ----------- ------- ---------H EXA0 Enabled Exclusive KnownClientsOnly 1400 bytesH FXA0 › Disabled NoExclusive NoKnownClientsOnly 246 bytesC This command displays MOP downline load information in the LAN4 volatile device database for all known devices.# 4.LANCP> SHOW DEVICE/MOPDLL EXA0' Device Listing, volatile database:D --- MOP Downline Load Service Characteristics ---G Device State Access Mode Clients Data SizeG ------ ----- ----------- ------- ---------H EXA0 œEnabled Exclusive KnownClientsOnly 1400 bytesC 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 med ium0 Enabled Functional address mode+ No Full duplex enable0 No Full duplex operational5 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 routing3 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 FXA0$ Device revision FXA0: 05140823? This command displays revision information for FDDI device FXA0.% 7.LANCP> SHOW DEVICE/SR_ENTRY ICA0% Source Routing Cache ŸTable ICA0:G LAN address State XmtTmo RcvTmo StaleTmo DiscvTmoG ----------------- ----- -------- -------- -------- --------G AA-00-04-00-92-FF LOCAL 00000028 00000028 00000245 00000000? This command displays source routing entry information for Token Ring device ICA0. 2 DLLC Displays the current state of MOP downline load services for theA system, including devices for which MOP loading is enabled and counters informat! ion. Format SHOW DLL 3 Parameters None. 3 Qualifier /OUTPUT /OUTPUT=file-name7 Creates the specified file and directs output to it. 3 Example LANCP>SHOW DLL LAN DLL Status:5 EXA enabled in exclusive mode for known nodes only, data size 1482 bytes FXA disabledC #Loads Packets Bytes Last load time Last loadedD ------ ------- ----- -------------------- ------------@ EXA ¡ 5 1675 4400620 22-SEP-2000 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.A Requests are answered only for nodes that are defined in theC LANACP node database. The image data size in the load messagesA is 1482 bytes. There have been five downline loads, the lastA one occurring on node GALAXY at 10:27. Finally, t!¢here are noA recorded downline loads for FXA, which is currently disabled for downline load service. 2 LOGA 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 3 Parameters None. 3 Qualifier /OUTPUT /OUTPUT=file-name7 Creates the specified file and directs output to it. 3 Example LANCP> SHOW LOGB This comman£d displays the last 2048 bytes of log data written- to the log file SYS$MANAGER:LAN$ACP.LOG. 2 NODE: Displays information in the LAN volatile node database. Format SHOW NODE node-name 3 Parameter node-nameB Specifies the name of a node in the LAN volatile node database.? The name can include up to 63 characters associated with theA node address. If you do not specify a node name, all nodes are displayed. 3 Qualifiers ¤/ALL> Displays information for all nodes in the LAN volatile node? database. If you specify a node name, all matching nodes areC selected; for example, A/ALL selects all nodes beginning with A. /OUTPUT /OUTPUT=file-nameA Creates the specified file and directs output to that file. IfB the file extension is .com, the output is in the form of a listB of DEFINE NODE or SET NODE commands. The resulting command file0 can be used to create the LAN node databases.¥ /TOTAL7 Display counter totals only, for the nodes selected. 3 Examples 1.LANCP> SHOW NODE Node Listing: GALAXY (08-00-2B-2C-51-28):! MOP DLL: Load file: APB.EXE, Load root: $64$DIA24:) Boot type: Alpha satellite ZAPNOT (08-00-2B-18-7E-33):( MOP DLL: Load file: NISCS_LOAD.EXE1 Load root: LAVC$SYSDEVICE:' Boot type: VAX satellite CALPAL (08-00-2B-08-9¦F-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 failedD Last request was for a system image, in MOP V4 format7 Last load initiated 10-JUN-1998 09:11:17* on EXA0 for 00:00:06.65> 527665 bytes, 4161 packets, 0 transmit failures! Unnamed (00-00-00-00-00-00): Total§s: 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 10-JUN-1998 09:11:17.29D This example shows output from a command issued on a local node@ on which there are three nodes defined (GALAXY, ZAPNOT, and2 CALPAL). CALPAL has issued tw¨o load requests:C o The first request is the multicast request from CALPAL that- the local node volunteered to accept.C o The second request is the load request sent directly to theB local node by CALPAL for the actual load data. The elapsedC time from the second load request to completion of the load was 6.65 seconds. 2.LANCP> SHOW NODE VAXSYSD Displays node characteristics and counters information from the0 LAN volatile node dat©abase for node VAXSYS. 3.LANCP> SHOW NODE/ALL VAXD Displays node characteristics and counters information from theD LAN volatile node database for all nodes whose name begins with VAX. 4.LANCP> SHOW NODE/ALLD Displays node characteristics and counters information from the. LAN volatile node database for all nodes.( 5.LANCP> SHOW NODE/ALL/OUTPUT=TMP.INI4 Writes a list of all nodes to the file TMP.INI. ww­O}‘ßI‘Ÿ1 SPAWNA Cªreates a subprocess of the current process. The SPAWN commandA copies the context of the subprocess from the current process. Format SPAWN [command-string] 2 Parameter command-stringD A string of commands to be executed in the context of the createdD subprocess. After the command string is executed, control returns to LANCP. 2 Qualifiers None. 2 Example LANCP> SPAWN $ MC LANCP5 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 "5 LANCP> DEFINE NODE BOOM/ROOT=LAVC$SYSDEVICE:D In this example, you enter the node information for a node, butA are unsure of the root, so you spawn to search MODPARAMS.DAT1 for the node name and then correct the root. ww­O}‘ßI‘Ÿ 1 TRIGGER 2 NODE/ Issues a reques¬t to reboot to a remote node.A 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 3 Parameter node-specificationB Supplies either the node name or the node address of the targetB node. If you supply the node name, the node address is obtainedD by looking up the node name in the LAN volatile node database. IfB you supply the ­node address, the corresponding node need not beC defined in the LAN volatile node database. The canonical form ofB the address consists of 6 hexadecimal byte characters separatedA by hyphens. Use a colon as the separator character to indicate( the bit-reversed form of the address. 3 Qualifiers /DEVICE /DEVICE=device-nameB Specifies the LAN controller device name to be used for sendingB the trigger boot messages. For example, you can specify a DEMNA$ ® controller as EXA, EXA0 or EXA0:. /PASSWORD /PASSWORD=16hexdigits7 Supplies the password to be used when the connection- is initiated, in hexadecimal (for example,A /PASSWORD=0123456789ABCDEF). The default password is zero. You can omit leading zeros. 3 Examples+ 1.LANCP> TRIGGER NODE GALAXY/DEVICE=EWA0@ This command sends MOP trigger boot messages to node GALAXY using Ethernet device EWA0.L 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.ww