% Librarian I01-47&fAHHHD5,@~BANNERCLEARhCommandsCONNECT#CONVERT%DEFINE..EXIT/tHELP/jLIST<PURGEBSET.SHOWSPAWNSTARTTRIGGER:UPDATE Usage_SummaryWAITFFH1 Usage_SummaryJ To invoke LANCP, enter the following command at the DCL command prompt: prompt: $ RUN SYS$SYSTEM:LANCPK The LANCP utility displays the LANCP> prompt, at which you can enter any LANCP command described here.I To define LANCP as a foreign command, either at the DCL prompt or in a( startup or login command file, enter: $ LANCP :== $SYS$SYSTEM:LANCPG Then you can enter the LANCP command at the DCL prompt to invoke the$ utility and enter LANCP commands.$ When you enter the LANCP command:K o If you don't specify a command, the LANCP utility displays the LANCP>. prompt, at which you can enter commands.I o If you do specify a command, the LANCP utility executes the command, and returns to the DCL command prompt.! NOTE= Some LANCP commands require SYSPRV or PHY_IO privilege.G To exit from the LANCP utility, enter the EXIT command at the LANCP> prompt or press Ctrl/Z.< To get help, enter the HELP command at the LANCP> prompt.wwFFH 1 Commands5 The following table summarizes the LANCP commands:' Command FunctionC @ (File specification) Reads and executes commands from the. specified file.? CLEAR DEVICE Deletes device data from the LAN8 volatile device database.H CLEAR DLL or CLEAR MOPD LL Clears MOP downline load counters for all1 nodes and devices.H CLEAR NODE Deletes a node from the LAN volatile node( database.L CONNECT NODE Connects to a remote node, such as a terminalJ server, that implements a console interfaceF using the MOP console carrier protocol.I CONVERT DEVICE_DATABASE Converts the device databas e to the formatH required by the current version of LANCP.G CONVERT NODE_DATABASE Converts the node database to the formatH required by the current version of LANCP.E DEFINE DEVICE Enters a device into the LAN permanentF device database or modifies an existing% entry.C DEFINE NODE Enters a node into the LAN permanentD node database or modifies an existing% entry.E EXIT Stops LANCP, returning control to DCL.C HELP Provides help for the LANCP utility.H LIST BANDWIDTH Displays bandwidth monitoring settings inA the LAN permanent device database.H LIST DEVICE Displays information in the LAN permanent/ devic e database.I LIST DLL or LIST MOPDLL Displays MOP downline load settings in the= LAN permanent device database.H LIST FAILOVER or LIST LLAN Displays LAN Failover settings in the LAN9 permanent device database.H LIST NODE Displays information in the LAN permanent- node database.H LIST PTP (Future release, not currently supported)N Displays Precision Time Protocol (PTP) settingsD in the LAN permanent device database.G LIST TRACE Displays LAN tracing settings in the LAN9 permanent device database.D LIST TEST Displays LAN test settings in the LAN9 permanent device database.H LIST ULAN (Future release, not currently supported)I Displays UDP LAN pseudo devices in the LAN9 permanent device database.J LIST VLAN Displays VLAN LAN pseudo devices in the LAN9 permanent device database.I PURGE DEVICE Deletes device data from the LAN permanent/ device database.G PURGE NODE Deletes node data from the LAN permanent- node database.G SET ACP Modifies the operation of the LANACP LAN. Server process.K SET DEVICE Enters a device into the LAN volatile deviceI database or modifies an existing entry and6 sets device parameters.G SET NODE Enters a node into the LAN volatile nodeF database or modifies an existing entry.F SHOW ACP  Displays currently set LANCP and LANACP' options.D SHOW CONFIGURATION Displays a list of LAN devices on the& system.G SHOW DEVICE Displays LAN device information from theH LAN volatile device database and from the5 requested LAN devices.G SHOW DLL or SHOW MOPDLL Displays the status of MOP downline load<  services, state and counters.= SHOW LOG Displays the LAN$ACP.LOG file.G SHOW NODE Displays information in the LAN volatile- node database.G SHOW TEST Displays LAN device information from theG LAN volatile device database for current+ test status.K SPAWN Creates a subprocess of the current process.= START DEVICE Starts a test on a LAN device.H TRIGGER NODE Issues a reboot request to a remote node.F UPDATE DEVICE Updates a device, specifically to issueD a reset request to the device driver.wwVFH1 @F Executes a command procedure or requests the command interpreter to@ read subsequent command input from a specific file or device. Format @filespec 2 ParameterfilespecK Specifies either the input device or the file for the preceding command,+ or the command procedure to be executed. 2 Qualifiers None. 2 Example $ CREATE COUNT.COM SHOW DEVICE/COUNTERS EIA WAIT 60 @COUNT  $ RUN SYS$SYSTEM:LANCP LANCP> @COUNT Device Counters EIA0: Value Counter ----- -------% 62030 Seconds since last zeroed 19910982 Bytes received 239192 Bytes sent 155812 Packets received 4348 Packets sent$ 19910982 Multicast bytes received 239140 Multicast bytes sent& 155812 Multicast packets received" 4346 Multicast packets sent4 0 Unrecognized unicast destination packets6 134311 Unrecognized multicast destination packets' 0 Unavailable station buffers$ 0 Unavailable user buffers 0 Alignment errors 0 Frame check errors 0 Frame size errors 0 Frame status errors  0 Frame length errors! 0 Frame too long errors 0 Data overruns# 0 Send data length errors& 0 Receive data length errors$ 0 Transmit underrun errors 0 Transmit failures" 0 Carrier check failures 0 Station failures+ 0 Initially deferred packets sent) 0 Single collision packets sent+ 0 Multiple collision packets sent 0 Excessive collisions 0 Late collisions+ 0 Collision detect check failures9 1 Link up transitions (02-FEB-2019 07:25:00.00)! 0 Link down transitions/ None Time of last generic transmit error. None Time of last generic receive errorI This example creates and runs a command procedure, COUNT.COM, that2 displays EIA device counters once a minute.wwVFH1 BANNERJ Displays the current date and time followed by any text from the rest ofJ the command line. This is useful in command files to record the time and additional text. Format BANNER BANNER text 2 Parametertext; The rest of the input line, enclosed in quotes if needed.wwVFH1 CLEAR 2 DEVICE= Deletes device data from the LAN volatile device database. Format CLEAR DEVICE device-nameC If no qualifier is present to select the type of data to delete,0 all settings in the device entry are deleted. 3 Parameter device-nameJ Specifies the LAN device name. The device name has the form ddcu, whereI dd is the device identifier, c is the controller designation, and u is the unit number.I LAN devices are specified as the name of the template device, which isJ unit 0. For example, the first EI Ethernet device is specified as EIA0,J the second as EIB0, and so on. You can specify the first EI device, for# example, as EIA, EIA0, or EIA0:.H A partial device name, accompanied by the /ALL qualifier, selects allI matching devices. For example: E to select all Ethernet devices, V forE VLAN devices, EI for Ethernet EI devices, no device name to select all LAN devices. 3 Qualifier/ALLH Deletes requested data for all LAN devices in the LAN volatile deviceK database. If you specify a device name, data is deleted for all matchingD devices; for example, EI/ALL deletes data for all EI LAN devices. /BANDWIDTHD Deletes device settings for bandwidth monitoring and disables the monitoring./CHARACTERISTICS" /CHARACTERISTICS or /PARAMETERSC Deletes device characteristics settings for the LAN device, from@ the LAN volatile device database. The settings include speed,= duplex mode, LAN Failover device settings and other device@ parameters. Clearing these characteristics does not directly? affect the LAN device, but clearing these is done for future use./DLL /DLL or /MOPDLL< Deletes MOP downline load settings for the LAN device and) disables MOP downline load if enabled./PTP, (Future release, not currently supported)+ Deletes PTP settings for the LAN device./TESTB Deletes test context for the LAN device. Clearing this contextF does not directly affect the test functionality for the LAN device,, but clearing this is done for future use./TRACE? Deletes driver tracing settings for the LAN device and stops tracing on the device. 3 Example% LANCP> CLEAR DEVICE EIA0/BANDWIDTHE This command deletes bandwidth monitoring settings for device EIA0A from the LAN volatile device database. The bandwidth qualifierC selects the bandwidth settings to delete and turns off bandwidth monitoring for the device.2 DLL> This command clears MOP downline load counters from the LAN@ volatile device and node databases for all nodes and devices. Format CLEAR DLL or CLEAR MOPDLL 3 Parameters None. 3 Qualifiers None. 3 Example LANCP> CLEAR DLL> This command clears MOP downline load counters from the LAN& volatile device and node databases.2 NODE6 Deletes a node from the LAN volatile node database. Format CLEAR NODE node-name 3 Parameter node-name= Specifies the node name 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 deleted; for= example, A/ALL deletes all nodes whose name begins with A. 3 Example LANCP> CLEAR NODE VMSSYSB This command deletes the node VMSSYS from the LAN volatile node database.wwfFH 1 CONNECT2 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 Parameternode-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 beB defined in the LAN volatile node database. The address consistsC of 6 hexadecimal byte characters separated by hyphens or colons. 3 Qualifiers/DEVICE /DEVICE=device-nameC Specifies the LAN device name to be used for the connection. TheD device name has the form ddcu, where dd is the device identifier,= c is the controller designation, and u is the unit number.I LAN devices are specified as the name of the template device, which isJ unit 0. For example, the first EI Ethernet device is specified as EIA0,J the second as EIB0, and so on. You can specify the first EI device, for# example, as EIA, EIA0, or EIA0:. /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. /INPUTFILE /INPUTFILE=filename> Supplies command input from the specified input file. Input> is taken up to end-of-file or a disconnect character. If noC disconnect character is encountered, the command input continues? fro m the local terminal. If a local terminal does not exist-? that is, this command is executing in batch mode-end-of-file. disconnects the console carrier connection. /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 ma!ke 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 Vers "ion 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.E 3 LANCP> CONNECT NODE TERM_SRV/DEVICE=EWA0/INPUT=LOGOUT_PORT_3.COM? $ This command attempts a console-carrier connection to nodeI TERM_SRV to send the contents of the command file LOGOUT_PORT_3.COM.wwfFH 1 CONVERT2 DEVICE_DATABASE@ Converts the device database to the format required by LANCP.B If the database is not updated, LANCP can read the database but@ would not convert an entry in it unless the entry is changed.D The conversion is necessary when the contents of the device entryB change from one OpenVMS release t%o the next. Usually, LANCP and3 LANACP automatically update entries as required. Format CONVERT DEVICE_DATABASE 3 Parameters None. 3 Qualifiers None.2 NODE_DATABASEA Converts the node database to the format required by LANCP. If? the database is not updated, LANCP can read the database but@ would not convert an entry in it unless the entry is changed.B The conversion is necessary when the contents of the node entryC changes from one OpenVMS re&lease to the next. Usually, LANCP and3 LANACP automatically update entries as required. Format CONVERT NODE_DATABASE 3 Parameters None. 3 Qualifiers None.wwv GH 1 DEFINE 2 DEVICE< Enters a device into the LAN permanent device database or% modifies an existing device entry. Format DEFINE DEVICE device-name& QUALIFIERS= See the SET DEVICE command for a list of qualifiers and; ' the description of each. Except where noted, the only< difference is that DEFINE DEVICE applies to entries in@ the LAN permanent device database rather than the volatile device database. 3 Parameter device-nameJ Specifies the LAN device name. The device name has the form ddcu, whereI dd is the device identifier, c is the controller designation, and u is the unit number.I LAN devices are specified as the name of the template device, which isJ unit (0. For example, the first EI Ethernet device is specified as EIA0,J the second as EIB0, and so on. You can specify the first EI device, for# example, as EIA, EIA0, or EIA0:.H A partial device name, accompanied by the /ALL qualifier, selects allI matching devices. For example: E to select all Ethernet devices, V forE VLAN devices, EI for Ethernet EI devices, no device name to select all LAN devices. 3 Examples5 1 LANCP> DEFINE DEVICE EIA0/DLL=(ENABLE,EXCLUSIVE)> ) This command defines LAN device EIA0 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.- 2 LANCP> DEFINE DEVICE/ALL/DLL=NOEXCLUSIVEC This command sets all 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.) QUALIFIERS? See the SET NODE command for a list of qualifiers and theB description of each. Except wh+ere noted, the only differenceA is that DEFINE NODE applies to entries in the LAN permanent; node database rather than the volatile node database. Format DEFINE NODE node-name 3 Parameter node-name> Specifies the node name in the LAN permanent node database.I When entering a new node, you can use the system node name recorded inI the system parameter SCSNODE, or another name limited to 63 characters in length. 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_SATELLITEH This command sets up node GALAXY in the LAN permanent node database< for booting as a VAX satellite into an OpenVMS Cluster.J The NISCS_LOAD.EXE file is actually located in the expanded directoryK $64$DIA14:. The is suppliedE by the LANACP L -AN Server process and is not included in the root definition.: 2 LANCP> DEFINE NODE ZAPNOT/ADDRESS=08:00:2B:11:22:33 -& /FILE=APB.EXE -1 /ROOT=$64$DIA14: -1 /BOOT_TYPE=ALPHA_SATELLITEG This command sets up node ZAPNOT for booting as an Alpha satellite into an OpenVMS Cluster.C The APB.EXE file is actually located in the expanded directoryK $64$DIA14:. The is suppliedE by the LANACP LAN Server process and is not included in the root definition.: 3 LANCP> DEFINE NODE CALPAL/ADDRESS=08:00:2B:11:22:33 -( /FILE=APB_061.EXEI This command sets up node CALPAL for booting an InfoServer image. ItI defines the file that should be loaded when a load request without a, file name is received from node CALPAL.E Because the file does not include a directory specification, theC logic /al name LAN$DLL defines the location. You can include theC directory specification in the file name or by using the /ROOT qualifier.F Note that specifying the file name explicitly in the boot commandB overrides the file name specified in the node database entry.wwv GH1 EXITB Stops execution of LANCP and returns control to the DCL commandB level. You can also enter Ctrl/Z at any time to exit, or Ctrl/C= followed by the STOP command to terminate)0 LANCP execution. Format EXIT 2 Parameters None. 2 Qualifiers None.wwv GH1 HELP< Provides online help information about the LANCP utility. Format HELP [topic] 2 Parametertopic6 Specifies a subject for which you want information. 2 Qualifiers None.wwv GH1 LIST 2 BANDWIDTH> Displays bandwidth monitoring settings in the LAN permanent device database. Format 1 LIST BANDWIDTH 3 Parameters None. 3 Qualifier /OUTPUTFILE /OUTPUTFILE=filespec/ Writes command output to the specified file. 2 DEVICE= Displays information in the LAN permanent device database. Format LIST DEVICE device-name 3 Parameter device-nameJ Specifies the LAN device name. The device name has the form ddcu, whereI dd is the device identifier, c is the controller designation, and u is the unit number.I LAN devic2es are specified as the name of the template device, which isJ unit 0. For example, the first EI Ethernet device is specified as EIA0,J the second as EIB0, and so on. You can specify the first EI device, for# example, as EIA, EIA0, or EIA0:.H A partial device name selects all matching devices. For example: E toF select all Ethernet devices, V for VLAN devices, EI for Ethernet EI5 devices, no device name to select all LAN devices. 3 Qualifiers/ALLG Lists all matchin3g LAN devices in the LAN permanent device database.9 If no device name is provided, all devices are listed.< LIST and SHOW commands implicitly include this qualifier. /BANDWIDTH3 Lists BANDWIDTH monitoring settings for devices./CHARACTERISTICS" /CHARACTERISTICS or /PARAMETERS Lists device characteristics./DLL /DLL or /MOPDLL' Displays MOP downline load settings. /FAILOVER /FAILOVER or /LLAN" Displays LAN Failover settings. /OUTPUTFIL 4E /OUTPUTFILE=filespec/ Writes command output to the specified file./PTP, (Future release, not currently supported)" Lists PTP settings for devices./TEST1 Lists test characteristics set for each device./TRACE5 Lists driver trace parameters set for each device./ULAN, (Future Release, not currently supported)- Lists UDP LAN devices and characteristics./VLAN* Lists VLAN devices and characteristics. 3 Examples 1 LANCP> LIST 5 DEVICE/DLL) Device Listing, permanent database:A --- MOP Downline Load Service Characteristics ---D Device State Access Mode Clients Data SizeD ------ ----- ----------- ------- ---------E EIA0 Enabled Exclusive KnownClientsOnly 1400 bytesE EWA0 Disabled NoExclusive NoKnownClientsOnly 246 bytesC This command displays MOP downline load information in the LAN5 permanent device 6database for all known devices.2 NODEJ Displays information in the LAN permanent node database, especially MOP downline load information. Format LIST NODE node-name 3 Parameter node-nameC Specifies the name of a node in the LAN permanent node database.D A partial node name selects all matching nodes. For example: A toF select all nodes starting with A, no node name to select all nodes. 3 Qualifiers/ALL? Lists all matching nodes in the L7AN permanent node database.5 If no node name is provided, all nodes are listed.< LIST and SHOW commands implicitly include this qualifier./COMFILE /COMFILE=filespecD Writes command output to the specified file in the form of a listE of DEFINE NODE commands. The resulting command file can be used to" populate the LAN node database. /OUTPUTFILE /OUTPUTFILE=filespec/ Writes command output to the specified file. 3 Example LANCP> LIST NODE Nod8e 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.EXE2 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.9 2 loads requested, 1 volunteered# 1 succeeded, 0 failedC Last request was for a system image, in MOP V4 format6 Last load initiated 10-JUN-2018 09:11:17) on EIA0 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 sen:t 2080 Packets received 2081 Bytes sent 523481 Bytes received 4184; Last load CALPAL at 10-JUN-2018 09:11:17.29H This example shows output from a LIST NODE command issued on a systemK with three nodes defined (GALAXY, ZAPNOT, and CALPAL). CALPAL has issued two load requests:F o The first request is the multicast request from CALPAL that this# system volunteered to accept.I o The second request is the load r;equest sent directly to this systemJ by CALPAL for the actual load data. The elapsed time from the second> load request to completion of the load was 6.65 seconds.2 PTP, (Future release, not currently supported): Lists PTP settings settings in the LAN permanent device database. Format LIST PTP 3 Parameters None. 3 Qualifier /OUTPUTFILE /OUTPUTFILE=filespec/ Writes command output to the specified file.2 TEST2 Lists tes'<t settings in the LAN permanent device database. Format LIST TEST 3 Parameters None. 3 Qualifier /OUTPUTFILE /OUTPUTFILE=filespec/ Writes command output to the specified file.2 TRACE3 Lists trace settings in the LAN permanent device database. Format LIST TRACE 3 Parameters None. 3 Qualifier /OUTPUTFILE /OUTPUTFILE=filespec/ Writes command output to the specified file.2 ULAN5 Lists UDP L(=AN settings in the LAN permanent device database. Format LIST ULAN 3 Parameters None. 3 Qualifier /OUTPUTFILE /OUTPUTFILE=filespec/ Writes command output to the specified file.2 VLAN2 Lists VLAN settings in the LAN permanent device database. Format LIST VLAN 3 Parameters None. 3 Qualifier /OUTPUTFILE /OUTPUTFILE=filespec/ Writes command output to the specified file.wwYGH1 > PURGE 2 DEVICE> Deletes device data from the LAN permanent device database.J If you don't select particular data to delete via qualifier, the entire device entry is deleted. Format PURGE DEVICE device-name 3 Parameter device-nameJ Specifies the LAN device name. The device name has the form ddcu, whereI dd is the device identifier, c is the controller designation, and u is the unit number.I LAN devices are specified as the name of the templa?te device, which isJ unit 0. For example, the first EI Ethernet device is specified as EIA0,J the second as EIB0, and so on. You can specify the first EI device, for# example, as EIA, EIA0, or EIA0:.H A partial device name, accompanied by the /ALL qualifier, selects allI matching devices. For example: E to select all Ethernet devices, V forE VLAN devices, EI for Ethernet EI devices, no device name to select all LAN devices. 3 Qualifier/ALLB Deletes requested d@ata for all LAN devices in the LAN permanentE device database. If you specify a device name, data is deleted forD all matching devices; for example, EI/ALL deletes data for all EI LAN devices./CHARACTERISTICS" /CHARACTERISTICS or /PARAMETERSD Deletes device characteristics settings for each LAN device, such6 as speed, duplex mode, and other device parameters.6 For LAN Failover devices, clears failover settings./DLL /DLL or /MOPDLL: Deletes MOP downline Aload settings for each LAN device./TEST- Deletes test settings for each LAN device./TRACE7 Deletes driver tracing settings for each LAN device. 3 Example LANCP> PURGE DEVICE/ALLA This command deletes all devices from the LAN permanent device database.2 NODE7 Deletes a node from the LAN permanent node database. Format PURGE NODE node-name 3 Parameter node-nameC Specifies the name of a node in the LAN permanent node database.BF A partial node name, accompanied by the /ALL qualifier, selects allF matching nodes. For example: A to select all nodes starting with A,$ no node name to select all nodes. 3 Qualifier/ALLC Deletes all LAN nodes in the LAN permanent node database. If youD specify a node name, all matching nodes are deleted; for example,4 A/ALL deletes all nodes whose name begins with A. 3 Example LANCP> PURGE NODE/ALLG This command deletes all nodes from the LAN permanent nCode database.wwYGH1 SET2 ACP; Modifies the operation of the LANACP LAN Server process. Format SET ACP 3 Parameters None. 3 Qualifiers/ECHO /ECHO /NOECHO (default)D Enables partial tracing of received and transmitted downline loadE messages (the first 32 bytes of the data portion of each message).D Note that the last one or two MOP messages are displayed in full:E the memory load message with cluster parametersD, and the parameterA load with transfer address message, where present in the load.C The data is written to a log file SYS$MANAGER:LAN$node-name.LOG.I To obtain the entire contents of each message, use the /FULL qualifier as follows: SET ACP/ECHO/FULL/FULL /FULL /NOFULL (default)F When /ECHO is enabled, displays the entire contents of received and& transmitted downline load messages./OPCOM /OPCOM (default) /NOOPCOM9 Enables OPCOM mEessages from LANACP LAN Server process.H Messages are generated by the LANACP LAN Server process when a deviceH status changes, load requests are received, and loads complete. TheseI messages are displayed on the operator console and included in the log3 file written by LANACP, SYS$MANAGER:LAN$ACP.LOG./STARTJ Starts the LANACP process, by executing the SYS$STARTUP:LAN$STARTUP.COM command file./STOPF Stops the LANACP process. It can be restarted by requesting a sFtart as follows: LANCP> SET ACP/START 3 Example LANCP> SET ACP/ECHO/FULL; This command enables tracing of received and transmittedB downline load messages. The /FULL qualifier displays the entire? contents of received and transmitted downline load messages. 2 DEVICE* Sets or modifies LAN device parameters. Format SET DEVICE device-name 3 Parameter device-nameJ Specifies the LAN device name. The device name has the form ddcu, whereI G dd is the device identifier, c is the controller designation, and u is the unit number.I LAN devices are specified as the name of the template device, which isJ unit 0. For example, the first EI Ethernet device is specified as EIA0,J the second as EIB0, and so on. You can specify the first EI device, for# example, as EIA, EIA0, or EIA0:.H A partial device name, accompanied by the /ALL qualifier, selects allI matching devices. For example: E to select all Ethernet devicHes, V forE VLAN devices, EI for Ethernet EI devices, no device name to select all LAN devices.3 Qualifiers_(General)/ALLC Sets data for all LAN devices. If you specify a device name, allB matching LAN devices are selected, for example: E to select allB Ethernet devices, V for VLAN devices, EW to select all Ethernet EW devices. /BANDWIDTH> /BANDWIDTH=(hours-option, threshold-option, default-option, restart-option) /NOBANDWIDTH; Speci Ifies bandwidth monitoring settings for devices. See8 SYS$HELP:LAN_BANDWIDTH_MONITORING_HOW_TO.PDF for more information.= Bandwidth is recorded in a buffer allocated from S2 space,; a list of 32-byte buckets. Each bucket contains the data9 for one second. A bucket that contains aggregated data; is as long as the data being collected remains below the$ threshold (see threshold-option).: Note that one bucket is reserved for bandwidth context.9 If the recording buff Jer cannot be allocated, bandwidth# bandwidth recording is not done.9 The default size is determined by the LAN_FLAGS system: parameter value extracted from bits <11:9>, either when9 the LAN device is configured (usually at boot time) or7 when a LANCP SET DEVICE/BANDWIDTH command is issued:, Buffer size Minimum+ LAN_FLAGS <11:9> (bytes) Hours* 0x00000000 65,536 0.6* 0x00000200 1,048,576 9.1* 0Kx00000400 2,097,152 18.2* 0x00000600 3,145,728 27.3* 0x00000800 4,194,304 36.4* 0x00000A00 5,242,880 45.5* 0x00000C00 6,291,456 54.6* 0x00000E00 7,340,032 63.7> You can specify the following keywords with this qualifier: o hours-option" HOURS=value (default 1 hour)F Specifies the size of the bandwidth recording buffer as hours ofA data collected, 32 bytes per second, 115200 by Ltes per hour.B If the calculated buffer is different from the current size,F the existing buffer is deallocated and a new buffer is allocatedD with the requested size, and bandwidth recording is restarted.B The maximum hours that can be specified is 8760 (one year of6 data collection with a threshold value of zero).! Buffer size. Hours value (bytes) # Buckets. 1 115,200 3,600. 2 M 230,400 7,200. 24 (day) 2,764,800 86,400. 744 (month) 85,708,800 2,678,400. 8760 (year) 1,009,152,000 31,536,000B Specifying the hours-option overrides the LAN_FLAGS setting.A Specifying hours=0 is equivalent to SET DEVICE/NOBANDWIDTH. o threshold-option+ THRESHOLD=bytes (default 10000 bytes)H Specifies the threshold at which a new bandwidth entry is started.C Below this is considered 'noise' and N not worthy of collectingG second by second details. When the amount of transmit and receiveE data over the last second is less than the threshold, the totalA is accumulated in the current bandwidth bucket and we don'tA advance to the next bucket. Note that 0 bytes in one secondB does get recorded, as that is an unusual amount of activity.C A 20 second period with 0 bytes of activity would be recorded1 as a 20 second long bucket with 0 activity.< O For a non-zero threshold, each bucket is one of these:< - Data for consecutive seconds where bytes were zero9 - Data for 1 second, where bytes is GEQ threshold@ - Data for consecutive seconds where bytes were non-zero+ and less than the threshold valueD For a zero threshold, all bandwidth buckets contain one second of activity. o default-option DEFAULTI Restarts bandwidth monitoring with default settings, discarding anyP data recorded already. o restart-option RESTARTJ Restarts bandwidth monitoring, discarding any data recorded already. /DESCRIPTION /DESCRIPTION="quoted string"F The quoted string provides additional information that is displayedF by the LANCP> SHOW CONFIGURATION command. An example of usage is to/ identify the switch connection for a device./DEVICE_SPECIFIC< /DEVICE_SPECIFIC=(FUNCTION="xxxx",VALUE=(n1,n2,n3...n16)) /NODEVICE_SPECIFICQM Allows device-specific parameters to be adjusted. These are used for debug: purposes or to override default device characteristics.F Specify the negated qualifer to clear all device-specific parameter data.A These functions are described in LAN help files on the system, SYS$HELP:LAN_*.*./DLLA /DLL or /MOPDLL=(enable-option, exclusive-option, size-option, knownclientsonly-option)B Provides the MOP downline load service settings for the device.A Note Rthat 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 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 SSpecify 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 indicateC that the LAN MOP downline load service can coexist with otherD implementations (in particular, the DECnet Phase IV and DECnet5 Plus implementations that include MOP support).A Note that when you select NOEXCLUSIVE, LANACP responds onlyD to MOP downline load requests directTed to nodes defined in the LAN node database. o size-option SIZE=valueB Use SIZE=value to specify the size in bytes of the file dataC portion of each downline load message. The permitted range isE 246 to 1482 bytes. The default value is 246 bytes, which shouldC allow any client to load properly. Note that some clients may" not support the larger size.F The recommended size for better load performance and less serverF overhead is Uthe largest size that results in successful loads ofD all clients. The 1482 value is derived from the maximum packetD size for CSMA/CD (Ethernet) of 1518 bytes less the 802e header> and CRC (26 bytes) and MOP protocol overhead (10 bytes).E You can override the size on a per-node basis. See the SET NODE commands for details. o knownclientsonly-option KNOWNCLIENTSONLY" NOKNOWNCLIENTSONLY (default)J Specify KNOWNCLIENTSONLY to indicate tha Vt MOP downline load requestsK should be serviced only for clients defined in the LAN permanent nodeG database. When you select NOKNOWNCLIENTSONLY, LANACP searches theH LAN$DLL directory for any images requested by clients that are not' defined in the LAN node database.E Note that this option is not available when NOEXCLUSIVE mode isF selected. In NOEXCLUSIVE mode, LANACP services MOP downline loadA requests only for clients defined in the LAN node databaWse. /MAX_BUFFERS /MAX_BUFFERS=valueF Sets the maximum number of receive buffers to be allocated and used( by the LAN driver for the LAN device. /MIN_BUFFERS /MIN_BUFFERS=valueF Sets the minimum number of receive buffers to be allocated and used( by the LAN driver for the LAN device. /PERMANENT /PERMANENT (SET DEVICE only)J Updates the device entries in the LAN volatile device database with anyJ data currently set in the permanent database. This alXlows you to updateG the volatile database after changing data in the permanent database,I rather than repeating the commands for each updated entry to apply the$ changes to the volatile database./PORT /PORT=valueA Sets the port number to use when defining a UDP pseudo device./TAG! /TAG=value (VLAN devices only)5 Specifies the IEEE 802.1Q tag for the VLAN device.B A VLAN tag consists of a 16-bit TPID (tag protocol identifier),B a 3-bit priority, 1-bitY CFI (canonical format indicator), and a 12-bit VLAN ID.@ The VLAN tag fields TPID, Priority, and CFI must be zero. The? VLAN tag field, then, is the VLAN ID only, and is restricted to values 1..4095.A Once set, the tag cannot be changed. To change, deactivate theA VLAN device to reuse the existing device name, or create a new VLAN device./TEST /LOOP /RECEIVE /TOGGLE /TRANSMIT /TESTE These qualifiers implement test functionality built i Znto LANCP forH purposes of debug and validation. The test functionality is described5 in LAN help files on the system, SYS$HELP:LAN_*.*./TRACE; /TRACE=(size-option, mask-option, stop-option, keywords) /NOTRACEE Provides the LAN driver trace settings for the device. By default,D the LAN drivers do tracing of error conditions and state changes.F Tracing is controlled by an event mask that select events to trace,C a stop mask that specifies when to stop tracing, and [the size ofG the trace buffer. Keywords provide a user-friendly way of specifying2 the event mask that consists of two hex values.> You can change tracing settings at any time. The LAN driverD allocates the trace buffer from non-paged pool. You can calculateD the amount of pool needed by multiplying the number of entries by$ the size of each entry, 32 bytes.B The impact of tracing on the system is negligible for error andF state change events, more significant when all ev\ents are selected,@ and yet more significant when full packet tracing is enabled.B The command SHOW DEVICE/TRACE displays trace results. The trace6 settings are displayed by SHOW DEVICE/TRACE/HEADER.4 Stop tracing with the command SET DEVICE/NOTRACE.> You can specify the following keywords with this qualifier: o size-option SIZE=valueH Use SIZE=value to specify the size of the trace buffer in entries,I each 32 bytes. The default is 2048 entries. The ]initial and minimum9 size is 512 entries and maximum is 1000000 entries. o mask-option MASK=(value1,value2)H Use MASK=(value1,value2) to specify the trace mask to select whichH entries should be collected in the trace buffer. The first 32 bitsF consist of events common to most LAN drivers. The second 32 bitsB consist of events specific to the LAN driver for the device.E The mask can be specified by a numerical value and/or a list of0 ke ^ywords that identify the bits to be set. o stop-option STOP=(value1,value2)H Use STOP=(value1,value2) to specify the trace mask to select whichE type of entries should stop tracing. When a trace entry is madeF that matches one of the bits in the stop mask, the trace mask isH cleared so that you can look at the trace data accumulated so far.A The mask can be specified by a numerical value or a list of0 keywords that identify the bits to be set. _ o keywordsE DEFAULT - Requests that the trace mask be set to the LAN driver# default trace mask.G PAUSE - Stops tracing but does not deallocate the trace buffer soE it can be read without being disturbed by more tracing.D RTINT - Select receive done, transmit issue, interrupt events.B RFTINT - Select RTINT plus fork start and fork done events. : PK - Select full size transmit and receive packets. H SMALLPK - Select transmi`t and receive packets, saving to 32 bytes.L MEDIUMPK - Select transmit and receive packets, saving up to 64 bytes.K LARGEPK - Select transmit and receive packets, saving up to 96 bytes.@ XFULL, RFULL - Select transmit, receive packets full size.G XSMALL, RSMALL - Select transmit, receive packets up to 32 bytes.I XMEDIUM, RMEDIUM - Select transmit, receive packets up to 64 bytes.G XLARGE, RLARGE - Select transmit, receive packets up to 96 bytes.0 MALL - Sel aect all bits for the trace mask.; M00..M63 - Select individual bits for the trace mask.0 MNONE - Select no bits for the trace mask.5 SALL - Select all bits for the trace stop mask.@ S00..S63 - Select individual bits for the trace stop mask.5 SNONE - Select no bits for the trace stop mask.C The remaining events are listed in the trace header displayedD by the command SHOW DEVICE/TRACE/HEADER. The keyword is listedC in all caps preceding the descriptbion of the trace entry. All; of the keywords except the ones above can be negated. /ULAN_DEVICE /ULAN_DEVICE=device-name /NOULAN_DEVICE, (Future Release, not currently supported)D Specifies the physical LAN device that is to host the UDP device.H The /NOULAN_DEVICE qualifier requests deactivation of the UDP device.D When deactivating the UDP device, the device-name is not requiredG because the UDP driver knows which device is hosting the UDP device.C N cote that a UDP device cannot be deactivated if any applications continue to use the device./UPDATE /UPDATE (DEFINE DEVICE only)F Adds LAN devices that are not currently in the LAN permanent deviceC database to that database. The initial entry for the device usesF default values for all parameters. To update the permanent databaseF with current information from the volatile database, use the DEFINEC DEVICE command with the /VOLATILE qualifier. You can combine theF d /UPDATE and /VOLATILE qualifiers in a single DEFINE DEVICE command. /UPDATE (SET DEVICE only)E Adds LAN devices that are not currently in the LAN volatile deviceC database to that database. The initial entry for the device usesE default values for all parameters. To update the volatile databaseD with current information from the permanent database, use the SETD DEVICE command with the /PERMANENT qualifier. You can combine theD /UPDATE and /PERMANENT qualifiers in a singlee SET DEVICE command. /VLAN_DEVICE /VLAN_DEVICE=device-name /NOVLAN_DEVICEE Specifies the physical LAN device that is to host the VLAN device.A The /NOVLAN_DEVICE qualifier requests deactivation of the VLAN device.E When deactivating the VLAN device, the device-name is not requiredA because the VLAN driver knows which device is hosting the VLAN device.D When creating a new VLAN device, or reusing a deactivated device,3 the /TAG must be included to suppfly the VLAN ID.D Note that a VLAN device cannot be deactivated if any applications continue to use the device.F Note that the LAN Failover device (LLx) is considered as a physicalC LAN device. It acts as a single failover device and represents a set of physical LAN devices. /VOLATILE! /VOLATILE (DEFINE DEVICE only)G Updates the device entries in the LAN permanent device database withF any data currently set in the volatile database. This allows you toD updgate the permanent database after changing data in the volatileF database, rather than repeating the commands for each updated entry2 to apply the changes to the permanent database. 3 Qualifiers_(Ethernet_Devices)/AUTONEGOTIATE /AUTONEGOTIATE (default) /NOAUTONEGOTIATEH Enables or disables the use of auto-negotiation to determine the linkI settings. You may need to disable link auto-negotiation when connected@ to a switch or device that does not support auto negotihation.C After you issue this command, the Ethernet driver may redo auto- negotiation.B For VM devices, auto-negotiation, duplex mode, and flow controlC settings are determined by the hypervisor and associated network@ device driver. The OpenVMS LAN driver overrides any requested@ setting to set auto-negotation enabled, full-duplex mode, and flow control enabled. /FLOW_CONTROL /FLOW_CONTROL (default) /NOFLOW_CONTROL( Enables flow control on a LAN device.iB For VM devices, auto-negotiation, duplex mode, and flow controlC settings are determined by the hypervisor and associated network@ device driver. The OpenVMS LAN driver overrides any requested@ setting to set auto-negotation enabled, full-duplex mode, and flow control enabled. /FULL_DUPLEX /FULL_DUPLEX /NOFULL_DUPLEX (default)D Enables full-duplex operation of a LAN device. Before full-duplexF operation results from the use of this qualifier, additional devi jceI or network hardware setup may be required. Some devices may be enabledG for full-duplex operation by default. Some devices may not allow the setting to be changed.? The /NOFULL_DUPLEX qualifier disables full-duplex operation.B For VM devices, auto-negotiation, duplex mode, and flow controlC settings are determined by the hypervisor and associated network@ device driver. The OpenVMS LAN driver overrides any requested@ setting to set auto-negotation enabled, full-dukplex mode, and flow control enabled./JUMBO /JUMBO /NOJUMBO (default)F Enables the use of jumbo frames on a LAN device. Gigabit and faster) Ethernet devices support jumbo frames.D The jumbo frame size is 9018 bytes, i.e, MAC header + data + CRC, excluding VLAN tags./MEDIA /MEDIA=valueG Selects the cable connection. Normally, the selection is made duringK device initialization using a limited autosensing algorithm that selectsE twisted pair, l but fails over to AUI (Attachment Unit Interface) ifG twisted pair does not appear to be functional. Thereafter, a cablingC change would require a reboot of the system to take effect. This@ command allows you to change the selection without rebooting.G Acceptable values are AUI (10Base2, 10Base5), TWISTEDPAIR (10BaseT),G BNC, UTP, STP, and AUTOSENSE (redo the limited autosense algorithm)." The default value is AUTOSENSE.K Some devices, such as the DE435, require a jumperm change on the EthernetG card to switch between 10Base2 and 10Base5 (thinwire and thickwire).H Other devices, such as the DE434, DE436, and DE500, have only twisted pair connections./SPEED /SPEED=value1 Sets the speed of the LAN, in megabits/second.C Valid values are 10, 100, 1000, 2500, 5000, 10000, 25000, 40000, 100000, or autonegotiate.? Autonegotiate indicates that the driver should determine theA speed either by auto-negotiation or by device charactneristics.F Emulated VM devices are nominally 1000 megabits/second, but you can override the nominal speed.I After you issue this command, the Ethernet driver may re-do link setup' and auto-negotiation for the device.$3 Qualifiers_(LAN_Failover_Devices)/DISABLEA Disables the LAN Failover set which deactivates the active LAN+ Failover device and disallows I/O to it./ENABLEG Enables a LAN Failover set, which activates the LAN Failover device.I The LAN Foailover driver selects a LAN device from the LAN Failover setG as the active device and then allows I/O to the LAN Failover device. /FAILOVER_SET$ /FAILOVER_SET=(device-name[,...])& /NOFAILOVER_SET=(device-name[,...])C Specifies the members of a LAN Failover set, adding or removing.D Note that the active LAN device in the LAN Failover set cannot beF removed without disabling the failover set or making another device& active (see the /SWITCH qualifier). /PRIORITY p /PRIORITY=valueC Sets the failover priority of a LAN device. When choosing amongE available link up devices, the device with the highest priority is selected. @ When a LAN device with a higher priority becomes available, aB failover transition to the newly available device is performed.D This allows a system manager to set a preferred device by setting3 one LAN device to a higher priority than others.C Is not significant for LAN Failover (LL) devices as they inqheritD the priority of the attached LAN device when the LAN Failover set is enabled./SIZE /SIZE=value3 Sets the packet size of the LAN Failover device.4 Valid values are STANDARD (the default) or JUMBO:G o STANDARD is the Ethernet maximum packet size of 1518 bytes, i.e.,2 MAC header + data + CRC excluding VLAN tags.G o JUMBO is the oversize packet size supported by Gigabit and fasterF devices, 9018 bytes, i.e, MAC header + data + CRC excluding VLrAN tags.H JUMBO is allowed if all of the LAN devices in the LAN Failover set support jumbo frames.C Note: This size parameter controls the jumbo setting of the LANG Failover set. The jumbo setting of the individual members of the LAN Failover set is irrelevant./SWITCH /SWITCH (SET DEVICE only)@ Forces a LAN failover transition to another member of the LAN Failover set.F You can test LAN Failover operation by using this command to switchHs to the another device in the failover set. The switch is accomplishedG by resetting the active device. The LAN Failover driver then selectsJ the next available device, according to link state and device priority.F To force a LAN Failover transition to any member of the set, adjust8 the priority of the devices before doing the /SWITCH. 3 Examples% 1 LANCP> SET DEVICE/MEDIA=TWI EWB00 Sets the media type to twisted pair for EWB0.& 2 LANCP> SET DEVICE EIA0/DLL=ENABLEtD Enables MOP downline load service for EIA0, leaving the remaining MOPDLL parameters unchanged.< 3 LANCP> SET DEVICE EIA0/DLL=(ENABLE,EXCLUSIVE,SIZE=1482)I Enables MOP downline load service for EIA0, in exclusivemode with dataD transfer size 1482 bytes, leaving the remaining MOPDLL parameters unchanged.4 4 LANCP> SET DEVICE EIA0/DLL=(ENABLE,NOEXCLUSIVE)D This command enables LANACP MOP downline load service for EIA0 in nonexclusive mode.2 NODEC Enterus a node into the LAN volatile node database or modifies an existing entry. 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 v /NOADDRESS (default)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, VMSSYS.EIA for the EIA device on node VMSSYS, or4 w VMSSYS_1 for the first LAN device on node VMSSYS.D If you do not specify the /ADDRESS qualifier, the setting remains8 unchanged. The /NOADDRESS qualifier clears the field./ALLD Sets data for all nodes in the LAN volatile node database. If youE specify a node name, all matching nodes are selected; for 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 loadx? 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 boot9 o I64_SATELLITE-an OpenVMS Cluster I64 satellite 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 they@ load image given by the /FILE qualifier. The default value is OTHER.> If you do not specify the /BOOT_TYPE qualifier, the settingB remains unchanged. The /NOBOOT_TYPE qualifier clears the field.; Note that I64 satellites boot using TFTP rather than MOP? services. This boot type is included so that the informationC in the node database can be maintained, not because it is needed for booting purposes./DECNET_ADDRESS /DECNET_ADDRESS=value /NODECNET_ADDREzSS> 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=filespec /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 specific{ation 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 dot|ted 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_DATABASE& /PERMANENT_DATABASE (SET NODE only)B Updates the node entries in the LAN volatile 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 command}s 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 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 to load that have a problem with MOPB Version 4 booting. This qualifier causes the requesting node to@ failover from MOP Version 4 to MOP Version 3 when no response5 has been received 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_DATABASE( /VOLATILE_DATABASE (DEFINE NODE only)C 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 Examples7 1 LANCP> SET NODE VMSSYS/ADDRESS=08:00:2B:11:22:33 -* /FILE=APB.EXE -5 /ROOT=$64$DIA14: -5 /BOOT_TYPE=ALPHA_SATELLITE= This command sets up node VMSSYS 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 VMSSYS/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 VMSSYS 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 not included in the root definition.< 3 LANCP> SET NODE VMSSYS/ADDRESS=08:00:2B:11:22:33/NOROOT> This command changes the LAN address associated with node6 VMSSYS 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 Inf oServerA image. It defines the file that should be loaded when a load< request without 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 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. 2 VERIFYF Controls whether command lines and data lines in command proceduresC are displayed at the terminal or are printed in a batch job log. Format SET VERIFY SET NOVERIFY 3 Parameter None. 3 Qualifiers None.wwHH1 SHOW2 ACPA Displays the settings of various options for LANCP and LANACP. Format SHOW ACP 3 Parameters None. 3 Qualifiers /OUTPUTFILE /OUTPUTFILE=filespec/ Writes command output to the specified file. 3 Example LANCP> SHOW ACP LANCP/LANACP options: Verify is OFF OPCOM messages are ENABLED! DLL packet tracing is DISABLED8 This example shows how LANCP and LANACP are currently configured. 2 BANDWIDTH: Displays bandwidth monitoring settings for all devices. Format SHOW BANDWIDTH 3 Parameters None. 3 Qualifier /OUTPUTFILE /OUTPUTFILE=filespec/ Writes command output to the specified file.2 CONFIGURATIOND Displays a list of LAN devices and characteristics on the system. Format SHOW CONFIGURATION 3 Parameters None. 3 Qualifiers/ALL: Same as SHOW CONFIGURATION plus /BANDWIDTH and /STATUS. /BANDWIDTHE Shows configuration and bandwidth information for each LAN device,E including uptime, packets, bytes, highest bandwidth interval data./CONFIGURATIONB Shows configuration and status information for each LAN device,B including link state, buffer size, MAC address, name, and more.6 This is the default for SHOW CONFIGURATION and SHOW CONFIGURATION/USER. /OUTPUTFILE /OUTPUTFILE=filespec/ Writes command output to the specified file./STATUSB Shows configuration and status information for each LAN device,, including uptime, packets, bytes, errors./USERSD Shows configuration information and the protocols running on each LAN 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-nameJ Specifies the LAN device name. The device name has the form ddcu, whereI dd is the device identifier, c is the controller designation, and u is the unit number.I LAN devices are specified as the name of the template device, which isJ unit 0. For example, the first EI Ethernet device is specified as EIA0,J the second as EIB0, and so on. You can specify the first EI device, for# example, as EIA, EIA0, or EIA0:.H A partial device name selects all matching devices. For example: E toF select all Ethernet devices, V for VLAN devices, EI for Ethernet EI5 devices, no device name to select all LAN devices. 3 Qualifiers/ALLD Shows all devices. If you specify a device name, all matching LANH devices are displayed, for example: E to select all Ethernet devices,< V for VLAN devices, EI to select all Ethernet EI devices.< LIST and SHOW commands implicitly include this qualifier. /BANDWIDTHF Displays bandwidth data collected. Bandwidth data is collected onceD a second for each LAN device. Included is a column characterizing' the bandwidth as Zero, <1Mb, 1Mb ...B Additional qualifiers affect what data is displayed as follows: o /EXPANDED@ Expands compressed data and converts the raw data into one second intervals. o /SUMMARY> Provides summary data only. Summary data is collected on2 one-second intervals (/EXPANDED is implied).+ o /SINCE=time /DURATION=time /LAST=timeH Displays results for a period of time. SINCE defaults to TODAY andI can be explicity specified as YESTERDAY or TODAY. DURATION and LASTI are equivalent. DURATION or LAST defaults to 60 seconds if no value is provided.6 o /[NO]ZERO /1MB /10MB /100MB /1GB /2GB /5GB /10GB? To select specific bandwidths, for example /100MB selects8 intervals with bandwidth 100 MBits/sec or greater. o /DUMPFILED Writes the binary bandwidth data to the specified output file,F including the system name, LAN device name, and binary bandwidth' data as read from the LAN device.E Note: If more than one device is selected only the first device found is processed. o /INPUTFILE=filespecF Reads the binary bandwidth data from the specified file (createdD by /DUMPFILE and /OUTPUTFILE) rather than from the LAN device.I The default bandwidth buffer size is 2048 buckets, total 64k bytes perJ LAN device. The LAN_FLAGS system parameter sets the default buffer size according to this table:5 Buffer size Minimum4 LAN_FLAGS <11:9> Buckets (bytes) Hours3 0x00000000 2048 65536 0.63 0x00000200 32768 1048576 9.13 0x00000400 65536 2097152 18.23 0x00000600 98304 3145728 27.33 0x00000800 131072 4194304 36.43 0x00000A00 163840 5242880 45.53 0x00000C00 196608 6291456 54.63 0x00000E00 229376 7340032 63.7/CHARACTERISTICS" /CHARACTERISTICS or /PARAMETERS< Displays status and related information about the device./CLEAR_COUNTERSC Clears device counters and internal driver counters after a SHOWG DEVICE/COUNTERS or SHOW DEVICE/INTERNAL_COUNTERS command. SubsequentD SHOW commands show the counter values accumulated since the clear was done.J This affects counters displayed by LANCP only. Used with the /COUNTERS% and /INTERNAL_COUNTERS qualifiers.H See the /RESTORE_COUNTERS to restore counters to the original values. /COUNTERSA Displays device counters. By default, it does not display zeroD counters. To see all counters, including zero, use the additional qualifier /ZERO./DEBUGA Shows additional counters that may be used for debug purposes./ Applies to the /INTERNAL_COUNTERS qualifier./DLL /DLL or /MOPDLLC Displays LAN volatile device database information related to MOP downline load for the device. /FAILOVER Shows LAN Failover settings./INTERNAL_COUNTERSC Displays internal counters. By default, it does not display zeroD counters. To see all counters, including zero, use the additionalA qualifier /ZERO. To see the debug counters, use the additional qualifier /DEBUG. /MESSAGESD Displays the console messages displayed by the LAN driver as partB of the LAN driver internal counters. This qualifier is includedB for convenience, to avoid scanning the internal counters to get to the message data. /OUTPUTFILE /OUTPUTFILE=filespec/ Writes command output to the specified file./RESTORE_COUNTERSA Restores device counters and internal driver counters prior toC a SHOW DEVICE/COUNTERS or SHOW DEVICE/INTERNAL_COUNTERS command.J This affects counters displayed by LANCP only. Used with the /COUNTERS% and /INTERNAL_COUNTERS qualifiers.1 See the /CLEAR_COUNTERS to clear the counters./TESTD Displays test status and configuration for the test functionalityB built into LANCP for purposes of debug and validation. The test> functionality is described in LAN help files on the system, SYS$HELP:LAN_*.*./TRACE" Displays LAN driver trace data.B Additional qualifiers affects the trace data output as follows: o /PCAPFILE=filespecG Without affecting any other output, LANCP writes the transmit andB receive packet trace entries to the specified file in binary@ PCAPNG format, version 1.0. This file can be read by other= utilities that process PCAPNG files, such as WireShark. o /DUMPFILED Writes the trace data to the file specified by the /OUTPUTFILEH qualifier. This file can be read using the /INPUTFILE qualifier soD the data can be viewed later and with the /SELECT qualifier to select particular entries. o /INPUTFILE=filespecA Reads trace data from the specified file, which was created! by the /DUMPFILE qualifier. o /REVERSE+ Displays trace data in reverse order.% o /SELECT=(mask-option, keywords). Specifies which trace events to display.A You can specify the following keywords with this qualifier: o mask-option MASK=(value1,value2)K Use MASK=(value1,value2) to specify the trace mask to select whichK entries should be displayed from the trace data. The first 32 bitsI consist of events common to most LAN drivers. The second 32 bitsE consist of events specific to the LAN driver for the device.H The mask can be specified by a numerical value and/or a list of3 keywords that identify the bits to be set. o keywordsJ Any event can be specified - they are listed in the trace header. o /[NO]HEADERG By default, the trace masks are displayed then the trace data. To9 suppress this trace header data, specify /NOHEADER.= To display only the trace header data, specify /HEADER./VERSIONB Displays the current LAN driver and device version information,C if available or app licable. Not all LAN drivers maintain version information./VLANH Displays a list of IEEE 802.1Q tags that are configured on the switchE port connected to the specified physical LAN device. LANCP listensF for the GVRP packets that contain the configuration information and displays the configured tags.G The switch periodically sends GVRP (GARP VLAN Registration Protocol)F (GARP = Generic Attribute Registration Protocol) packets to provideD VLAN configuration information in compliance with the IEEE 802.1QD specification. If GVRP is not configured on the switch, or if theF LAN device is not connected to a switch, this command displays only8 the list of tags that the VLAN driver has configured./ZEROE Show counter even if zero. By default, zero counter values are not displayed.> Applies to the /COUNTERS and /INTERNAL_COUNTERS qualifiers. 3 Examples% 1 LANCP> SHOW DEVICE/COUNTERS EIA0 Device Counters EIA0: Value Counter ----- -------2 259225 Seconds since 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 12257 8 Blocks sent, multiple collisions6 86000 Blocks sent, single collision8 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 unavailableA This command displays counters for the Ethernet device EIA0. 2 LANCP> SHOW DEVICE/DLL' Device Listing, volatile database:A --- MOP Downline Load Service Characteristics ---D Device State Access Mode Clients Data SizeD ------ ----- ----------- ------- ---------E EIA0 Enabled Exclusive KnownClientsOnly 1400 bytesE EWA0 Disabled NoExclusive NoKnownClientsOnly 246 bytesC This command displays MOP downline load information in the LAN4 volatile device database for all known devices. 3 LANCP> SHOW DEVICE/DLL EIA0' Device Listing, volatile database:A --- MOP Downline Load Service Characteristics ---D Device State Access Mode Clients Data SizeD ------ ----- ----------- ------- ---------E EIA0 Enabled Exclusive KnownClientsOnly 1400 bytesC This command displays MOP downline load information in the LAN; volatile device database for the Ethernet device EIA0.$ 4 LANCP> SHOW DEVICE/VERSION EWF0 Device Versions EWF0:' Value Component' ----- ---------5 02000041 Device hardware version1 08020110 00000004 Port driver version9 08020172 00000001 LAN common routines versionB This command displays version information for Ethernet device EWF0:.; 5 LANCP> SHOW DEVICE/COUNTERS/INTERNAL_COUNTERS/FAILOVERJ Shows that you can select multiple displays on the same command line.2 DLLC Displays the current state of MOP downline load services for theA system, including devices for which MOP loading is enabled and counters information. Format SHOW DLL or SHOW MOPDLL 3 Parameters None. 3 Qualifier /OUTPUTFILE /OUTPUTFILE=filespec/ Writes command output to the specified file. 4  Example LANCP> SHOW DLL LAN DLL Status:7 EIA enabled in exclusive mode for known nodes only, data size 1482 bytes EWA disabledE #Loads Packets Bytes Last load time Last loadedF ------ ------- ----- -------------------- ------------B EIA 5 1675 4400620 22-SEP-2018 10:27.51 GALAXY" EWA 0 0 0; On this node, there are two LAN devices, EIA (DE602) and> EWA (DE500). MOP downline load service is enabled on EIA in exclusive mode.? Requests are answered only for nodes that are defined in theA LANACP node database. The image data size in the load messages? is 1482 bytes. There have been five downline loads, the last? one occurring on node GALAXY at 10:27. Finally, there are no? recorded downline loads for EWA, which is currently disabled for downline load service. 2 FAILOVER, Displays LAN Failover devices and status. Format SHO"W FAILOVER or SHOW LLAN 3 Parameters None. 3 Qualifier /OUTPUTFILE /OUTPUTFILE=filespec/ Writes command output to the specified file.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 /OUTPUTFILE /OUTPUTFILE=filespec/ Writes command output to the specified file. 3 Example LANCP> SHOW LOG@ This command 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.< LIST and SHOW commands implicitly include this qualifier./COMFILE /COMFILE=filespecD Writes command output to the specified file in the form of a listB of SET NODE commands. The resulting command file can be used to" populate the LAN node database. /OUTPUTFILE /OUTPUTFILE=filespec/ Writes command output to the specified file./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: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 failedD Last request was for a system image, in MOP V4 format7 Last load initiated 10-JUN-2018 09:11:17* on EIA0 for 00:00:06.65> 527665 bytes, 4161 packets, 0 transmit failures! Unnamed (00:00:00:00:00:00): Totals: Requests received 2 Requests volunteered 1 Successful loads 1 Failed loads 0 Packets sent 2080 Packets received 2081" Bytes sent 523481 Bytes received 4184= Last load CALPAL at 10-JUN-2018 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 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 of the load was 6.65 seconds. 2 LANCP> SHOW NODE VMSSYSD Displays node characteristics and counters information from the0 LAN volatile node database for node VMSSYS. 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 t(he file TMP.INI.2 PTP, (Future release, not currently supported)" Shows PTP settings for devices. Format SHOW PTP 3 Parameters None. 3 Qualifier /OUTPUTFILE /OUTPUTFILE=filespec/ Writes command output to the specified file.2 TEST# Shows test settings for devices. Format SHOW TEST 3 Parameters None. 3 Qualifier /OUTPUTFILE /OUTPUTFILE=filespec/ Writes command output to the specified file.+2 TRACE$ Shows trace settings for devices. Format SHOW TRACE 3 Parameters None. 3 Qualifier /OUTPUTFILE /OUTPUTFILE=filespec/ Writes command output to the specified file.2 ULAN& Shows UDP LAN settings for devices. Format SHOW ULAN 3 Parameters None. 3 Qualifier /OUTPUTFILE /OUTPUTFILE=filespec/ Writes command output to the specified file.2 VLAN# Shows VLAN settings for devices. Format SHOW VLAN 3 Parameters None. 3 Qualifier /OUTPUTFILE /OUTPUTFILE=filespec/ Writes command output to the specified file.wwHH1 SPAWNG Creates a subprocess of the current process. Portions of the current0 process context are copied to the subprocess. Format SPAWN [command-string] 2 Parametercommand-stringA Specifies a command string of less than 132 characters that is@ to be executed in the context of the created subprocess. WhenA the command completes execution, the subprocess terminates and control returns to LANCP. 2 Qualifiers None. 2 Example LANCP> SPAWN $ MC LANCP7 LANCP> DEFINE NODE BOOM/ROOT=LAVC$SYSDEVICE:= LANCP> SPAWN SEARCH LAVC$SYSDEVICE:[*.SYSEXE]MOD*.DAT BOOM! ******************************/ LAVC$SYSDEVICE:[SYS1A.SYSEXE]MODPARAMS.DAT;1 SCSNODE="BOOM "7 LANCP> DEFINE NODE BOOM/ROOT=LAVC$SYSDEVICE:B In this example, you enter the node information for a node, but? are unsure of the root, so you spawn to search MODPARAMS.DAT/ for the node name and then correct the root.wwHH1 START 2 DEVICE! Starts a test on a LAN device. Format START DEVICE device-name 3 Parameter device-nameJ Specifies the LAN device name. The device name has the form ddcu, whereI dd is the device identifier, c is the controller designation, and u is the unit number.I LAN devices are specified as the name of the template device, which isJ unit 0. For example, the first EI Ethernet device is specified as EIA0,J the second as EIB0, and so on. You can specify the first EI device, for# example, as EIA, EIA0, or EIA0:.H A partial device name, accompanied by the /ALL qualifier, selects allI matching devices. For example: E to select all Ethernet devices, V forE VLAN devices, EI for Ethernet EI devices, no device name to select all LAN devices.3 Qualifiers_(General)/ALLI Starts test activity on all LAN devices. If you specify a device name,F all matching LAN devices are selected, for example: E to select allB Ethernet devices, V for VLAN devices, EW to select all Ethernet EW devices. /OUTPUTFILE /OUTPUTFILE=filespec/ Writes command output to the specified file./TEST /LOOP /RECEIVE /TOGGLE /TRANSMITE These qualifiers implement test functionality built into LANCP forH purposes of debug and validation. The test functionality is described5 in LAN help files on the system, SYS$HELP:LAN_*.*.wwHH 1 TRIGGER2 NODE/ Issues a request 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 Parameternode-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 beB defined in the LAN volatile node database. The address consistsC of 6 hexadecimal byte characters separated by hyphens or colons. 3 Qualifiers/DEVICE /DEVICE=device-nameH Specifies the LAN device name to be used for sending the trigger bootF messages. The device name has the form ddcu, where dd is the deviceI identifier, c is the controller designation, and u is the unit number.I LAN devices are specified as the name of the template device, which isJ unit 0. For example, the first EI Ethernet device is specified as EIA0,J the second as EIB0, and so on. You can specify the first EI device, for# example, as EIA, EIA0, or EIA0:. /PASSWORD /PASSWORD=16hexdigitsE Supplies the password to be used when the connection is initiated,H in hexadecimal (for example, /PASSWORD=0123456789ABCDEF). The default0 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=0123456789ABG This command sends MOP trigger boot messages to the specified node, address using the Ethernet device EWA0.wwHH 1 UPDATE 2 DEVICEJ Does an update operation on a LAN device. Currently, the only operation supported is reset. Format UPDATE DEVICE device-name 3 Parameter device-nameJ Specifies the LAN device name. The device name has the form ddcu, whereI dd is the device identifier, c is the controller designation, and u is the unit number.I LAN devices are specified as the name of the template device, which isJ unit 0. For example, the first EI Ethernet device is specified as EIA0,J the second as EIB0, and so on. You can specify the first EI device, for# example, as EIA, EIA0, or EIA0:. 3 Qualifiers/RESET, Specifies that the device is to be reset. 3 Example" LANCP> UPDATE DEVICE EWA0/RESET Resets Ethernet device EWA0.wwHH1 WAITE Waits the specified seconds. For example, WAIT 3 waits 3 seconds.) Wait with no arguments waits 1 second. Used in command files.ww