Download Print this page

Nortel 2000 Software Reference Manual

Nortel remote annex 2000 server: reference guide

Hide thumbs Also See for 2000:

Using manual (405 pages)

,

User manual (86 pages)

,

Hardware installation manual (26 pages)

page of 359

/ 359
Contents
Table of Contents
Bookmarks

Table of Contents

Advertisement

Quick Links

Download this manual See also: Administration Manual, User Manual

Book C

Chapter 1

Chapter 2

Chapter 3

Chapter 4

Chapter 5

Chapter 6

Using the na Commands

Using the Conﬁguration Parameters

Using the CLI Commands

Utilities

Network Protocols

Software Reference Guide

Table of Contents

Advertisement

Chapters

Table of Contents

Need help?

Need help?

Do you have a question about the 2000 and is the answer not in the manual?

Questions and answers

Summary of Contents for Nortel 2000

Page 1 Book C Chapter 1 Using the na Commands Chapter 2 Using the Conﬁguration Parameters Chapter 3 Using the CLI Commands Chapter 4 Utilities Chapter 5 Network Protocols Chapter 6 Software Reference Guide...
Page 3 Revision Level History Revision Description Initial release. Remote Annex Administrator’s Guide for UNIX...
Page 4 Revision Level History Remote Annex Administrator’s Guide for UNIX...
Page 5: Table Of Contents
Chapter 1 na Commands Command Notation ..............C-2 Commands .
Page 6 broadcast_addr ..............C-49 broadcast_direction .
Page 7 ipx_dump_password ..............C-66 ipx_dump_path.
Page 8 option_key................C-82 output_flow_control .
Page 9 rip_send_version ..............C-100 rip_sub_accept .
Page 10 tni_framing ............... . C-115 tni_line_buildout .
Page 11 ping ................C-161 ppp.
Page 12 Remote Annex Administrator’s Guide for UNIX...
Page 13 Figures Figure C-1. Overview of ping –t Actions........... . C-166 Figure C-2.
Page 14 Remote Annex Administrator’s Guide for UNIX...
Page 15 Tables Table C-1. Arguments for the na Commands ..........C-3 Table C-2.
Page 16 Table C-47. Status Field Deﬁnitions ............Table C-48.
Page 17 Table C-96. Parallel Printer Port Parameters..........C-317 Table C-97.
Page 18 xviii Remote Annex Administrator’s Guide for UNIX...
Page 19: Na Commands
Book C commands allow you to: The Annex stores the parameters set using na in non-volatile memory. After a reboot or a reset, the Annex updates its run-time parameters with the non-volatile parameters changed by na. The na utility can communicate with the Annex only when the Annex is running its operational code.
Page 20: Command Notation
Chapter 1 na Commands Command Notation Interactive na sessions allow you to enter na commands with or without arguments or parameters. If you enter the command without arguments or parameters, na prompts for them. The conventions for an interactive session are: Additionally, na permits comments when the # character is present at the beginning of a comment line.
Page 21: Table C-1. Arguments For The Na Commands
Book C Table C-1. Arguments for the na Commands Argument annex_identiﬁer annex_list annex_parameters interface_identiﬁer (continued on next page) Description A symbolic name or an IP address assigned to an Annex: 132.245.254.38 0xC0.0x9.0xC8.0x64 A list of one or more annex_identifiers separated by commas: support ,132.245.254.42,lab A list of one or more Annex parameters and...
Page 22 Chapter 1 na Commands Table C-1. Arguments for the na Commands (continued) Argument interface_parameters interface_set port_identiﬁer port_set port_parameters printer_parameters Remote Annex Administrator’s Guide for UNIX Book C-4 Description A list of one or more interface parameters, with or without values, separated by white space (space, tab, newline): rip_sub_advertise Y A list of one or more interface_identiﬁers separated...
Page 23: Commands
Book C Commands Table C-2 lists the na commands; the following subsections describe them. Table C-2. The na Commands Command annex boot broadcast copy dumpboot echo help or ? interface password port printer quit read (continued on next page) Description Deﬁnes a default annex_list used with subsequent commands.
Page 24: Annex
Chapter 1 na Commands Table C-2. The na Commands (continued) Command reset show write After installing na on a UNIX host, type na at a terminal connected to this host. No arguments or command line options are available. % na Annex network administrator Rx.x command: Seven of the na commands use standard UNIX superuser protection –...
Page 25 Book C The following example creates an annex_list containing one Annex with the Internet address 132.245.6.40: command: annex 132.245.6.40 The following example creates an annex_list containing two Annexes –one specified by its IP address, and the other specified by its name: command: annex 132.245.6.40,frontlobby The following example shows how na prompts for missing arguments: command: annex...
Page 26: Boot
Chapter 1 na Commands The password is not echoed when entered using the annex command. If you enter an incorrect password, na prompts for the correct one. If the password is incorrect a second time, na drops the Annex from the annex_list.
Page 27: Table C-3. Supported Arguments For The Boot Command
Book C Table C-3. Supported Arguments for the boot Command Argument –a –d –h –l –q HH:MM +HH:MM annex_list ﬁlename warning Description Aborts any delayed boots that are pending. Causes a dump before rebooting. Causes a diagnostic boot using the ROM Monitor boot command if the Annex is in Test mode.
Page 28: Broadcast
Chapter 1 na Commands The following sample boot command requests a boot in one hour and fifteen minutes: command: boot +1:15 annex list (return for default): thirdfloor, 132.245.6.40 filename (return for default): <cr> warning: Shutting down for PM The Annex can request its boot ﬁle from a deﬁned preferred load host. If that host is not deﬁned, or does not respond, the Annex broadcasts its request and boots from the ﬁrst load host to respond.
Page 29: Copy
Book C copy The copy command copies a given set of parameters from one Annex (or port) to another Annex (or port). Table C-5 defines each copy command. The syntax is: copy annex annex_identiﬁer annex_list copy interface interface_name@annex_identiﬁer interface_set copy printer printer_number@annex_identiﬁer printer_set copy [port | asynchronous] port_number@annex_identiﬁer port _set Table C-5.
Page 30: Dumpboot
Chapter 1 na Commands To copy port 1 parameters to the remaining ports on the same Annex: command: copy port 1@132.245.6.40 2–16@132.245.6.40 To copy port 1 parameters from one Annex to port 5 on another Annex: command: copy port 1@frontlobby 5@132.245.6.55 dumpboot The dumpboot command performs a dump of every Annex specified in the annex_list and then reboots the Annex.
Page 31: Table C-6. Arguments For The Dumpboot Command
Book C Table C-6. Arguments for the dumpboot Command Argument –a –q HH:MM +HH:MM annex_list ﬁlename warning Description Aborts any delayed dump boots that are pending. Performs a boot without sending a warning message. The exact clock time for the boot, i.e., 15:15 indicates 3:15 p.m.
Page 32: Echo
Chapter 1 na Commands echo The echo command writes its argument to the standard output. This command is intended for use in script files. The write command automatically puts echo commands in the script file it writes. The write command section of this chapter includes an example of echo commands included in the script file created by the write command.
Page 33 Book C Chapter 1 na Commands The help command_name display looks like this: command: help boot command: boot Syntax: boot [–adlq][[+][HH:][MM]]\ [<filename>] [<warning> The help parameter_name display looks like this: command: help timezone_minuteswest timezone_minuteswest (annex parameter): Minutes west of GMT: an integer Entering help followed by the first letter or first few letters of the command or parameter name displays all entries beginning with the string.
Page 34: Interface
Chapter 1 na Commands Book C interface The interface command establishes a default interface_set used in subsequent commands until another interface or list of interfaces is specified. Grouping interfaces using an interface_set allows you to issue one na command to examine or change the parameter values for multiple interfaces.
Page 35: Password
Book C Chapter 1 na Commands password The password command allows you to define a default password for the current na session. This command is useful when administering several Annexes with the same password. The syntax is: password [password] If you enter the command without giving the password, the Annex prompts for one, but does not echo it: command: password password:...
Page 36: Table C-8. Supported Keywords For The Port Command
Chapter 1 na Commands If you do not identify a speciﬁc Annex using the @ symbol and a name or Internet address when entering the port_set, all Annexes in the current annex_list are used. A port_set referring to the default annex_list is updated if a new annex command is issued.
Page 37: Printer
Book C Chapter 1 na Commands printer The printer command selects a subset of the parallel printer ports. The syntax is: printer printer_set If you do not specify a printer_set, na prompts for one. The default printer_set is all printers. quit The quit command terminates the na program from a script file;...
Page 38 Chapter 1 na Commands If you plan to use LAT or a feature enabled through the option_key parameter, set the lat_key and option_key parameters manually (using na or admin) and reboot the Annex before issuing the read command. The lat_key and option_key parameters are not enabled until you reboot, and any LAT- or option_key-related parameters in the script ﬁle are not recognized until lat_key or option_key is enabled.
Page 39: Reset
Book C reset The reset command (available from na or admin) changes some of the current attributes of all the Annexes in the default annex_list without rebooting them. Unless you use the reset command, changes to configuration parameters for a specific port, virtual CLI connection, security, or name server become effective only after booting the Annex.
Page 40: Table C-9. Keywords For The Reset Command
Chapter 1 na Commands The modem_set parameter speciﬁes the individual modem numbers, separated by commas, or a range of numbers separated by a hyphen. The valid modem number range is 1 to 24, inclusive. Table C-9. Keywords for the reset Command Keyword annex all annex dialout...
Page 41: Table C-10. Keywords For The Reset T1 Command
Book C Table C-9. Keywords for the reset Command (continued) Keyword annex syslog interface printer serial virtual Table C-10. Keywords for the reset t1 Command Keyword soft hard Deﬁnition Resets the syslog subsystem. The syslog subsystem does not use any changes made to the syslog_port parameter. Resets the interface parameters.
Page 42: Set
Chapter 1 na Commands The set command modifies Annex configuration parameters: set annex set interface set printer set [port | asynchronous] set t1 The syntax is: set annex [=annex_list] annex_parameters set interface [=interface_list] interface_parameters set printer [=printer_list] printer_parameters set [port | asynchronous] [=port_list] port_parameters set t1 t1_parameters The annex_parameters, interface_parameters, printer_parameters, port_parameters, and t1_parameters arguments require a name and a...
Page 43: Show
Book C Sample command lines for setting port parameters are: command: set port speed 9600 command: set port data_bits 7 command: set port stop_bits 1 command: set port parity odd command: set port control_lines none command: set port type hardwired command: set port mode cli command: set port inactivity_timer 120 show...
Page 44: Table C-11. Keywords For The Show Annex Command
Chapter 1 na Commands Each keyword displays a subset of parameters: Table C-11. Keywords for the show annex Command Keyword appletalk generic (continued on next page) Remote Annex Administrator’s Guide for UNIX Book C-26 • Table C-11 lists the keywords and associated parameters for the show annex command.
Page 45: Table C-12. Keywords For The Show Interface Command
Book C Table C-11. Keywords for the show annex Command (continued) Keyword nameserver router security syslog time tmux vcli Table C-12. Keywords for the show interface Command Keyword asyn asyn–n Parameters nameserver_broadcast, rwhod, pref_name1_addr, pref_name2_addr, name_server_1, name_server_2, host_table_size, min_unique_hostnames rip_routers, rip_auth enable_security, security_broadcast, pref_secur1_host, pref_secure2_host, network_turnaround, acp_key, password, allow_snmp_sets, loose_source_route,...
Page 46: Table C-13. Keywords For The Show [Port |Asynchronous] Command
Chapter 1 na Commands Table C-13. Keywords for the show [port |asynchronous] Command Keyword appletalk editing ﬂow generic security serial (continued on next page) Remote Annex Administrator’s Guide for UNIX Book C-28 Parameters Displays all asynchronous port parameters. at_guest, at_nodeid, at_security, arap_v42bis attn_string, echo, telnet_escape, telnet_crlf, map_to_lower, map_to_upper, char_erase, line_erase, hardware_tabs, erase_char, erase_word, erase_line, redisplay_line,...
Page 47: Table C-14. Keywords For The Show T1 Command
Book C Table C-13. Keywords for the show [port |asynchronous] Command (cont’d) Keyword slip timers tn3270 Table C-14. Keywords for the show t1 Command Keyword alarmsyslog bypass ring sigproto t1_info (continued on next page) Parameters local_address, remote_address, dialup_addresses, metric, slip_ppp_security, net_inactivity, phone_number, do_compression, allow_compression from the serial group and subnet_mask, slip_load_dump_host, slip_allow_dump, slip_mtu_size, slip_no_icmp, slip_tos...
Page 48 Chapter 1 na Commands Table C-14. Keywords for the show t1 Command (continued) Keyword tdi_distance tdi_framing tdi_line_code tni_circuit_id tni_clock tni_esf_fdl tni_framing tni_line_buildout tni_line_code tni_ones_density Remote Annex Administrator’s Guide for UNIX Book C-30 Description Displays an integer from 0 to 655 that represents the length of the cable from the T1 Drop/Insert Interface to the PBX or other equipment.
Page 49: Write
Book C write The write command creates a script file from the configuration data for a specific Annex. You can modify this script file using any text editor. Use the write command either to back up the current Annex’s conﬁguration or copy it to multiple Annexes. Once you write a script ﬁle, issuing the read command activates the Annex parameter settings contained in the ﬁle (for more details, see read on page A-19).
Page 50 Chapter 1 na Commands Book C The following is an example of the write command: command: write 132.245.6.101 fronthall.script The following example uses the write and read commands to install a new Annex and to create a back-up copy of an Annex. The first line writes configuration data for the Annex thirdfloor to a file named thirdfloor.prm.
Page 51: Configuration Parameters
Book C a given Annex. There are three ways in which you can configure and manage these parameters: This chapter includes the following sections: Parameter Conventions This section describes the conventions for entering parameter values and returning those values to the supplied defaults. Conﬁguration Parameters he conﬁguration parameters define the operating characteristics for •...
Page 52: Entering Parameter Values
Chapter 2 Conﬁguration Parameters Entering Parameter Values The conventions for entering parameter values depend on the type of information the parameter deﬁnes. Remote Annex Administrator’s Guide for UNIX Book C-34 • For parameters requiring an IP address, specify the address in dot notation as a decimal number (from 0 to 255), a hexadecimal number, or a combination of both: 192.9.200.100, 0xC0.0x9.0xC8.0x64, or 192.9.200.0x64.
Page 53: Setting Parameters To Supplied Defaults
Book C Setting Parameters to Supplied Defaults Each configuration parameter, except the Annex’s IP address, has a default value. Using the na command set, you can return any parameter to its default setting (for more details, see set on page Book C-24). Depending on the parameter type, the syntax options are: Setting Annex Parameters...
Page 54 Chapter 2 Conﬁguration Parameters Setting Parallel To set a parallel printer port parameter to its default value, use the set Printer Port printer command: Parameters Setting To set an asynchronous port parameter to its default value, use the Asynchronous set [port | asynchronous] command: Port Parameters The set sets parameters that have single-character default values.
Page 55: Parameter Descriptions
Book C Setting All To set all of the Annex’s parameters to the supplied defaults, use the ROM Parameters monitor erase command (see the appropriate Remote Annex Hardware Installation Guide). This command erases all parameters, including the Annex’s IP address. After issuing erase, you must re-enter the Annex’s IP address and re-configure the Annex.
Page 56: Table C-15. Keywords For The Show Annex Command
Chapter 2 Conﬁguration Parameters Table C-15. Keywords for the show annex Command Keyword generic vcli nameserver security time syslog (continued on next page) Remote Annex Administrator’s Guide for UNIX Book C-38 The AppleTalk, tn3270 , and dynamic-dialout parameters are visible only when the option_key parameter contains the correct key value (for more details, see AppleTalk on page A-301, tn3270 on page A-214, and IP Routing on page A-169).
Page 57: Table C-16. Keywords For The Show Interface Command
Book C Table C-15. Keywords for the show annex Command (continued) Keyword appletalk router tmux Table C-16. Keywords for the show interface Command Keyword asyn asyn–n Table C-17. Keyword for the show printer Command Keyword Chapter 2 Parameters a_router, default_zone_list, node_id, zone rip_routers, rip_auth ipx_ﬁle_server, ipx_frame_type, ipx_dump_username, ipx_dump_password, ipx_dump_path, ipx_do_checksum...
Page 58: Table C-18. Keywords For The Show [Port | Asynchronous] Command
Chapter 2 Conﬁguration Parameters Table C-18. Keywords for the show [port | asynchronous] Command Keyword generic ﬂow timers security editing serial slip (continued on next page) Remote Annex Administrator’s Guide for UNIX Book C-40 Parameters Displays all asynchronous port parameters mode, location, type, term_var, prompt, cli_interface, speed, autobaud, data_bits, stop_bits, parity, max_session_count, allow_broadcast, broadcast_direction, imask_7bits,...
Page 59: Table C-19. Keywords For The Show T1 Command
Book C Table C-18. Keywords for the show [port | asynchronous] Command (cont’d) Keyword appletalk tn3270 Table C-19. Keywords for the show t1 command Keyword alarmsyslog bypass ring sigproto t1_info (continued on next page) Chapter 2 Parameters ppp_acm, ppp_mru, ppp_security_protocol, ppp_ipx_network, ppp_ipx_node, ppp_username_remote, ppp_password_remote, ppp_ncp, as well as the serial parameters local_address, remote_address, address_origin,...
Page 60 Chapter 2 Conﬁguration Parameters Table C-19. Keywords for the show t1 Command (continued) Keyword tdi_distance tdi_framing tdi_line_code tni_circuit_id tni_clock tni_esf_fdl tni_framing tni_line_buildout tni_line_code tni_ones_density The parameter descriptions that follow are in alphabetical order. The Software Reference Guide on page C-269 provides a series of tables that list the parameters in functional groupings.
Page 61: A_Router
Book C a_router The Ethernet address of the network’s A_Router. The Annex uses this value as a hint at start-up. When a Routing Table Maintenance Protocol (RTMP) message arrives from this Ethernet address, the Annex gleans the AppleTalk DDP address from the packet and tries to talk to the AppleTalk router.
Page 62: Allow_Broadcast
Chapter 2 Conﬁguration Parameters Table C-20. Valid Options for address_origin Parameter Option local dhcp alarmsyslog This T1 parameter enables or disables the T1 alarm event syslogs. A Y enables alarm syslogs, an N disables it. The default is Y. allow_broadcast This asynchronous port parameter allows an asynchronous port to receive administrative broadcast messages generated by the boot and broadcast commands.
Page 63: Allow_Compression
Book C Chapter 2 Conﬁguration Parameters allow_compression This asynchronous port parameter allows the Annex to use TCP header compression on a SLIP or PPP line. Header compression occurs only if the other side of the serial link initiates compression. A Y enables this parameter, an N disables it.
Page 64: Attn_String
Chapter 2 Conﬁguration Parameters at_nodeid This asynchronous port parameter deﬁnes the node ID hint used for an ARA client during connection establishment. This parameter value is an AppleTalk address in the form net.node. The valid net values are 0 to 65534.
Page 65: Authoritative_Agent
Book C authoritative_agent This Annex parameter enables the Annex to send an ICMP Address Mask reply to a host that broadcasts a subnet mask request. A Y enables this parameter, an N disables it. The default is Y. authorized_groups This asynchronous port parameter specifies the LAT protocol remote group codes that are accessible to users on a given Annex port.
Page 66: Autodetect_Timeout
Chapter 2 Conﬁguration Parameters Book C autodetect_timeout This Annex parameter speciﬁes the maximum amount of time the Annex should wait for auto_detect mode to identify an incoming call as PPP. If the speciﬁed number of seconds is exceeded, or if the user enters a carriage return before the call is detected as PPP, the Annex places the user in CLI mode.
Page 67: Broadcast_Addr
Book C Chapter 2 Conﬁguration Parameters broadcast_addr This Annex parameter deﬁnes the IP address for Annex broadcasts. It is recommended that you set a subnet broadcast address, if possible. In this case, you set the subnet portion of the broadcast address to match the Annex subnet address, as determined by the Annex subnet mask, and you set the host portion of the broadcast address to all one-bits.
Page 68: Broadcast_Direction
Chapter 2 Conﬁguration Parameters broadcast_direction This asynchronous port parameter deﬁnes the direction in which an administrative broadcast message is sent on a port. The options are network or port; the default is port. This parameter is valid only for a slave port (deﬁned by the mode parameter).
Page 69: Char_Erase
Book C Chapter 2 Conﬁguration Parameters char_erase When this asynchronous port parameter is enabled, the Annex echoes both the character erase and the word erase characters for a video terminal; i.e., the previous character (or word) looks as if it has been erased.
Page 70: Cli_Inactivity
Chapter 2 Conﬁguration Parameters Book C cli_inactivity This asynchronous port parameter speciﬁes the amount of time in minutes that the Annex remains idle before disconnecting a CLI session from a port. Unlike the inactivity_timer, this timer does not disconnect a CLI session with active jobs.
Page 71: Cli_Security
Book C Table C-21. Formatting Codes for Annex Prompts Code cli_security This asynchronous port parameter enables user authentication by the host-based ACP server for all CLI connections. When disabled, you cannot use any Annex security mechanism other than the administrative password for CLI ports.
Page 72: Config_File
Chapter 2 Conﬁguration Parameters conﬁg_ﬁle This Annex parameter deﬁnes the ﬁle name for the conﬁguration ﬁle maintained on the load host. This ﬁle contains information about gateways, rotaries, macros, and services; it must reside in the directory / usr/spool/erpcd/bfs. The default ﬁle name is conﬁg.annex. connect_security This asynchronous port parameter enables the host-based security policy for access from the CLI to the network (using telnet and rlogin only).
Page 73: Dedicated_Arguments
Book C data_bits This asynchronous port parameter deﬁnes the number of data bits in a character. This value does not include the start, stop, or parity bits. Allowable values are 5 through 8. The default is 8. daylight_savings This Annex parameter deﬁnes the daylight savings time for your geographic location.
Page 74: Dedicated_Port
Chapter 2 Conﬁguration Parameters dedicated_port This asynchronous port parameter selects the application name or TCP port number to which this port can connect. The options are telnet, rlogin, call, or a TCP port number. The default is telnet. For more details on conﬁguring the Annex for use with dedicated ports, see Dedicated Ports on page A-62.
Page 75: Dhcp_Broadcast
Book C dhcp_broadcast This Annex parameter enables and disables the use of DHCP broadcast messages; a DHCP proxy client will use it to determine if it can generate DHCP broadcast messages as a means of “discovering” a DHCP server. The options for the parameter are Y or N, N being the default (i.e., the broadcast of DHCP messages is disabled).
Page 76: Do_Compression
Chapter 2 Conﬁguration Parameters do_compression This asynchronous port parameter starts TCP/IP header compression on a SLIP link. When enabled, the Annex negotiates for TCP/IP compression for both sides of the connection. A Y enables this parameter, an N disables it. The default is N. echo his asynchronous port parameter directs an Annex to echo all characters as a user types.
Page 77: Facility_Num
Book C Chapter 2 Conﬁguration Parameters erase_line This asynchronous port parameter deﬁnes a control character sequence for the CLI line erase character. The default is CTRL-U (^U) erase_word This asynchronous port parameter deﬁnes a control character sequence for the CLI word erase character. The default is CTRL-W (^W) facility_num This Annex parameter identiﬁes a LAT host by number.
Page 78: Forwarding_Count
Chapter 2 Conﬁguration Parameters forwarding_count This asynchronous port parameter controls Annex port behavior for received characters. When set to a number other than zero, the port does not forward characters until it receives the speciﬁed number of characters. When set to zero, the port uses the value in the forwarding_timer parameter.
Page 79: Group_Value
Book C Chapter 2 Conﬁguration Parameters group_value This Annex parameter speciﬁes the LAT protocol remote group codes that can access local services offered by an Annex. To access these services, the Annex must have at least one enabled group code that matches the service’s group codes.
Page 80: Image_Name
Chapter 2 Conﬁguration Parameters image_name This Annex parameter deﬁnes the ﬁle name containing the operational code that loads by default when you boot an Annex. The string size ranges from 0 to 100 characters. The default is a null string (""). imask_7bits This asynchronous port parameter enables an Annex to mask input to seven bits.
Page 81: Inet_Addr
Book C These setting are required because the timer does not start until one of the following events occur: inet_addr This Annex parameter deﬁnes the Annex’s IP address. This 32-bit address contains four 8-bit ﬁelds separated by periods. Each ﬁeld contains a number ranging from 0 to 255 or a hexadecimal number.
Page 82: Input_Is_Activity
Chapter 2 Conﬁguration Parameters Book C input_is_activity This asynchronous port parameter deﬁnes activity as input. When enabled, the Annex sets the inactivity timer when it receives input at the port. A Y enables this parameter, an N disables it. The default is Y. input _ start _ char This asynchronous port parameter deﬁnes the control character sequence that restarts input if the input_ﬂow_control parameter is set to start/...
Page 83: Ipx_Do_Checksum
Book C Chapter 2 Conﬁguration Parameters ip_forward_broadcast This Annex parameter allows an Annex to broadcast a packet to the SLIP or PPP interfaces. When the Annex receives a packet sent to a broadcast address (except 0.0.0.0 and 255.255.255.255), it scans the list of installed interfaces and matches the broadcast address against the interface’s remote address using a subnet or net mask.
Page 84: Ipx_Dump_Password
Chapter 2 Conﬁguration Parameters Book C ipx_dump_password This Annex parameter contains a user password for logging on to the Novell ﬁle server before the Annex sends a dump ﬁle to the server. The string size ranges from 0 to 16 characters. The default is “<unset>”. ipx_dump_path This Annex parameter speciﬁes the full pathname that stores the uploaded Annex dump image on the Novell ﬁle server.
Page 85: Keep_Alive_Timer
Book C Chapter 2 Conﬁguration Parameters ipx_security This asynchronous port parameter controls whether or not IPX security is enabled on the port. A Y enables this parameter, an N disables it. The default is N. ixany_ﬂow_control This asynchronous port parameter treats any input character as a start (XON) character, if output has been suspended by a stop (XOFF) character.
Page 86: Latb_Enable
Chapter 2 Conﬁguration Parameters lat_queue_max This Annex parameter limits the number of HIC requests that the Annex can queue. This parameter affects only the operation of HIC requests received after changing the parameter’s value and setting LAT. Allowable values range from 1 to 255 or none (entering none sets the value to 255). The default value is 4.
Page 87: Load_Broadcast
Book C load_broadcast This Annex parameter deﬁnes, during a boot, whether or not the Annex requests the conﬁguration or message-of-the-day ﬁles from other hosts on the network if any or all of the ﬁles are not available on the preferred load host.
Page 88: Local_Address
Chapter 2 Conﬁguration Parameters local_address This asynchronous port parameter deﬁnes the IP address for the asynchronous port on the Annex side of a link. This IP address is used whenever SLIP or PPP is in effect for the port (for example, because the mode parameter is set to slip or ppp, or because the mode is set to auto_detect and SLIP or PPP is detected).
Page 89: Login_Timeout
Book C login_port_password This asynchronous port parameter enables the port password when the VMS command interface is conﬁgured (i.e., when cli_interface is set to vci). A Y enables this parameter, an N disables it. The default is N. login_prompt This Annex parameter deﬁnes the prompt that appears for all ports using a VMS interface.
Page 90: Long_Break
Chapter 2 Conﬁguration Parameters long _ break This asynchronous port parameter enables an Annex to return a user to the CLI prompt after receiving a break signal of more than two seconds. When disabled, the Annex passes the break to the local application. A Y enables this parameter, an N disables it.
Page 91: Map
Book C This T1 parameter controls the mapping of the modems to the T1 Drop and Insert Interface (T1DII) and the T1 Network Interface (T1NI) DS0 channels. The modems can be mapped to any unoccupied slot on the T1NI or the T1DII. The T1NI and the T1DII can be mapped to each other on channels that are not occupied by modems.
Page 92: Map_To_Upper (Asynchronous
Chapter 2 Conﬁguration Parameters Book C map_to_upper (asynchronous) This asynchronous port parameter enables an Annex to convert lowercase characters sent to a terminal into uppercase characters. This conversion occurs only at the CLI level. Enable this parameter for older terminals that do not support upper case characters.
Page 93: Max_Vcli
Book C Chapter 2 Conﬁguration Parameters max_vcli This Annex parameter determines the maximum number of virtual CLI connections the Annex can create at a time. Allowable values are the string unlimited or a decimal number from 0 to 254. A value of 0 prevents any virtual CLI connections.
Page 94: Table C-26. Valid Options For The Mode Parameter
Chapter 2 Conﬁguration Parameters Table C-26. Valid Options for the mode Parameter Option adaptive arap auto_adapt auto_detect connect dedicated (continued on next page) Remote Annex Administrator’s Guide for UNIX Book C-76 Description Allows a port to have both slave and cli capabilities. If a connection is initiated on the serial side, the port enters cli mode;...
Page 95: Mop_Password
Book C Table C-26. Valid Options for the mode Parameter (continued) Option rlogin slave slip telnet tn3270 unused mop_password This Annex parameter contains the MOP maintenance password. In this 8-byte password, each byte consists of two hexadecimal digits. The string size ranges from 0 to 16 characters.
Page 96: Motd_File
Chapter 2 Conﬁguration Parameters Book C motd_ﬁle This Annex parameter deﬁnes the ﬁle name for the message-of-the-day ﬁle maintained on the load host. The string size ranges from 0 to 16 characters. The default ﬁle name is motd; the ﬁle resides in the directory chosen during the host installation process (typically /usr/spool/erpcd/bfs).
Page 97: Name_Server_1
Book C Chapter 2 Conﬁguration Parameters name_server_1 This Annex parameter deﬁnes the type of name service used with the primary name server. When using this parameter, you must specify a host using the pref_name1_addr. The options are dns, ien_116, or none. The default is none.
Page 98: Net_Inactivity
Chapter 2 Conﬁguration Parameters When disabled, the DSR signal is not required to connect to a slave line, and DSR is not required to activate a CLI line (see Modem Signals on page A-99 for details on using need_dsr in conjunction with modem control).
Page 99: Network_Turnaround
Book C Chapter 2 Conﬁguration Parameters To set an inactivity timer of two minutes, set: net_inactivity_units=minutes net_inactivity=2 To set an inactivity timer of 30 seconds, set: net_inactivity_units=seconds net_inactivity=30 An inactivity timer can be set to the following combinations: 0 to 4 minutes 15 seconds (= 255 seconds) in 1 second intervals 0 to 4 hours 15 minutes (= 255 minutes) in 1 minute intervals network_turnaround This Annex parameter deﬁnes the approximate number of seconds that...
Page 100: Node_Id
Chapter 2 Conﬁguration Parameters node_id This Annex parameter speciﬁes the address the Annex tries to acquire at start-up. If this address is in use, the Annex must acquire a new node ID. The node_id is an AppleTalk address in the form net.node. Valid net values are 0 to 65534;...
Page 101: Output_Is_Activity
Book C Table C-27. Valid Options for the output_ﬂow_control Parameter Option bell start/ stop both none output_is_activity This asynchronous port parameter deﬁnes activity as output. When enabled, the Annex resets the inactivity timer when it sends output from the port. If the line type is hardwired, the Annex also places an entry in the who table.
Page 102: Output_Ttl
Chapter 2 Conﬁguration Parameters Book C output _ start _ char This asynchronous port parameter deﬁnes the control character sequence that restarts output if output_ﬂow_control is set to start/stop. The default is CTRL-Q (^Q) output _ stop _ char This asynchronous port parameter deﬁnes the control character sequences that stops output if the output_ﬂow_control parameter is set to start/ stop.
Page 103: Password
Book C password This Annex parameter modiﬁes the Annex’s administrative password. This password is used for access to the superuser CLI commands and for administrative access to an Annex. It overrides the CLI lock and virtual CLI passwords. The string size ranges from 0 to 15 characters. passwd_limit This Annex parameter deﬁnes the maximum number of times a user can try to enter a password before an Annex resets the port.
Page 104: Phone_Number
Chapter 2 Conﬁguration Parameters phone_number This asynchronous port parameter deﬁnes the default phone number used with dynamic dialing on the port. This 32-character string must be compatible with the modem connected to the port. The default is a null string (""). port_password This asynchronous port parameter deﬁnes a port password for local password protection.
Page 105: Ppp_Acm
Book C ppp_acm This asynchronous port parameter (async control mask) specifies which of the first 32 bytes (0x0 to 0x1F) of the ASCII character can be sent as clear text and which should be protocol-escaped. The Annex requests the ppp_acm parameter as its local mask. If the peer rejects ppp_acm, the Annex accepts the hint if it is a superset of the Annex’s mask;...
Page 106 Chapter 2 Conﬁguration Parameters For example, the initial ACCM sent to the peer is 0x000A0001 if ppp_acm is set to 0x00000001 (i.e., the ASCII NUL character will not be sent) and the following parameters are set as indicated: Since the output ﬂow control parameters are outside the range 0–31 decimal, they do not affect the ACCM.
Page 107: Ppp_Ipx_Network
Book C Chapter 2 Conﬁguration Parameters ppp_ipx_network This asynchronous port parameter is a 4-byte, Novell network number the Annex suggests for the remote PC client on an IPXCP (IPX over PPP) link. Valid values are 00000001 to FFFFFFFF, or Leading zeroes, if any, should be included.
Page 108: Ppp_Mru
Chapter 2 Conﬁguration Parameters Book C This parameter is overridden by the network number in the remote address ﬁeld of the acp_dialup ﬁle, if that ﬁeld is conﬁgured correctly. If the node number is not set in acp_dialup or through the ppp_ipx_node parameter, and no value is suggested by the client, the Annex uses its own Ethernet address plus 1.
Page 109: Ppp_Security_Protocol
Book C ppp_sec_auto This asynchronous/synchronous parameter, used in conjunction with the ppp_security_protocol parameter, allows the use of auto_detect mode for PPP clients regardless of whether the clients support PAP/CHAP. The values for the parameter are Y or N, with N as the default. ppp_security_protocol This asynchronous port parameter deﬁnes the security check for the peer that the Annex requires before starting the network control protocol.
Page 110: Pref_Dhcp2_Addr
Chapter 2 Conﬁguration Parameters Book C pref_dhcp1_addr This optional Annex parameter speciﬁes the IP address of the DHCP server that a DHCP client will attempt to discover as the primary source for DHCP services. A DHCP client will broadcast a DHCP message when the dhcp_broadcast parameter has been set to Y.
Page 111: Pref_Name1_Addr
Book C Chapter 2 Conﬁguration Parameters pref_load_addr This Annex parameter speciﬁes the IP address for the preferred load host. This is the host to which the Annex ﬁrst requests a load of its operational code. The default is 0.0.0.0. Set this address to the boot host’s IP address. pref_mop_host This Annex parameter speciﬁes the Ethernet address of the preferred MOP load or dump host.
Page 112: Pref_Secure1_Host
Chapter 2 Conﬁguration Parameters Book C pref_secure1_host This Annex parameter speciﬁes the IP address of the security server to which the Annex ﬁrst sends security requests. This parameter works only if the enable_security parameter is set to Y. The default is 0.0.0.0. pref_secure2_host This Annex parameter speciﬁes the IP address of the host that is the back-up server if the host speciﬁed in pref_secure1_host is not available.
Page 113: Printer_Width
Book C Chapter 2 Conﬁguration Parameters printer_name This asynchronous port parameter speciﬁes the printer used by the tn3270 command’s print-screen function. You must enter a name listed in the / etc/printcap ﬁle on the remote host by the printer_host parameter (for more details, see tn3270 on page A-214).
Page 114: Ps_History_Buffer
Chapter 2 Conﬁguration Parameters Book C ps_history_buffer This asynchronous port parameter is used with the telnet command to indicate how much incoming data to buffer on a slave port. Incoming data is buffered continuously before, during, and after the Telnet session; no data buffering occurs during LAT access to the port.
Page 115: Retrans_Limit
Book C retrans_limit This Annex parameter deﬁnes the number of times an Annex retransmits a packet before notifying the LAT user about a network failure. Allowable values range from 4 to 120. The default value is 8. ring This T1 parameter provides the audible ring to the central ofﬁce for incoming calls.
Page 116: Rip_Default_Route
Chapter 2 Conﬁguration Parameters rip_advertise This Interface parameter deﬁnes the networks for which the Annex will advertise routes. Table C-29 lists the valid options; the default is all. Table C-29. Valid Options for the rip_advertise Parameter Option access_spec Uses the form [include | exclude] network_list where none rip_auth This Annex parameter contains the password that controls authentication...
Page 117: Rip_Horizon
Book C rip_horizon This Interface parameter controls the split horizon algorithm for RIP. Table C-30 describes the valid options for this parameter. The default is poison. Table C-30. Valid Options for the rip_horizon Parameter Option split poison rip_next_hop This Interface parameter speciﬁes whether or not the next hop value is included in RIP version 2 advertisements.
Page 118: Rip_Routers
Chapter 2 Conﬁguration Parameters rip_routers This Annex parameter lets you force RIP to direct periodic RIP updates to a router list rather than broadcasting updates. Valid values are the IP addresses of up to eight directly reachable routers. The Annex ignores any address that is not on an attached subnet.
Page 119: Rip_Sub_Advertise
Book C Chapter 2 Conﬁguration Parameters rip_sub_advertise This Interface parameter controls whether or not the Annex advertises subnet routes over the SLIP, PPP, and Ethernet interfaces. When enabled, subnet routes are advertised; when disabled, subnet routes are not advertised. A Y enables this parameter, an N disables it. The default is Y. routed This Annex parameter determines whether or not the RIP routing daemon is enabled.
Page 120: Server_Capability
Chapter 2 Conﬁguration Parameters server_capability This Annex parameter deﬁnes an Annex as a ﬁle server host. An Annex can provide operational code only for another Annex. Table C-33 describes the valid options; the default is none. Table C-33. Valid Options for the server_capability Parameter Option conﬁg image...
Page 121: Session_Limit
Book C session_limit This Annex parameter speciﬁes the maximum number of active sessions the Annex allows at one time. Allowable values range from 1 to 1152 or none (entering none sets the value to 1152). The default is 1152. short _ break This asynchronous port parameter allows an Annex to return a user to the CLI prompt after receiving a break of less than two seconds.
Page 122: Slip_Load_Dump_Host
Chapter 2 Conﬁguration Parameters Book C slip_allow_dump This asynchronous port parameter enables an Annex to dump its operational code across a SLIP link. A Y enables this parameter, an N disables it. The default is Y. slip_load_dump_host This asynchronous port parameter deﬁnes the IP address of the host from which an Annex receives a load or to which an Annex sends dumps over the SLIP interface.
Page 123: Slip_Tos
Annex. The value entered in this parameter must match the device’s baud rate. Allowable values are autobaud, 50, 75, 110, 134.5, 150, 200, 300, 600, 1200, 1800, 2000, 2400, 3600, 4800, 7200, 9600, 19200, 38400, 57600, and115,200. The default is 9600.
Page 124: Subnet_Mask (Port)
Chapter 2 Conﬁguration Parameters stop_bits This asynchronous port parameter speciﬁes the number of stop bits for a port. Allowable values are 1, 1.5, or 2. The default is 1. subnet_mask (Annex) This Annex parameter deﬁnes the Annex’s IP subnet mask. It is used to divide a network into subnets.
Page 125: Syslog_Facility
Book C Chapter 2 Conﬁguration Parameters syslog_facility This Annex parameter deﬁnes the local facility to which the UNIX syslogd daemon sends Annex syslog messages. Valid options are log_local0 through log_local7. The default is log_local7. If the host to which messages are logged does not support 4.3BSD logging, this parameter is ignored and messages are logged by priority level (deﬁned by syslog_mask).
Page 126: Syslog_Port
Chapter 2 Conﬁguration Parameters Table C-35. Priority Levels for the syslog_mask Parameter Priority Level Description emergency alert critical error warning notice info debug syslog_port This Annex parameter routes syslog messages to an asynchronous port where messages are time and date stamped. Valid options are 0 through the Annex’s port count.
Page 127: T1_Info
Book C Chapter 2 Conﬁguration Parameters t1_info This T1 parameter stores installation information from the service provider, such as a telephone number to call should the network go down. This parameter is limited to a 120-byte string of printable ASCII characters.
Page 128: Tcp_Keepalive (Parallel
Chapter 2 Conﬁguration Parameters Book C tcp_keepalive (parallel) This parallel printer port parameter speciﬁes the length of time a TCP connection must be idle on one or more speciﬁc printer ports. This parameter overrides the Annex tcp_keepalive parameter for connections from applications such as aprint or rtelnet to one or more printer ports.
Page 129: Telnet_Escape
Book C Chapter 2 Conﬁguration Parameters telnet_crlf This asynchronous port parameter converts a carriage return in a Telnet session to a carriage return followed by a line feed. When disabled, a carriage return translates to a carriage return followed by a null string. A Y enables this parameter, an N disables it.
Page 130: Tftp_Load_Dir
Chapter 2 Conﬁguration Parameters tftp_load_dir This Annex parameter defines the string that precedes all files (e.g., image name, configuration, and motd files) when you boot an Annex via tftp. This string’s value is determined by the system serving the tftp requests. This string does not precede the tftp_dump_name.
Page 131: Timezone_Minuteswest
Book C Chapter 2 Conﬁguration Parameters timezone_minuteswest This Annex parameter deﬁnes the time zone in which the Annex resides. Enter a positive number of minutes for time zones west of GMT, or a negative number for time zones east of GMT. For example, enter 300 for U.S.
Page 132: Tmux_Max_Host
Chapter 2 Conﬁguration Parameters Book C tmux_max_host This Annex parameter speciﬁes the maximum number of host addresses allowed in the TMux address table. If the number of host addresses exceeds the value entered here, the Annex discards the oldest entry. Allowable values are 10 through 255;...
Page 133: Tni_Esf_Fdl
Book C Chapter 2 Conﬁguration Parameters tni_esf_fdl This T1 parameter sets the T1 facilities data link (FDL) format. The FDL format is used in conjunction with the ESF format and determined by the service provider. The parameter settings include ANSI (ANSI T1.403) and AT&T (AT&T TR54016) standard formats.
Page 134: Tni_Ones_Density
Chapter 2 Conﬁguration Parameters tni_ones_density This T1 parameter is used to defeat the Annex’s ones density monitor. The Annex T1 engine has a built in ones density monitor that provides the network with the correct number of one pulses. The ones density monitor does the following: This parameter has an on and an off setting.
Page 135: Type (Parallel
Book C Chapter 2 Conﬁguration Parameters When set to dial_in, the user is registered with the who database as soon as a process (CLI or slave) attaches to the line, regardless of the input_is_activity and output_is_activity parameter settings. For dedicated ports, the Annex continuously retries the connection, regardless of errors, as long as DCD is high or modem controls are disabled.
Page 136: Type_Of_Modem
Chapter 2 Conﬁguration Parameters Book C type_of_modem This asynchronous port parameter deﬁnes a 16-byte string that speciﬁes the modem type connected to the port. The modem type indexes a modem description table that is loaded into the Annex at boot time. This string must match the type_of_modem ﬁeld in the modem section of the last read conﬁguration ﬁle;...
Page 137: Vcli_Inactivity
Book C Chapter 2 Conﬁguration Parameters vcli_inactivity This Annex parameter speciﬁes the amount of time in minutes that a virtual CLI session can remain inactive. If the speciﬁed interval of time has expired, the Annex will terminate the virtual session. The range of values for this parameter is 0 to 255;...
Page 138: Zone
Chapter 2 Conﬁguration Parameters Book C zone This Annex parameter deﬁnes the AppleTalk zone name that the Annex uses at start-up. The string size ranges from 0 to 32 characters. You must separate zone names with spaces (e.g., general pubs lab). To escape embedded spaces, use the backslash (\) character.
Page 139: Using The Cli Commands
Book C the Remote Annex. At the CLI, you enter commands that connect to hosts, manage jobs (or sessions), display and modify port parameters, and display Remote Annex and network information. The CLI provides two groups of commands – user and superuser; the superuser commands are used for Remote Annex administration.
Page 140: Cli Commands
Chapter 3 Using the CLI Commands If four consecutive squelches occur without an intervening known command or if serial errors (framing/parity) occur while the line is squelched, the Remote Annex shuts down the line for 20 seconds and syslogs: excessive errors on port n; shutting down (where n is the port number.) CLI Commands Table C-37 lists both the user and superuser CLI commands.
Page 141 Book C Table C-37. CLI Commands (continued) Command boot compact connect control dialout edit ﬁlter hangup help help –m hosts hosts (continued on next page) Chapter 3 Type Description user Puts a job in the background. superuser Reboots the Remote Annex. superuser Compresses non-volatile memory space.
Page 142 Chapter 3 Using the CLI Commands Table C-37. CLI Commands (continued) Command Type jobs kill lock modem netstat passwd ping procs queue rlogin route services slip (continued on next page) Remote Annex Administrator’s Guide for UNIX Book C-124 Description user Displays a list of current jobs.
Page 143 Book C Table C-37. CLI Commands (continued) Command stats stats –c stats –T stty t1_loopback telnet tn3270 Chapter 3 Type Description user Displays Remote Annex statistics. superuser Clears all serial line statistics to zero. user Displays T1 network interface statistics. user Displays and modiﬁes CLI port parameters.
Page 144: Table C-38. Non-Privileged Remote Annex Vms Commands
Chapter 3 Using the CLI Commands If the option_key parameter is enabled for the Remote Annex interface for VMS environments, you will also have access to the non-privileged and privileged VMS commands listed in Table C-38 and Table C-39. For more details on these commands, see the Interface for VMS Environments Administrator’s Guide and the Interface for VMS Environments User’s Guide.
Page 145: Table C-39. Privileged Remote Annex Vms Commands
Book C Table C-38. Non-privileged Remote Annex VMS Commands (continued) Command privileged set session show port show server show service Displays information about LAT services to which you can show sessions show users Table C-39. Privileged Remote Annex VMS Commands Command clear services crash...
Page 146 Chapter 3 Using the CLI Commands Table C-39. Privileged Remote Annex VMS Commands (continued) Command deﬁne port autobaud deﬁne/set/change port break deﬁne/set/change port character size deﬁne port CLI interface deﬁne/set/change port default session mode deﬁne port dsrlogout deﬁne/set/change port ﬂow control deﬁne/set/change port inactivity logout deﬁne/set/change port...
Page 147 Book C Table C-39. Privileged Remote Annex VMS Commands (continued) Command deﬁne/set/change port username deﬁne server circuit timer deﬁne server inactivity timer deﬁne server keepalive timer deﬁne server LAT key deﬁne server lock deﬁne server login password deﬁne server login prompt deﬁne server maintenance password deﬁne server...
Page 148 Chapter 3 Using the CLI Commands Table C-39. Privileged Remote Annex VMS Commands (continued) Command deﬁne server maintenance password deﬁne server MOP host deﬁne/set/change port modem control deﬁne port name deﬁne/set/change port noloss deﬁne/set/change port output ﬂow control deﬁne/set/change port parity deﬁne/set/change port password deﬁne port...
Page 149 Book C Table C-39. Privileged Remote Annex VMS Commands (continued) Command deﬁne/set/change port type deﬁne server multicast timer deﬁne server name deﬁne server number deﬁne server password limit deﬁne server privileged password deﬁne server queue limit deﬁne server retransmit limit deﬁne server security deﬁne server session limit...
Page 150: Admin
Chapter 3 Using the CLI Commands Table C-39. Privileged Remote Annex VMS Commands (continued) Command deﬁne server software initialize server set unprivileged set privileged set server all admin The superuser admin command is a local substitute for the host-resident na command, especially in stand-alone environments. The CLI admin command set provides a subset of the host-resident na command set.
Page 151: Table C-40. The Superuser Admin Command Set
Book C Table C-40. The Superuser admin Command Set Command broadcast help or ? port printer quit reset show These CLI admin commands function like their na counterparts, with the following exceptions: Description Sends a broadcast message to one or more ports. Displays the admin help screen.
Page 152 Chapter 3 Using the CLI Commands The na commands that admin does not support are: Remote Annex Administrator’s Guide for UNIX Book C-134 • Any command issued without arguments, except reset, responds with an error or usage message; the commands do not prompt for missing arguments.
Page 153: Arap
Book C Chapter 3 Using the CLI Commands arap The arap command converts a CLI line into an AppleTalk Remote Access Protocol (ARAP) connection. Resetting the port returns the CLI to its original mode. The syntax is: arap The command display looks like this: annex: arap Remote Annex switching line to ARAP.
Page 154: Table C-41. Arguments For The Superuser Arp Command
Chapter 3 Using the CLI Commands Table C-41. Arguments for the Superuser arp Command Argument Description host addr –a –d –s temp Remote Annex Administrator’s Guide for UNIX Book C-136 Displays the current ARP table entry for that host. Displays the current ARP table entry for that address. Displays all entries in the table.
Page 155: Table C-42. Arguments For The Bg Command
Book C The bg (background) command puts a job into the background and displays the job number, the CLI command that created it, and an ampersand (&) to indicate that the job is in the background. The Remote Annex forwards output generated by the background job to the terminal, if another job is active.
Page 156: Boot
Chapter 3 Using the CLI Commands Entering bg with no arguments is the same as entering bg%; it puts the most recent job into the background. The bg command display looks like this: annex: bg 2 telnet secondhost & boot The superuser boot command reboots the Remote Annex and, optionally, produces a dump of the Remote Annex’s operational code.
Page 157 Book C Table C-43. Arguments for the boot Command (continued) Argument time ﬁlename warning The following command line requests that the Remote Annex reboot an hour and ﬁfteen minutes from the time of entry: annex# boot +1:15 bootfile: <cr> warning: Shutting down for PM The Remote Annex can request its boot ﬁle from a deﬁned preferred load host.
Page 158: Compact
Chapter 3 Using the CLI Commands compact The superuser compact command consolidates all valid (in-use) records to the beginning of the non-volatile memory (EEPROM). The Remote Annex stores configuration parameters and file system records in this memory. When the amount of free space nears depletion, the Remote Annex logs a syslog warning message, and the set command may fail.
Page 159: Connect
Book C Chapter 3 Using the CLI Commands connect The connect command uses the LAT protocol to connect to an advertised LAT service. This command is available only if you have enabled LAT by setting the lat_key parameter correctly. The syntax is: connect service [hostname [port]] If you enter the command without arguments, the connect command returns a missing service name error.
Page 160: Table C-44. Arguments For The Superuser Control Command
Chapter 3 Using the CLI Commands If the port is not a CLI port, or has not been opened as a slave port from a host, the command displays Device must be in use. Table C-44. Arguments for the Superuser control Command Argument port dtr–...
Page 161: Dialout
Book C The source_filename is the file to be copied; the destination_filename is the new file. The Remote Annex overwrites the destination file if it exists; it reports an error if the source file does not exist. dialout The superuser dialout command displays each dial-out route along with all of the deﬁned parameters for each route, as well as all deﬁned chat scripts.
Page 162: Edit
Chapter 3 Using the CLI Commands Route do131: mode: ppp remote_address: 131.110.0.13 net_inactivity: 10 phone_number: "92050111" allow_compression: Y subnet_mask: 255.255.255.248 ppp_ncp: ipcp rip_sub_advertise: Y rip_advertise: all advertise: Y ports: 1-2 filter: in exclu proto udp src_port router netact filter:out exclu proto udp src_port router netact The dialout do route_number command display looks like this: annex# dialout do44 Route do44:...
Page 163: Table C-45. Arguments For The Fg Command
Book C The fg (foreground) command resumes a job that has been suspended or placed in the background. If the Remote Annex saved any output from the host while the job was interrupted, the output appears on the terminal immediately after reconnecting. Otherwise, nothing appears until you enter a carriage return.
Page 164: Filter
Chapter 3 Using the CLI Commands ﬁlter The superuser ﬁlter command allows you to ﬁlter the trafﬁc that crosses the Remote Annex. It affects both the currently running conﬁguration and the conﬁguration stored in non-volatile memory. The ﬁlter command has eight subcommands: add, list, enable, disable, delete, help, usage, and quit.
Page 165: Hangup
Book C hangup The hangup command terminates all of your jobs, resets the CLI for the port, and drops the modem control signal DTR; it restores the default terminal characteristics defined for the port. Also, entering the hangup command at the CLI prompt disconnects a virtual connection to another Remote Annex.
Page 166: Help -M
Chapter 3 Using the CLI Commands help –m The superuser help –m command displays a list of all macros and their assigned port_set for that Remote Annex. The syntax is: help –m [macro_name] The help –m display looks like this: annex01# help –m Name ==========================================================...
Page 167: Hosts
Book C In the previous sample display, the Command List ﬁeld applies only to menus: it lists the commands available from the menu. The following conditions may restrict command access: hosts The hosts command displays the names and addresses of hosts and other Remote Annexes listed in the Remote Annex’s host table (known hosts).
Page 168: Table C-46. Arguments For The Hosts Command
Chapter 3 Using the CLI Commands Table C-46. Arguments for the hosts Command Argument –q –n host Table C-47. Status Field Deﬁnitions Field down? down Remote Annex Administrator’s Guide for UNIX Book C-150 Description Displays only the names of known hosts. Displays data from the Remote Annex’s list of name server hosts, rather than the list of all hosts, as well as the default domain and domain search list contents.
Page 169: Table C-48. Arguments For The Superuser Hosts Command
Book C hosts The superuser hosts command provides information about hosts and name servers. Table C-48 describes the arguments for hosts. The syntax hosts [–qaffn] [host...] Table C-48. Arguments for the Superuser hosts Command Argument –q –an host –f host –ff host –fn –fn ip_address...
Page 170: Ipx
Chapter 3 Using the CLI Commands The ipx command conﬁgures a CLI port for IPX usage, while leaving the port mode set to cli. This command allows IPX administrators to take full advantage of security features such as SecurID and Enigma. When a Fastlink II user in terminal mode logs into a Remote Annex CLI port, the Remote Annex authenticates the user according to the value of the cli_security parameter and the conﬁguration of Remote Annex security...
Page 171: Kill
Book C kill The kill command terminates a connection and ends a job. The Remote Annex accepts up to four arguments to kill multiple jobs. Table C-49 describes the arguments for kill. The syntax is: kill [%] [%, +, –, n, hostname] ... Entering the kill command without arguments kills the most recent job and displays the job number and the CLI command that created it: annex: kill...
Page 172 Chapter 3 Using the CLI Commands A Key prompt appears after the port is locked and remains until you enter the correct password. For example annex: lock Key: Again: Remote Annex port 3 locked Key: The lock command permits you to define a time-out. This is the amount of time in minutes that the port is locked.
Page 173: Modem
Book C The self-boot image ﬁle name is a special case: the image’s revision information is also displayed. Since the directory is part of the ﬁle system, it is displayed along with the other ﬁles (the directory’s name is “.”). modem The superuser modem command lists the modem types supported by the Remote Annex.
Page 174 Chapter 3 Using the CLI Commands Sample displays for the modem, modem –a, and modem –l commands look like this: annex# modem annex#modem –a annex# annex# modem –l annex# Remote Annex Administrator’s Guide for UNIX Book C-156 type_of_modem S1200 type_of_modem USR_144 type_of_modem S1200...
Page 175: More
Book C more The superuser more command provides a read-only mechanism for reviewing files in the local file system. The syntax is: more ﬁlename The ﬁle is displayed from the beginning to the end. This command pauses after every 23 newline characters and prompts the user to press a key. Pressing q or the attention key cancels the command;...
Page 176: Netstat
Chapter 3 Using the CLI Commands netstat The netstat command displays statistics and information that the Remote Annex has obtained from the network. The command is similar to the UNIX netstat command in format and display, but offers additional options. Table C-51 describes the arguments for netstat. The syntax is: netstat [–AaCfgimnpQRrSstx[–i | –r [network_number] | –sS [server_name] | ? | –m] z] port The display format varies according to the options selected and the...
Page 177: Table C-51. Arguments For The Netstat Command
Book C Table C-51. Arguments for the netstat Command Argument Description –A –a –C –i –ia port –ip port –iQ –iS –f –g –m –n –R –r –ra –ri (continued on next page) Chapter 3 Displays the default information along with the address of any associated protocol control blocks.
Page 178: Displays The Network Zone List For Appletalk
Chapter 3 Using the CLI Commands Table C-51. Arguments for the netstat Command (continued) Argument –s –rs –t –x –xi –x? –xm –xr –xr network_ number –xs –xs server_ name –xS –xS server_ name –z Remote Annex Administrator’s Guide for UNIX Book C-160 Description Displays network protocol statistics.
Page 179: Passwd
Book C passwd The superuser passwd command changes the Remote Annex’s administrative password. The Remote Annex does not echo passwords. Pressing the Return key after the prompts for the new password sets the password back to its default. The syntax is: passwd The passwd command display looks like this: annex# passwd...
Page 180: Table C-52. Arguments For The Superuser Ping Command
Chapter 3 Using the CLI Commands The syntax is: ping [–artv] host [databytes [count]] Table C-52. Arguments for the Superuser ping Command Argument –a –r –t –v host databytes count Remote Annex Administrator’s Guide for UNIX Book C-162 Description Generates AppleTalk Echo Protocol (AEP) echo request packets to a target node.
Page 181 Book C Chapter 3 Using the CLI Commands Each Echo Request includes a time stamp if the number of data bytes is greater than eight. This time stamp calculates the round-trip time and is returned unchanged in the Echo Response. The default packet size is 64 bytes, 56 of which are data and 8 are header.
Page 182: Sample Displays Using The -A And -V Options
Chapter 3 Using the CLI Commands Book C If zinc (in the previous example) is on another network, ping displays the following: annex# ping zinc PING zinc: 56 bytes of data ---- zinc PING Statistics ---- Host is unreachable... Received from 132.254.55.11 annex# In the preceding example, 132.254.55.11 is the router connecting the local network to other networks.
Page 183 Book C Chapter 3 Using the CLI Commands In the preceding display, the 4-byte hexadecimal numbers in the line beginning x00 through the line beginning x10 represent the IP header, while the remaining hexadecimal numbers represent the ICMP header and data. The bytes in the header lines are displayed in reverse order, so read them from right to left.
Page 184 Chapter 3 Using the CLI Commands The traceroute message indicates whether or not the packet was forwarded. If so, the message includes the incremented hop count and information about the interface over which the packet was forwarded. If the packet could not be forwarded, the router discards it, ping –t terminates, and the traceroute message contains zeros in place of interface information.
Page 185: Table C-53. Fields Displayed By The Ping -T Option
Book C Table C-53. Fields Displayed by the ping –t Option Field Router Hops Speed Chapter 3 Deﬁnition The direction in which the ICMP packet is heading. The >>> symbols indicate an outbound packet heading towards the ping –t destination. The <<< symbols indicate a return packet heading back towards the ping –t source.
Page 186 Chapter 3 Using the CLI Commands The sample topology shown in Figure C-2 is assumed by the ping –t examples that follow it. ping -t source Figure C-2. Topology for ping –t Examples Given the topology in Figure C-2, the ping –t command displays output such as the following when a traceroute packet passes successfully to the ping –t destination and back (see Table C-54).
Page 187: Table C-54. The Ping -T Command Display
Book C Table C-54. The ping –t Command Display Line line 1 line 2 line 3 line 4 line 5 line 6 line 7 Chapter 3 Description Indicates that ping –t has started. Contains the display header. Indicates that Router 1 was the packet’s ﬁrst hop on the path to the ping –t destination.
Page 188: Ppp
Chapter 3 Using the CLI Commands In the following example, the second router is unable to forward the outbound packet, as indicated by the asterisks (***) under the Dir heading. Note that the hop count remains at 1, since the packet crossed only one router.
Page 189: Procs
Book C procs The superuser procs command displays information about Remote Annex processes in a tabular format. It is used for debugging Remote Annex software. Table C-55 describes the arguments for procs; Table C-56 describes the fields in the procs command display; and Table C-57 describes the Remote Annex processes.
Page 190: Table C-56. The Superuser Procs Command Display
Chapter 3 Using the CLI Commands Table C-56. The Superuser procs Command Display Command PPID STACK SSIZ USPTR CTIME CPU TIME NAME Remote Annex Administrator’s Guide for UNIX Book C-172 Description Process ID in decimal. Parent process ID in decimal. Status: S (sleeping), W (semaphore wait), R (runnable), X (executing –...
Page 191: Table C-57. Remote Annex Processes
Book C Table C-57. Remote Annex Processes Process adm_timer connect_rdr connect_wtr dp_mon erpcd ﬁngerd_lis line_adm arap atalkd netdattimer ping p_srvr_conv reset_mach rlogin_rdr rlogin_wtr root (continued on next page) Chapter 3 Purpose Watches serial ports for activity (idle timer, inactivity timer). One per active CLI.
Page 192: Queue
Chapter 3 Using the CLI Commands Table C-57. Remote Annex Processes (continued) Process routed rwhod slip snmpd syslog_port telnet_cmd telnet_rdr telnetd_lis telnetd_rdr telnetd_wri timed watcher queue The queue command displays information about queued HIC requests or removes a particular HIC request from the queue. It is available only after LAT is conﬁgured.
Page 193: Table C-58. Arguments For The Queue Command
Book C Table C-58. Arguments for the queue Command Argument Description –h –s –p –r –v Entering the command without arguments displays all the requests in the queue. For each entry, queue displays the service_name and the port_number requested (if specified), the host requesting the service, the entry_id assigned to each queued request, the time (in minutes) that the request has been waiting in the queue, and the request’s position in the queue.
Page 194: Rlogin
Chapter 3 Using the CLI Commands The following example shows a display using queue –h host_name: annex: queue –h vax_marketing position in queue host (from) The following example shows a display using queue –r entry_id: annex: queue –r 538 Entry 538: removed The following example shows a display using queue –v: annex: queue –v Service Name...
Page 195: Route
Book C The superuser rm command deletes one or more files in the local file system. The syntax is: rm ﬁlename ... The Remote Annex reports an error if a speciﬁed ﬁle does not exist, and continues with the next ﬁle name in the list. route The superuser route command adds routes to and deletes routes from the RIP route cache and active routing table.
Page 196: Table C-59. Arguments For The Superuser Route Command
Chapter 3 Using the CLI Commands Added routes are either temporary or hardwired. For more details on routing, see IP Routing on page A-169. Table C-59. Arguments for the Superuser route Command Argument –f –F –fF –s (continued on next page) Remote Annex Administrator’s Guide for UNIX Book C-178 •...
Page 197 Book C Table C-59. Arguments for the Superuser route Command (continued) Argument default dest mask gateway metric delete Chapter 3 Description Speciﬁes the default route. In general, using route to add or delete a default route can have unpredictable results. The only time you can safely use route to add a default route is when a default route is not deﬁned in the conﬁguration ﬁle and the Remote Annex is not...
Page 198: Services
Chapter 3 Using the CLI Commands services The services command displays information about available LAT services that have been advertised by LAT hosts. The format of this display depends on the arguments and information that you supply on the command line. Table C-60 describes the arguments for services; Table C-61 describes the command display.
Page 199 Book C Table C-60. Arguments for the services Command (continued) Argument –h –vh –h host_name –vh host_name If multiple services have the same name, the summary includes only the service of the highest rating. For example: annex: services Local Server Name : ALPHA Service Name TERMINAL DA08...
Page 200: Table C-61. The Services Command Display
Chapter 3 Using the CLI Commands The following example displays services –h: annex: services –h wpvax Local Server Name : ALPHA Host Name : WPVAX The following example displays services –vh: annex: services –vh wpvax Local Server Name: ALPHA Host Name Host Status Table C-61.
Page 201: Slip
Book C Table C-61. The services Command Display (continued) Field Host Identiﬁcation Host Status Facility Number slip The slip command allows a user at a remote host to dial into a modem attached to the Remote Annex and convert the CLI port to a SLIP interface.
Page 202: Stats
Chapter 3 Using the CLI Commands If you issue the slip command, and the port is not configured properly for SLIP, the terminal displays This port cannot be used for SLIP (for more details on using a SLIP link, see Serial Line Internet Protocol (SLIP) on page A-137).
Page 203 Book C Table C-62. Arguments for the stats Command (continued) Argument Description –m time –p –o The stats command display looks like this: annex: stats S/W Version: Remote Access Rx.x Build #2: Thu Sep 14 20:37:27 EDT 1995 H/W: Remote Remote Annex 4000 Comm: eth-aui&twi/64asy/1par Boot from: 132.245.88.5 Image: oper.46.enet...
Page 204 Chapter 3 Using the CLI Commands Memory: annex: The stats –s command displays statistics for all serial ports: annex01# stats –s total The stats –m command displays statistics for active control lines, but displays the modem controls for all active and inactive control lines rather than displaying idle.
Page 205: Stats -C
Book C The stats –o command displays the status of the keyed options and the disabled modules: annex01# stats –o KEYED OPTIONS: LAT: Atalk: tn3270: dialout/RIP/filtering: IPX: MODULES DISABLED: The stats –p command displays statistics for all parallel ports: annex01# stats –p total stats –c The superuser stats –c command clears the serial line statistics to zero.
Page 206: Table C-63. Arguments For The Stats -T Command
Chapter 3 Using the CLI Commands Table C-63. Arguments for the stats -T Command Argument current total interval _set clear_alarm All T1 statistics are captured in 15-minute periods. Information on intervals being captured is kept in “current.” Once the 15-minute interval expires, the information in “current”...
Page 207 Book C The stats -T current command display looks like this: annex# stats -T current alarm history:[no blue no red no yellow], Fri July 28 16:48:37 1995 EDT Alarms: engine: offline serial number: circuit ID: T1 info: unit ID: XYLOGICS T1-ENGINE 085234 Rev. A 07/19/95 6343 loopback mode: No loopback number of valid seconds: bursty errored seconds (ESF only):0Controlled slip seconds:0...
Page 208: Table C-64. The Stats -T Command Display
Chapter 3 Using the CLI Commands Table C-64. The stats -T Command Display Field Sync Loss of Signal Blue Alarm Red Alarm Yellow Alarm (continued on next page) Remote Annex Administrator’s Guide for UNIX Book C-190 Description When Sync is true, the T1 engine is detecting frame synchronization.
Page 209 Book C Table C-64. The stats -T Command Display (continued) Field Loopback Online Up Time Serial Number Circuit ID Unit ID (continued on next page) Chapter 3 Description The loopback status has the following possible states: None - There is no loopback in progress. The test LED on the front panel is not illuminated.
Page 210 Chapter 3 Using the CLI Commands Table C-64. The stats -T Command Display (continued) Field DII Sync Interval Number of Valid Seconds Number of 15-minute Periods Bursty Errored Seconds Controlled Slip Seconds Errored Seconds Severely Errored Seconds Unavailable Seconds (continued on next page) Remote Annex Administrator’s Guide for UNIX Book C-192 Description...
Page 211 Book C Table C-64. The stats -T Command Display (continued) Field Out of Frame Errors BiPolar Violations CRC Errors Controlled Slips A CS is the occurrence of a replication or deletion of a Receive Network Alarm Seconds Chapter 3 Description An Out of Frame (OOF) event begins when any two of four consecutive frame synchronizing bits received from the network interface are incorrect.
Page 212: Stty
Chapter 3 Using the CLI Commands stty Using the stty command, which is similar to the UNIX stty command, you can display and change port parameters that control terminal characteristics, CLI connection options, and special characters. The syntax is: stty [parameter [value]] Table C-65 describes the parameters that can be set using the stty command;...
Page 213 Book C You can modify these parameters using the stty command. Rebooting the Remote Annex, resetting the port, or issuing a hangup command returns the parameters to their original values. There are several ways to enter a new parameter value: To undefine or turn off a parameter that requires a value, enter one of the following values along with the parameter: •...
Page 214: Table C-65. Setting Parameters Using Stty
Sets the serial line speed for input and output. Possible values are: 75, 110, 134.5, 150, 200, 300, 600, 1200, 1800, 2000, 2400, 3600, 4800, 7200, 9600, 19200, 38400, 57600, 115200. The default is 9600. Deﬁnes the data bits per character, not including the start bit, stop bits, or the parity bit (if any).
Page 215 Book C Table C-65. Setting Parameters Using stty (continued) Parameter broadcast –broadcast cera character climask7 crtcera –crtcera crtlera –crtlera (continued on next page) Chapter 3 Description Enables the terminal to display Remote Annex administrative messages. Setting the parameter –broadcast prevents any display of administrative messages. The default is broadcast.
Page 216 Chapter 3 Using the CLI Commands Table C-65. Setting Parameters Using stty (continued) Parameter echo –echo ﬂush character forw string iﬂow argument (continued on next page) Remote Annex Administrator’s Guide for UNIX Book C-198 Description Controls the echoing of characters as they are typed. Setting –echo turns off echoing.
Page 217 Book C Table C-65. Setting Parameters Using stty (continued) Parameter imask7 –imask7 ilower –ilower ixany –ixany lbreak –lbreak ldisp character ixany –ixany lbreak –lbreak ldisp character (continued on next page) Chapter 3 Description Enables clearing the eighth bit of received characters. This parameter has no effect on transmitted characters.
Page 218 Chapter 3 Using the CLI Commands Table C-65. Setting Parameters Using stty (continued) Parameter lera character newlin –newlin oﬂow argument (continued on next page) Remote Annex Administrator’s Guide for UNIX Book C-200 Description Sets the line erase character. The default is Deﬁnes the terminal as a new line terminal, which sends a carriage return followed by a line feed when Return is pressed and displays a carriage return...
Page 219 Book C Table C-65. Setting Parameters Using stty (continued) Parameter olower –olower ostartc character ostopc character Sets the stop output character. The default is parity argument prompt code (continued on next page) Chapter 3 Description Controls case conversion for characters sent from the Remote Annex to the terminal.
Page 220 Chapter 3 Using the CLI Commands Table C-65. Setting Parameters Using stty (continued) Parameter stopb argument tabs –tabs term string tesc character fwdtimer time user name wera character Remote Annex Administrator’s Guide for UNIX Book C-202 Description The string port. A space.
Page 221: Table C-66. Displaying Parameters Using Stty
Book C Table C-66. Displaying Parameters Using stty Parameter cliidletimer time control_lines argument idletimer time isize value signal value Chapter 3 Description Displays the number of minutes for a no jobs timer in which the CLI hangs up when the last CLI session exits.
Page 222: T1_Loopback
Chapter 3 Using the CLI Commands When entered in superuser mode, the superuser su command returns you to the user CLI and requires no password. t1_loopback The superuser t1_loopback command places the T1 engine into loopback mode. None of the loopback conditions persist through a power down or reboot.
Page 223: Tap
Book C Table C-67. Arguments for the T1_Loopback Command Argument None Line Payload Local The superuser tap command displays input and output on a device attached to a specific port. Any input from the port performing the tap is inserted into the tapped port’s input stream. Table C-68 describes the arguments for tap.
Page 224 Chapter 3 Using the CLI Commands Book C Entering the tap command without the port argument displays the message CLI: Destination address required; entering the tap port command without additional arguments displays any output to the port on the terminal. Keystrokes from the terminal are interpreted as if they are typed on the port.
Page 225: Table C-68. Arguments For The Superuser Tap Command
Book C Table C-68. Arguments for the Superuser tap Command Argument Description –a –k –s –v –x port Chapter 3 Use ANSI enhanced display mode escape sequences instead of angle brackets for highlighting all input displayed by –k. For printing characters, the escape sequence 033 133 061 155 octal (ESC [ 1 m) is output instead of <;...
Page 226: Telnet
Chapter 3 Using the CLI Commands telnet The telnet command establishes a telnet connection between two ports on two machines. Table C-69 describes the arguments for this command; Table C-70 describes the commands that you can issue using telnet. The syntax is: telnet [–lrst] [host [port]] Table C-69.
Page 227 Book C Chapter 3 Using the CLI Commands If you enter the command without arguments, telnet enters command mode and displays the Telnet prompt. After connecting to the remote host, telnet prints a message called a connect banner, which displays the Telnet escape character.
Page 228: Table C-70. Issuing Commands Using Telnet
Chapter 3 Using the CLI Commands If a foreign port is not speciﬁed, telnet defaults to port 23. The local port is chosen to represent the user location as follows: Table C-70. Issuing Commands Using telnet Command close display mode type [echo] open [–rt] host [port] (continued on next page) Remote Annex Administrator’s Guide for UNIX...
Page 229 Book C Table C-70. Issuing Commands Using telnet (continued) Command quit status send [arguments] set [special character] (continued on next page) Chapter 3 Description Closes any open telnet session and exits telnet. Displays the current status of telnet. Sends one or more special character sequences to the remote host.
Page 230 Chapter 3 Using the CLI Commands Table C-70. Issuing Commands Using telnet (continued) Command toggle argument (continued on next page) Remote Annex Administrator’s Guide for UNIX Book C-212 Description Sets the eof character to be sent to the host (if Telnet is operating in line-by-line mode).
Page 231 Book C Table C-70. Issuing Commands Using telnet (continued) Command (continued on next page) Description crlf Toggles carriage return-line feed mode.When enabled, a carriage return received from the serial port is encoded as a Telnet protocol carriage return-line feed end-of-line sequence. When disabled, a carriage return received is encoded as a Telnet protocol carriage return-null carriage-return sequence.
Page 232: Tn3270
Chapter 3 Using the CLI Commands Table C-70. Issuing Commands Using telnet (continued) Command ? [command] tn3270 The tn3270 command is a variation of telnet that allows you to log on to an IBM host from an ASCII terminal attached to the Remote Annex. The IBM host to which you connect can be running either the Virtual Machine/ Conversational Monitor System (VM/CMS) or the Multiple Virtual Systems (MVS).
Page 233: Table C-71. Arguments For The Tn3270 Command
Book C Table C-71. Arguments for the tn3270 Command Argument Description host port Once it has opened a connection to a host, tn3270 displays a connect banner. The remote host then displays its own connect banner and prompts you to log on: annex: tn3270 132.345.254.3 Trying...
Page 234 Chapter 3 Using the CLI Commands Entering the tn3270 command puts the Remote Annex in tn3270 command mode and displays the tn3270 prompt: annex: tn3270 tn3270: In tn3270 command mode, you can issue the commands shown in Table C-74 on page A-225. ASCII Terminal Requirements and Setup An ASCII terminal connected to the Remote Annex must have the following characteristics in order to use tn3270:...
Page 235 Book C tn3270 uses the standard UNIX ﬁle termcap to determine whether or not a particular terminal type has these features. An administrator must make termcap accessible to tn3270 and ensure that the terminals using tn3270 have terminal types listed in this ﬁle (see Conﬁguration Checklist on page A-226).
Page 236: Table C-72. Print-Screen Parameters Set Using Stty And Na/Admin
Chapter 3 Using the CLI Commands Table C-72. Print-screen Parameters Set Using stty and na/admin stty printer name printhost ip_addr Terminal Emulation To make an ASCII terminal emulate a 3278 terminal, tn3270 simulates the special 3278 keys. For example, a 3278 terminal has a key labeled EEOF that erases the contents of the current ﬁeld from the location of the cursor to the end of the ﬁeld.
Page 237 Book C Figure C-3 shows part of a map3270 entry that applies to six terminal types – avt, vt100, etc. Each deﬁnition begins with a reserved name, such as enter, identifying the IBM key or function. Not all key names listed in a map3270 file refer to actual keys on a 3278 keyboard (Table C-73 on page A-221 describes the key names).
Page 238 Chapter 3 Using the CLI Commands From an ASCII terminal in tn3270 emulation mode, you enter key sequences as follows: For more information on how to set up a VT100-type terminal to use special keys, see Conﬁguration Checklist on page A-226. Remote Annex Administrator’s Guide for UNIX Book C-220 •...
Page 239: Table C-73. Default Key Mappings For Tn3270
Book C In reality, it is not likely that you would be required to type a three-character escape sequence, because most of these sequences are mapped to special keys such as the those on the numeric keypad. For example, on a VT220 terminal that has Keypad mode set to Application, you can send the sequence \EOM by pressing the Enter key.
Page 240 Chapter 3 Using the CLI Commands Table C-73. Default Key Mappings for tn3270 (continued) IBM 3270 Key Name Command Keys (continued) LEFT RIGHT DOWN HOME Editing Keys DELETE EEOF EINP INSRT Program Function Keys PFK1 – PFK9 PFK10 PFK11 PFK12 PFK13 PFK14 PFK15...
Page 241 Book C Table C-73. Default Key Mappings for tn3270 (continued) IBM 3270 Key Name PFK16 PFK17 PFK18 PFK19 PFK20 PFK21 PFK22 PFK23 PFK24 Program Attention Keys Local Control Keys ESCAPE FLINP MASTER_R ESET RESHOW RESET (continued on next page) Chapter 3 ASCII Key Sequence ESC $ or ESC [ $ or ESC O $ ESC % or ESC [ % or ESC O %...
Page 242: Tn3270 Command Mode
Chapter 3 Using the CLI Commands Table C-73. Default Key Mappings for tn3270 (continued) IBM 3270 Key Name FERASE SYNCH TREQ XOFF tn3270 Command Mode Table C-74 shows the commands you can issue in tn3270 command mode. Enter this mode in one of two ways: 1) by entering the escape character while you are connected to a host, or 2) by issuing the CLI tn3270 command with no arguments.
Page 243: Table C-74. Commands Used In Tn3270 Command Mode
Book C Table C-74. Commands Used in tn3270 Command Mode Command close open [host [port]] quit status <CR> ? [command] Chapter 3 Description Closes the connection to the remote host and returns you to the CLI prompt. On the Remote Annex, this method of ending a connection is equivalent to using quit (see Ending a tn3270 Session on page A-226).
Page 244: Ending A Tn3270 Session
Chapter 3 Using the CLI Commands Ending a tn3270 Session The best way to end a tn3270 session is to issue the CMS or MVS LOGOFF command This closes the connection in the most orderly fashion and returns you to the CLI command level.
Page 245 Book C During this process, tn3270 broadcasts for map3270 and termcap – even if the Remote Annex load_broadcast parameter is set to N. If tn3270 follows the conﬁgured load-dump sequence but still cannot ﬁnd map3270 and termcap, it uses default, compiled versions of the ﬁles that are built into the Remote Annex’s operational image.
Page 246 Chapter 3 Using the CLI Commands Remote Annex Administrator’s Guide for UNIX Book C-228 Use the following procedure to perform the two functions just described: • Use the terminal’s set-up utility or edit termcap to set the terminal’s control codes to 7 bits and (optionally) to specify a terminal model number that supports a numeric keypad.
Page 247 Book C To set emulation mode to VT300 7 bit, enter: \E[63;1”p Do not confuse control sequence length with data bits (which can also be set to 7 or 8 via the set-up utility). The latter is a hardware parameter that speciﬁes the number of bits per character the terminal transmits.
Page 248 Chapter 3 Using the CLI Commands Remote Annex Administrator’s Guide for UNIX Book C-230 If you plan to use the IBM print-screen function: • Use na, admin, or an SNMP directive to set the Remote Annex port parameters printer_host, printer_name, and user_name for each port that is to use tn3270.
Page 249: Who
Book C The who command displays information on the current users of the Remote Annex’s ports. This command also displays current users on other Remote Annexes, and on remote hosts, if those hosts have fingerd running for who @host. The command accepts one or more arguments. The syntax is: who [[h=]host | [u=]user |[p=]port | @host |user@host | –l @host] If you enter the command without arguments, who displays a list of all...
Page 250: Table C-75. Arguments For The Who Command
Chapter 3 Using the CLI Commands Table C-75. Arguments for the who Command Argument [h=]host [u=]user [p=]port @host user@host –l @host Remote Annex Administrator’s Guide for UNIX Book C-232 Description A single host or multiple hosts displayed in the Address column, or with a job entry in the User column.
Page 251: Table C-76. The Who Command Display
Book C Table C-76. The who Command Display Field Port What User Location When Idle Address Description The number for the serial port; vnn indicates a VCLI connection. One of the following connection types: The port is deﬁned as a CLI port and was opened by a device connected to the port or by a connection from a host as a virtual CLI.
Page 252 Chapter 3 Using the CLI Commands Book C Remote Annex Administrator’s Guide for UNIX Book C-234...
Page 253: Utilities
Book C aprint The aprint utility sends files directly to an Annex printer connected to either the parallel or serial line port. The aprint utility can be used as a direct command or integrated with the standard host print-spooling mechanis aprint [–Aannex [–Lline]] [–f] [–Fstring] [–pprinterport] [ﬁlename...] his chapter describes the following Annex utilities and daemons: •...
Page 254: Table C-77. Supported Arguments For Aprint
Chapter 4 Utilities Table C-77. Supported Arguments for aprint Argument –Aannex –Lline –f –Fstring –pprinterport ﬁlename The aprint utility provides the following error messages: Remote Annex Administrator’s Guide for UNIX Book C-236 Description The name or Internet address of the Annex to which the printer is attached.
Page 255 Book C • Host system conﬁguration error can’t get service to printer /etc/services should have an entry like: printer 515/tcp • Initialization errors –Aannex not found on network: can’t find host address for Annex “annexname” –L# port is in use or disabled: Annex can’t access requested printer Old style –Pprinter not found in /etc/printcap: unknown printer NAME...
Page 256 Chapter 4 Utilities Book C Network error occurred while sending form-feed after last ﬁle: error sending final formfeed to Annex Network errors occurred while establishing contact with Annex: error during Annex port select error during wait for ACK after port select Network error occurred while waiting for acknowledgment of print job completion from Annex: error during wait for final ACK...
Page 257: Erpcd
Book C erpcd The erpcd, or expedited remote procedure call daemon, responds to all Annex boot, dump, and ACP security requests. This daemon contains two programs: Table C-78 lists the arguments for erpcd. The syntax is: /etc/erpcd [ [–D[level]] [–c [maxnumber] [–d [udpport][–f [directory]\ [max_total]\ When operational code is being downloaded to Annexes, a minimum of one host, accessible to an Annex, must be running erpcd with the bfs...
Page 258: Table C-78. Supported Arguments For Erpcd
Chapter 4 Utilities For more details on installing erpcd, see 1) Setting Up the File Server on page A-344, and 2) the Annex Installation Notes. For more details on using the acp_userinfo ﬁle, see Creating the acp_userinfo File on page A-454. For more information on blacklisting, as enabled through the –b, –x, and –g arguments, see Overview of Blacklisting on page A-491 and Conﬁguring Blacklisting on page A-493.
Page 259 Book C Table C-78. Supported Arguments for erpcd (continued) Argument –u f ilename –b max_con (continued on next page) Description Invokes the acp_userinfo ﬁle syntax checker on the ﬁle designated by ﬁlename. If ﬁlename is omitted, stdin is used. Running this option does not interfere with any other erpcd running on the system.
Page 260: Default User Name And Password Verification
Chapter 4 Utilities Table C-78. Supported Arguments for erpcd (continued) Argument –x max_total –g period Default User Name and Password Veriﬁcation The Annex supports both native and proprietary support routines and integrated passwd and passwd/shadow ﬁles (for more details, see Encrypting Security Messages on page A-436 and Modifying the Supplied Security Application on page A-546).
Page 261 Book C Chapter 4 Utilities When the proprietary routines are used for reading and writing ﬁles, these ﬁles are called acp_passwd and, if enabled, acp_shadow; they are located in the installation directory. When the native routines are used (selected with –DNATIVEPASSWD and/or –DNATIVESHADOW), erpcd queries the standard library routines for validating user passwords.
Page 262: Rtelnet
Chapter 4 Utilities rtelnet The rtelnet daemon establishes a Telnet connection between a serial line on the Annex and a character special file on the host (/dev file). Table C-79 describes the arguments for rtelnet. The syntax is: rtelnet [–abcdfhkmnoprstCDFOPRTV] [-lﬁle] [-uuser] [-Mmode] annex_id annex_port /dev/new_dev_name The rtelnet utility runs on top of the pseudo-terminal facility provided by UNIX hosts.
Page 263: Table C-80. Supported Arguments For Rtelnet
Book C Table C-80. Supported Arguments for rtelnet Argument Description –f –h –k –lﬁle –m –n –o –p –r –s –t (continued on next page) Opens network connection when the slave pseudo-device is opened. Use in conjunction with –m to ensure that rtelnet drops the connection when the slave device is not in use.
Page 264 Chapter 4 Utilities Table C-80. Supported Arguments for rtelnet (continued) Argument –uuser –C –D –F –Mmode –O –P –R –T –V annex_id annex_port device_name Remote Annex Administrator’s Guide for UNIX Book C-246 Description Change UID to <user> before creating pseudo-device. Don't try to ﬁx cooked-mode pseudo-device problems with LF insertion.
Page 265: Software Reference Guide
Book C information about the Annex. Conﬁguration Parameters Software Reference Guide his section consists of a series of tables that provide the following • Table C-81 on page A-249 is a list of all conﬁguration parameters. • Table C-82 on page A-279 is a list of Annex parameters. •...
Page 266 Chapter 5 Software Reference Guide Commands Miscellaneous Remote Annex Administrator’s Guide for UNIX Book C-248 • Table C-93 on page A-311 is a list of PPP-speciﬁc asynchronous port parameters. • Table C-94 on page A-313 is a list of SLIP-speciﬁc asynchronous port parameters.
Page 267: Table C-81. All Parameters
Book C Table C-81. All Parameters Parameter a_router acp_key address_origin alarmsyslog allow_broadcast allow_ compression Chapter 5 Values Default hexadecimal 00-00-00-0 ethernet address 0-00-00 <unset> or <unset> a string local, acp, dhcp local Y or N Y or N Y or N Remote Annex Administrator’s Guide for UNIX Software Reference Guide Description...
Page 268 Chapter 5 Software Reference Guide Parameter allow_snmp_ sets arap_v42bis at_guest at_nodeid at_security attn_string authoritative_ agent authorized_ groups Remote Annex Administrator’s Guide for UNIX Book C-250 Values Default Y or N Y or N Y or N 0.0 to 65534.254 Y or N control char.
Page 269 Book C Parameter autobaud backward_key banner broadcast_addr broadcast_ direction bypass Chapter 5 Values Default Y or N vcli: one “ “ printable or control character. non-vcli: string (1 to 16 characters) Y or N 0.0.0.0 or 0.0.0.0 255.255.255.255 all ones for the host portion and all zeroes for the network or...
Page 270 Chapter 5 Software Reference Guide Parameter chap_auth_ name char_erase circuit_timer cli_imask7 cli_inactivity cli_interface cli_prompt cli_security conﬁg_ﬁle Remote Annex Administrator’s Guide for UNIX Book C-252 Values Default A string of 1–16 chap characters Y or N 1–25 (80 ms) Y or N 0–254, 0 (off) immediate, or off...
Page 271 Book C Parameter connect_security control_lines data_bits daylight_savings dedicated_ address dedicated_ arguments dedicated_port Chapter 5 Values Default Y or N modem_ none control, ﬂow_control, both, none 5, 6, 7, or 8 australian, british, canadian, east_european, mid_european,w est_european, none Internet address 0.0.0.0 ""...
Page 272 Chapter 5 Software Reference Guide Parameter default_zone_list default_session_ mode dhcp_broadcast disabled_ modules do_compression echo enable_security erase_char Remote Annex Administrator’s Guide for UNIX Book C-254 Values Default 100-character "" string interactive, inter- passthru, passall, active transparent Y or N admin, atalk, none dialout, edit, ﬁngerd, ftpd,...
Page 273 Book C Parameter erase_line erase_word facility_num force_CTS forward_key forwarding_ count forwarding_ timer group_value Chapter 5 Values Default control char. sequence control char. sequence 0–32767 Y or N vcli: one " " printable or control character. non-vcli: string (1 to 16 characters) 0–255 0–255, off...
Page 274 Chapter 5 Software Reference Guide Parameter hardware_tabs (asynchronous) hardware_tabs (parallel port) host_table_size image_name imask_7bits inactivity_timer inet_addr input_ﬂow_ control Remote Annex Administrator’s Guide for UNIX Book C-256 Values Default Y or N Y or N 1–255, (255=unlimited, 254=none) host ﬁle name ""...
Page 275 Book C Parameter input_is_activity input_start_char input_stop_char ipencap_type ip_forward_ broadcast ipso_class ipx_do_ checksum ipx_dump_ password Chapter 5 Values Default Y or N control char. sequence control char. sequence ethernet or ethernet ieee802 Y or N topsecret, secret, none conﬁdential, unclassiﬁed, none Y or N 0–16 chars.
Page 276 Chapter 5 Software Reference Guide Parameter ipx_dump_path ipx_dump_ username ipx_ﬁle_server ipx_frame_type ipx_security ixany_ﬂow_ control keep_alive_ timer Remote Annex Administrator’s Guide for UNIX Book C-258 Values Default 0–100 chars. No default 0–48 chars. No default 0–48 chars. No default ethernetII, raw802_3, 802_3 802_2, 802_2snap...
Page 277 Book C Parameter lat_key lat_queue_max latb_enable line_erase load_broadcast load_dump_ gateway load_dump_ sequence local_address Chapter 5 Values Default unique value no default 1–255 or none Y or N Y or N Y or N Internet address 0.0.0.0 net, slnn, self Internet 0.0.0.0 address Remote Annex Administrator’s Guide for UNIX...
Page 278 Chapter 5 Software Reference Guide Parameter location lock_enable login_password login_port_ password login_prompt login_timer login_timeout Remote Annex Administrator’s Guide for UNIX Book C-260 Values Default string of 1 to 16 "" characters Y or N <unset> or a <unset> string of 1 to 16 characters Y or N string of 1 to 16...
Page 279 Book C Parameter long_break loose_source_ route map_to_lower map_to_upper (serial port) map_to_upper (parallel port) Chapter 5 Values Default Y or N Y or N map_val Unset modem_number Y or N Y or N Y or N Remote Annex Administrator’s Guide for UNIX Software Reference Guide Description When enabled, the...
Page 280 Chapter 5 Software Reference Guide Parameter max_session_ count max_vcli metric min_unique_ hostnames mode mop_password motd_ﬁle Remote Annex Administrator’s Guide for UNIX Book C-262 Values Default 1–16 unlimited, unlimit-ed 0–254 1–15 Y or N adaptive, arap, auto-adapt, auto-detect, cli, connect, dedicated, ipx, ndp, ppp, rlogin, slave, slip, telnet, tn3270,...
Page 281 Book C Parameter multicast_timer multisessions_ enable (Annex) multisessions_ enable (asynchronous port) name_server_1 name_server_2 nameserver_ broadcast Chapter 5 Values Default 10–180 seconds Y or N Y or N dns, ien_116, none none dns, ien_116, none none Y or N Remote Annex Administrator’s Guide for UNIX Software Reference Guide Description Deﬁnes the number...
Page 282 Chapter 5 Software Reference Guide Parameter need_dsr net_inactivity net_inactivity_ units network_ turnaround newline_ terminal Remote Annex Administrator’s Guide for UNIX Book C-264 Values Default Y or N 0–255 minutes or minutes seconds 1–255 Y or N Book C Description For use with a modem connected to a slave port.
Page 283 Book C Parameter node_id option_key output_ﬂow_ control output_is_ activity output_start_ char output_stop_ char output_ttl parity password Chapter 5 Values Default 0 to 65534.254 unique value no default eia, start/stop, start/stop bell, both, none Y or N control char. sequence control char. sequence 1–255 even, odd,...
Page 284 Chapter 5 Software Reference Guide Parameter passwd_limit phone_number port_password port_server_ security ppp_acm ppp_ipx_ network Remote Annex Administrator’s Guide for UNIX Book C-266 Values Default 0–10 32-char string null string <unset> or <unset> a string Y or N 0x00000000 to 0xffffffff 00000000 00000001 to randomly...
Page 285 Book C Parameter ppp_ipx_node ppp_mru ppp_ncp ppp_password_ remote ppp_security_ protocol ppp_username_ remote pref_dhcp1_ addr Chapter 5 Values Default 000000000000 to Ethernetadd fffffffffffe ress plus 64–1500 1500 ipcp, atcp, ipxcp, mp, ccp, all <unset> or <unset> a string pap, none chap, chap-pap, none <unset>...
Page 286 Chapter 5 Software Reference Guide Parameter pref_dhcp2_ addr pref_dump_ addr pref_load_addr pref_mop_host pref_name1_ addr pref_name2_ addr pref_secure1_ host Remote Annex Administrator’s Guide for UNIX Book C-268 Values Default Internet address 0.0.0.0 Internet address 0.0.0.0 Internet address 0.0.0.0 Ethernet address 00-00-00-0 0-00-00 Internet address 0.0.0.0...
Page 287 Book C Parameter pref_secure2_ host printer_crlf printer_host printer_name printer_width prompt ps_history_ buffer redisplay_line remote_address reset_idle_time_o Chapter 5 Values Default Internet address 0.0.0.0 Y or N Internet 0.0.0.0 address valid name no default integer string of up to 16 %a%c codes 0–32767 (0 = disabled) control char.
Page 288 Chapter 5 Software Reference Guide Parameter retrans_limit ring rip_accept rip_advertise rip_auth rip_default_ route rip_horizon rip_next_hop rip_recv_version rip_routers Remote Annex Administrator’s Guide for UNIX Book C-270 Values Default 4–120 Y or N access_spec, none, all access_spec, none, all <set> or "" <unset>...
Page 289 Book C Parameter rip_send_ version rip_sub_accept rip_sub_ advertise routed rwhod security_ broadcast server_ capability server_name service_limit Chapter 5 Values Default 1, 2, compat- compatibility ibility Y or N Y or N Y or N Y or N Y or N all, conﬁg, none image, motd,...
Page 290 Chapter 5 Software Reference Guide Parameter session_limit short_break sigproto slip_allow_ dump slip_load_ dump_host slip_mtu_size slip_no_icmp slip_ppp_ security Remote Annex Administrator’s Guide for UNIX Book C-272 Values Default 1–1152, none 1152 (1152 = none) Y or N proto_in unset proto_out Y or N Internet address 0.0.0.0 small or...
Page 291 Chapter 5 Values Default Y or N autobaud, 50, 9600 75, 110, 134.5, 150, 200, 300, 600, 1200, 1800, 2000, 2400, 3600, 4800, 7200, 9600, 19200, 38400, 57600, 115200 1, 1.5, 2 IP subnet mask 0.0.0.0 subnet mask 0.0.0.0 a string of up to ""...
Page 292 Chapter 5 Software Reference Guide Parameter syslog_mask syslog_port t1_info tcp_keepalive (Annex) tcp_keepalive (serial port) tcp_keepalive (parallel port) Remote Annex Administrator’s Guide for UNIX Book C-274 Values Default emergency, alert, none critical, error, warning, notice, info, debug, all, none 0–Annex port count a 120-byte string Unset...
Page 293 Book C Parameter tdi_distance tdi_framing tdi_line_code telnet_crlf telnet_escape term_var Chapter 5 Values Default an integer from 0 to 655 d4 or esf ami or b8zs b8zs Y or N control char. sequence string of 1 to 16 "" characters Remote Annex Administrator’s Guide for UNIX Software Reference Guide Description Speciﬁes the length,...
Page 294 Chapter 5 Software Reference Guide Parameter tftp_dump_ name tftp_load_dir time_broadcast time_server timezone_ minuteswest tmux_delay Remote Annex Administrator’s Guide for UNIX Book C-276 Values Default string host- dependent string host- dependent Y or N loopback 0.0.0.0 address, 0.0.0.0, 127.0.0.1, host address, broadcast address + or - number...
Page 295 Book C Parameter tmux_enable tmux_max_host tmux_max_mpx tni_circuit_id tni_clock tni_esf_fdl tni_framing tni_line_ buildout tni_line_code Chapter 5 Values Default Y or N 10–255 5–65535 string of up to null string 120 characters loop, local, or loop external ANSI or ATT format d4 or esf 0, 7.5, 15, or 22.5 0 ami or b8zs b8zs...
Page 296 Chapter 5 Software Reference Guide Parameter tni_ones_density toggle_output type (asynchronous) type (parallel port) type_of_modem user_name vcli_groups vcli_password vcli_security zone Remote Annex Administrator’s Guide for UNIX Book C-278 Values Default on or off control char. sequence hardwired or hard-wired dial_in centronics or centronics dataproducts 16-byte string...
Page 297: Table C-82. Annex Parameters
Book C Table C-82. Annex Parameters Parameter a_router acp_key allow_snmp_sets authoritative_agent autodetect_timeout broadcast_addr chap_auth_name Chapter 5 Values Default hexadecimal 00-00-00-00-00-00 ethernet address <unset> or a <unset> string Y or N Y or N 1-60 (seconds) 0.0.0.0 or 0.0.0.0 255.255.255.255 all ones for the host portion and all zeroes for the network or...
Page 298 Chapter 5 Software Reference Guide Parameter circuit_timer cli_prompt conﬁg_ﬁle daylight_savings default_zone_list dhcp_broadcast disabled_modules Remote Annex Administrator’s Guide for UNIX Book C-280 Values Default 1–25 ms coded string of %a%c up to 16 codes user-deﬁned conﬁg.annex australian, british, canadian, east_european, mid_european, west_european, none 100-character...
Page 299 Book C Parameter enable_security facility_num group_value host_table_size image_name inet_addr ipencap_type ip_forward_broadcast ipx_do_checksum ipx_dump_password ipx_dump_path Chapter 5 Values Default Y or N 0–32767 optional code disabled range within 0 - 255, followed by “enabled” or “disabled” 1–255, (255=unlimited, 254=none) host ﬁle name; ""...
Page 300 Chapter 5 Software Reference Guide Parameter ipx_dump_username ipx_ﬁle_server ipx_frame_type keep_alive_timer lat_key lat_queue_max load_broadcast Remote Annex Administrator’s Guide for UNIX Book C-282 Values Default 0–48 chars. No default 0–48 chars. No default ethernetII, raw802_3 raw802_3, 802_2, 802_2snap 10–255 20 seconds unique value no default 0–255 or none Y or N...
Page 301 Book C Parameter load_dump_gateway load_dump_sequence lock_enable login_password login_prompt login_timer loose_source_route max_vcli min_unique_ hostnames Chapter 5 Values Default Internet address 0.0.0.0 net, slnn, self Y or N <unset> or a <unset> string of 1 to 16 characters string of 1 to 16 characters 0–60 Y or N...
Page 302 Chapter 5 Software Reference Guide Parameter mop_password motd_ﬁle multicast_timer multisessions_enable name_server_1 name_server_2 nameserver_broadcast Remote Annex Administrator’s Guide for UNIX Book C-284 Values Default string <unset> ﬁle name of up motd to 16 characters 10–180 seconds Y or N dns, ien_116, none none dns, ien_116,...
Page 303 Book C Parameter network_turnaround node_id option_key output_ttl password passwd_limit ppp_sec_auto Chapter 5 Values Default 1–255 0 to 65534.254 unique value no default 1–255 <unset> or a <unset> string 0–10 Y or N Remote Annex Administrator’s Guide for UNIX Software Reference Guide Description Sets the number of seconds to wait for an...
Page 304 Chapter 5 Software Reference Guide Parameter pref_dhcp1_addr pref_dhcp2_addr pref_dump_addr pref_load_addr pref_mop_host pref_name1_addr pref_name2_addr Remote Annex Administrator’s Guide for UNIX Book C-286 Values Default Internet address 0.0.0.0 Internet address 0.0.0.0 Internet address 0.0.0.0 Internet address 0.0.0.0 Ethernet address 00-00-00-00-00-00 Internet address 0.0.0.0 Internet address 0.0.0.0...
Page 305 Book C Parameter pref_secure1_host pref_secure2_host retrans_limit rip_auth rip_routers routed rwhod security_broadcast server_capability server_name Chapter 5 Values Default Internet address 0.0.0.0 Internet address 0.0.0.0 4–120 <set> or "" <unset> Internet address Y or N Y or N Y or N all, conﬁg, none image, motd, none...
Page 306 Chapter 5 Software Reference Guide Parameter service_limit session_limit subnet_mask syslog_facility syslog_host syslog_mask syslog_port tcp_keepalive (Annex) Remote Annex Administrator’s Guide for UNIX Book C-288 Values Default 16–2048 1–1152, none 1152 (1152 = none) IP subnet mask 0.0.0.0 log_localn log_local7 (n=0-7) Internet address 0.0.0.0 emergency, alert, none...
Page 307 Book C Parameter tftp_dump_name tftp_load_dir time_broadcast time_server timezone_minuteswest tmux_delay tmux_enable Chapter 5 Values Default string host- dependent string host- dependent Y or N loopback 0.0.0.0 address, 0.0.0.0, 127.0.0.1, host address, broadcast address + or - number 0–255 ms Y or N Remote Annex Administrator’s Guide for UNIX Software Reference Guide Description...
Page 308 Chapter 5 Software Reference Guide Parameter tmux_max_host tmux_max_mpx vcli_groups vcli_inactivity vcli_password vcli_security zone Remote Annex Administrator’s Guide for UNIX Book C-290 Values Default 10–255 5–65535 either all, none, none or port range of enable 0 - 255 followed by none or disable 0 - 255 (minutes)
Page 309: Table C-83. Appletalk-Speciﬁc Annex Parameters
Book C Table C-83. AppleTalk-speciﬁc Annex Parameters Parameter a_router default_zone_list node_id option_key zone Values Default hexadecim 00-00-00-00-00-00 al ethernet address 100-char "" string 0 to 65534.254 unique "" string of 0 "" to 32 characters Remote Annex Administrator’s Guide for UNIX Chapter 5 Software Reference Guide Description...
Page 310: Table C-84. Lat-Speciﬁc Annex Parameters
Chapter 5 Software Reference Guide Table C-84. LAT-speciﬁc Annex Parameters Parameter circuit_timer facility_num group_value keep_alive_timer lat_key lat_queue_max multicast_timer Remote Annex Administrator’s Guide for UNIX Book C-292 Values Default Description 1–25 8 (80 ms) The time interval in tens of milliseconds between the transmission of LAT packets.
Page 311 Book C Parameter retrans_limit server_name service_limit sys_location vcli_groups Chapter 5 Values Default 4–120 string of 1 physical to 16 Ethernet characters address appended to string LAT_ 16–2048 a string; up "" to 32 chars. either all, none none, or enable port range of 0 - 255 followed by...
Page 312: Table C-85. Rip-Speciﬁc Annex Parameters
Chapter 5 Software Reference Guide Table C-85. RIP-speciﬁc Annex Parameters Parameter option_key output_ttl rip_auth rip_routers routed Remote Annex Administrator’s Guide for UNIX Book C-294 Values Default Description unique "" Enables/disables active routing. 1–255 Deﬁnes a locally-generated packet’s time-to-live on the network. <set>...
Page 313: Table C-86. T1-Speciﬁc Annex Parameters
Book C Table C-86. T1-speciﬁc Annex Parameters Parameter t1_info tdi_distance tdi_framing tdi_line_code Chapter 5 Values Default Description a 120-byte Unset Stores T1 installation string of information from the service printable provider. ASCII characters an integer Speciﬁes the length, in feet, of from 0 to 655 the cable from the T1 Drop/ Insert interface to the PBX or...
Page 314: Table C-87. Tmux-Speciﬁc Annex Parameters
Chapter 5 Software Reference Guide Table C-87. TMux-speciﬁc Annex Parameters Parameter tmux_delay tmux_enable tmux_max_host tmux_max_mpx Remote Annex Administrator’s Guide for UNIX Book C-296 Values Default Description 0–255 ms Deﬁnes the maximum number of milliseconds during which small packets can accumulate to form larger packets. When the time expires, the Annex sends the multiplexed packet.
Page 315: Table C-88. Vms-Speciﬁc Annex Parameters
Book C Table C-88. VMS-speciﬁc Annex Parameters Parameter lock_enable login_password login_prompt login_timer multisessions_enable Chapter 5 Values Default Description Y or N Enables any port to use the Annex Interface for VMS Environment’s lock command. <unset> or <unset> Speciﬁes the password for all ports a string of 1 using a VMS interface.
Page 316: Table C-89. Rip-Speciﬁc Interface Parameters
Chapter 5 Software Reference Guide Table C-89. RIP-speciﬁc Interface Parameters Parameter rip_accept rip_advertise rip_default_route rip_horizon rip_next_hop rip_recv_version rip_send_version rip_sub_accept rip_sub_advertise Remote Annex Administrator’s Guide for UNIX Book C-298 Values Default Description access_spec, Controls which routes none, all are accepted from RIP updates.
Page 317: Table C-90. Asynchronous Port Parameters
Book C Table C-90. Asynchronous Port Parameters Parameter address_origin allow_broadcast allow_compression arap_v42bis at_guest at_nodeid at_security attn_string authorized_ groups Chapter 5 Values Default Description local, acp, local Determines where a Remote dhcp Annex will look to ﬁnd the local and remote IP addresses to use as the endpoints of a PPP/IPCP link.
Page 318 Chapter 5 Software Reference Guide Parameter autobaud backward_key banner broadcast_direction char_erase cli_imask7 cli_inactivity cli_interface cli_security connect_security Remote Annex Administrator’s Guide for UNIX Book C-300 Values Default Description Y or N Determines whether or not the Annex automatically detects line speed when a connection is opened, and whether or not it sets matching terminal port characteristics on the next login.
Page 319 Book C Parameter control_lines data_bits dedicated_address dedicated_arguments dedicated_port default_session_mode do_compression echo erase_char erase_line erase_word Chapter 5 Values Default Description modem_ none Speciﬁes the type of hardware control, control lines used on the port. ﬂow_ control, both, none 5, 6, 7, or 8 Deﬁnes the number of data bits in a character;...
Page 320 Chapter 5 Software Reference Guide Parameter forward_key forwarding_count forwarding_timer hardware_tabs (asynchronous) imask_7bits inactivity_timer input_buffer_size input_ﬂow_control input_is_activity input_start_char input_stop_char Remote Annex Administrator’s Guide for UNIX Book C-302 Values Default Description vcli: one " " Reopens the next available printable or higher numbered session control already established at your port.
Page 321 Book C Parameter ipso_class ipx_security ixany_ﬂow_control latb_enable line_erase local_address location login_port_password login_timeout long_break Chapter 5 Values Default Description top-secret, none Speciﬁes the U.S. Department secret, of Defense basic IP Security conﬁdential, Option (IPSO) classiﬁcation unclassiﬁed,n level included in TCP packets generated locally on Annex CLI, dedicated, or adaptive asynchronous ports.
Page 322 Chapter 5 Software Reference Guide Parameter map_to_lower map_to_upper metric max_session_count mode multisessions_enable need_dsr net_inactivity net_inactivity_units Remote Annex Administrator’s Guide for UNIX Book C-304 Values Default Description Y or N Enables/disables case conversion (from upper to lower) for characters sent from the terminal to the Annex.
Page 323 Book C Parameter newline_terminal output_ﬂow_control output_is_activity output_start_char output_stop_char parity phone_number port_password port_server_security ppp_acm ppp_ipx_network Chapter 5 Values Default Description Y or N When enabled, a line feed terminates both the input and the output line(s). When disabled, on input, either a CR or a LF terminates the input line;...
Page 324 Chapter 5 Software Reference Guide Parameter ppp_ipx_node ppp_mru ppp_ncp ppp_password_remote ppp_security_protocol ppp_username_remote printer_host printer_name prompt ps_history_buffer redisplay_line remote_address Remote Annex Administrator’s Guide for UNIX Book C-306 Values Default Description 00000000000 Ethernet Speciﬁes a string of 12 0 to address hexadecimal digits representing fffffffffffe plus one the 6-byte, non-zero node...
Page 325 9600 Deﬁnes the speed of the 75, 110, asynchronous line between the 134.5, 150, device and the Annex. 200, 300, 600, 1200, 1800, 2000, 2400, 3600, 4800, 7200, 9600, 19200, 38400, 57600, 115200 subnet mask 0.0.0.0 Deﬁnes the subnet mask for an async SLIP/PPP interface.
Page 326 Chapter 5 Software Reference Guide Parameter stop_bits tcp_keepalive (serial port) telnet_crlf telnet_escape term_var toggle_output type (asynchronous) type_of_modem user_name Remote Annex Administrator’s Guide for UNIX Book C-308 Values Default Description 1, 1.5, or 2 Speciﬁes the number of bit time intervals between successive characters.
Page 327: Table C-91. Appletalk-Speciﬁc Asynchronous Port Parameters
Book C Table C-91. AppleTalk-speciﬁc Asynchronous Port Parameters Parameter arap_v42bis at_guest at_nodeid at_security ppp_ncp Values Default Description Y or N Enables/disables V.42bis compression during an ARA session. Y or N Allows ARA guest login service. 0.0 to Deﬁnes the node ID given to an ARA client 65534.2 during connection establishment.
Page 328: Table C-92. Lat-Speciﬁc Asynchronous Port Parameters
Chapter 5 Software Reference Guide Table C-92. LAT-speciﬁc Asynchronous Port Parameters Parameter authorized_ groups latb_enable Remote Annex Administrator’s Guide for UNIX Book C-310 Values Default Description optional disabled Speciﬁes which LAT remote group code range codes are accessible to users on a within 0 to particular Annex port.
Page 329: Table C-93. Ppp-Speciﬁc Asynchronous Port Parameters
Book C Table C-93. PPP-speciﬁc Asynchronous Port Parameters Parameter address_origin allow_compression local_address metric ppp_acm ppp_mru ppp_ncp ppp_password_remote ppp_security_ protocol ppp_username_remote Chapter 5 Values Default Description local, acp, local Determines where a Remote dhcp Annex will look to ﬁnd the local and remote IP addresses to use as the endpoints of a PPP/IPCP link.
Page 330 Chapter 5 Software Reference Guide Parameter remote_address slip_ppp_security subnet_mask Remote Annex Administrator’s Guide for UNIX Book C-312 Values Default Description IP address 0.0.0.0 Deﬁnes the IP address for the host at the remote end of the link. Y or N Enables access to the ppp command from the CLI.
Page 331: Table C-94. Slip-Speciﬁc Asynchronous Port Parameters
Book C Table C-94. SLIP-speciﬁc Asynchronous Port Parameters Parameter address_origin allow_compression do_compression local_address metric remote_address slip_allow_dump slip_load_dump_host slip_mtu_size slip_no_icmp slip_ppp_security slip_tos Chapter 5 Values Default Description local, local Determines where a Remote Annex acp, dhcp will look to ﬁnd the local and remote IP addresses to use as the endpoints of a PPP/IPCP link.
Page 332 Chapter 5 Software Reference Guide Parameter subnet_mask Remote Annex Administrator’s Guide for UNIX Book C-314 Values Default Description Internet 0.0.0.0 Deﬁnes an Internet subnet mask for the subnet interface. mask Book C...
Page 333: Table C-95. Vms-Speciﬁc Asynchronous Port Parameters
Book C Table C-95. VMS-speciﬁc Asynchronous Port Parameters Parameter autobaud backward_key cli_interface forward_key default_session_mode login_port_password Chapter 5 Values Default Description Y or N Determines whether or not the Annex automatically detects line speed when a connection is opened, and whether or not it sets matching terminal port characteristics on the next login.
Page 334 Chapter 5 Software Reference Guide Parameter login_timeout multisessions_enable Remote Annex Administrator’s Guide for UNIX Book C-316 Values Default Description Y or N Enables a login timer when the VMS command interface is conﬁgured (i.e., when cli_interface is set to vci). Y or N Allows multisessions to be managed on a per port basis.
Page 335: Table C-96. Parallel Printer Port Parameters
Book C Table C-96. Parallel Printer Port Parameters Parameter hardware_tabs map_to_upper printer_crlf printer_width tcp_keepalive (parallel port) type Values Default Y or N Y or N Y or N integer 1-254 (in minutes) (255 (matchestcp = disabled, _keepalive Annex tcp_keepalive parameter Annex) setting) centronics or...
Page 336: Table C-97. Na Commands
Chapter 5 Software Reference Guide Table C-97. na Commands Command annex boot broadcast copy annex copy interface copy [port| asynchronous] copy printer dumpboot echo help or ? interface password Remote Annex Administrator’s Guide for UNIX Book C-318 Arguments annex_list [–adhlq] [time] [ﬁlename] [warning] Reboots the Annex. Only =[port_set | =broadcast_keyword [@annex_identiﬁer]] message annex_identiﬁer annex_list...
Page 337 Book C Command port | asynchronous printer quit read reset annex reset interface reset port | asynchronous reset printer reset t1 set annex set interface set port | asynchronous set printer Arguments [port_set | keyword] printer_set ﬁlename [=annex_list] annex_subsystem [=interface_list | keyword] [=async_port_list | keyword] [=printer_port_list | keyword] [ soft | hard | esf ]...
Page 338 Chapter 5 Software Reference Guide Command show annex show interface show port | asynchronous show printer write Remote Annex Administrator’s Guide for UNIX Book C-320 Arguments [=annex_list] [keyword | annex_parameter] [=interface_list] [keyword | interface_parameters] [=port_set] [keyword | port_parameter] [=port_set] [keyword | printer_parameter] annex_identiﬁer ﬁlename Book C...
Page 339: Table C-98. Cli Commands
Book C Table C-98. CLI Commands Command Arguments arap backward [switch] string, none [–d] [%] [%, +, –, number, hostname] connect service [hostname [port]] [–q] [%] [%, +, –, number, hostname] forward [switch] string, none hangup help or ? [command] hosts [–qn] [host] add {default |network} gateway hops ticks...
Page 340 Chapter 5 Software Reference Guide Command Arguments queue [[[–h hostname] [–s service] [–p port]], [–r entry_id]] rlogin hostname [–l user] services [–vh] service hostname slip stats [–smp [ports][time] |[–op ] stats -T [ current | total | all | interval_set | clear_alarm ] stty [parameter [value]]...
Page 341: Table C-99. Cli Superuser Commands
Book C Table C-99. CLI Superuser Commands Command Arguments admin [–ads] [host] [addr][temp |pub] boot [–adlq] [[+] [HH:][MM]] [ﬁlename] [warning] broadcast compact [–s] control port [dtr– | dtr+ | rts– |rts+] | port testmsg [times | forever] src_ﬁlename dst_ﬁlename dialout [–l] route_name edit ﬁlename...
Page 342 Chapter 5 Software Reference Guide Command Arguments src_ﬁlename dst_ﬁlename passwd ping [–artv] host [databytes [count]] port printer printer procs [–r] [–ppid] [–ddev] quit reset ﬁlename [–fF] add [–s] dest mask gateway [metric] route [–fF] add default gateway [metric] [–fF] delete [default | dest show stats –c t1_loopback...
Page 343: Table C-100. Rom Monitor Commands
Book C Table C-100. ROM Monitor Commands Command Arguments addr [–d] boot [–lv | ﬁlename] conﬁg console_ baud erase help or ? image [–d | ﬁlename] [–d ] [–d ] [–d ] ping host_ip_address [data_size] [npackets] ports sequence [–d | [interface [, interface]...] slip [–d] [port] Chapter 5...
Page 344: Table C-101. Formatting Codes For Annex Prompts
Chapter 5 Software Reference Guide Command Arguments stats –slip Table C-101. Formatting Codes for Annex Prompts Code Remote Annex Administrator’s Guide for UNIX Book C-326 Description Displays the current network statistics gathered by the ROM. Expansion The string annex. A colon followed by a space. The current date and time in this format: Mon Jan 6 13:59:42 1992.
Page 345: Table C-102. Variable Arguments
Book C Table C-102. Variable Arguments Variable annex_list annex_identiﬁer annex_parameter port_parameter port_set port_identiﬁer port_number printer_parameter broadcast_keyword port_keyword reset_keyword show_keyword time Chapter 5 Argument annex_identiﬁer [, annex_identiﬁer] symbolic name | Internet address annex_parameter value [annex_parameter value] ... port_parameter value [port_parameter value] ... port_identiﬁers [;...
Page 346: Table C-103. Annex Processes
Chapter 5 Software Reference Guide Table C-103. Annex Processes Process adm_timer connect_rdr connect_wtr dp_mon erpcd ﬁngerd_lis line_adm netdattimer ping p_srvr_conv reset_mach rlogin_rdr rlogin_wtr root routed rwhod snmpd syslog_port telnet_cmd telnet_rdr telnetd_lis telnetd_rdr telnetd_wri timed Remote Annex Administrator’s Guide for UNIX Book C-328 Purpose Watches serial ports for activity (idle timer, inactivity...
Page 347 Book C Process watcher Chapter 5 Purpose Maintains the watchdog timer. Remote Annex Administrator’s Guide for UNIX Software Reference Guide Book C-329...
Page 348 Chapter 5 Software Reference Guide Book C Remote Annex Administrator’s Guide for UNIX Book C-330...
Page 349 a_router parameter C-43 acp_key parameter C-43 acp_passwd file C-86, C-243 acp_policy.c file C-239 acp_policy.doc file C-239 acp_shadow file C-243 address_origin parameter C-43 admin command reference C-132 set descriptions C-132 admin prompt C-132 using with quit command C-132 administrative password using with su command C-122 alarmsyslog parameter C-44 allow_broadcast parameter C-44 allow_snmp_sets parameter C-45...
Page 350 to C-125, C-321 to C-325 lock user command C-153 ls superuser command C-154 modem superuser command C-155 more superuser command C-157 mv superuser command C-157 netstat user command C-158 to C-160 passwd superuser command C-161 ping superuser command C-161 to C-170 ppp user command C-170 procs superuser command C-171 queue user command C-174 to C-176...
Page 351 motd_file C-78 multicast_timer C-78 multisessions_enable C-78 name_server_1 C-79 name_server_2 C-79 nameserver_broadcast C-79 network_turnaround C-81 node_id C-82 output_ttl C-84 passwd_limit C-85 password C-85 pref_dhcp1_addr C-92 pref_dhcp2_addr C-92 pref_dump_addr C-92 pref_load_addr C-93 pref_mop_host C-93 pref_name1_addr C-93 pref_name2_addr C-93 pref_secure1_host C-94 pref_secure2_host C-94 retrans_limit C-97 rip_auth C-98 rip_routers C-100...
Page 352 imask_7bits C-62 inactivity_timer C-62 input_flow_control C-63 input_is_activity C-64 input_start_char C-64 input_stop_char C-64 ipso_class C-65 ipx_security C-67 latb_enable C-68 line_erase C-68 list of C-299 to C-308 list of AppleTalk-specific C-309 list of LAT-specific C-310 list of PPP-specific C-311 list of SLIP-specific C-313 list of VMS-specific C-315 local_address C-70 location C-70...
Page 353 parameter descriptions C-37 to C-120 RIP-specific interface list of C-298 rip_accept C-97 rip_advertise C-98 rip_default_route C-98 rip_horizon C-99 rip_next_hop C-99 rip_recv_version C-99 rip_send_version C-100 rip_sub_accept C-100 rip_sub_advertise C-101 synchronous port allow_compression C-45 ppp_username_remote C-91 remote_address C-96 alarmsyslog C-44 bypass C-50 map C-73 ring C-97 sigproto C-103...
Page 354 facility_num parameter C-59 fg command arguments C-145 reference C-145 filter list command C-146 forward_key parameter C-59 forwarding_count parameter C-60 forwarding_timer parameter C-60 group_value parameter C-61 hangup command reference C-147 hardware_tabs parameter asynchronous port C-61 configuring for parallel printer C-61 help command C-14 to C-15 arguments for C-14 reference, for CLI C-147 host_table_size parameter C-61...
Page 355 reference C-153 lock_enable parameter C-70 login_password parameter C-70 login_port_password parameter C-71 login_prompt parameter C-71 login_timeout parameter C-71 long_break parameter C-72 loose_source_route parameter C-72 ls command reference C-154 map parameter C-73 map_to_lower parameter C-73 map_to_upper parameter asynchronous port C-74 parallel port C-74 map3270 file C-215, C-221 max_chap_chall_int parameter C-74 max_session_count parameter C-74...
Page 356 output_flow_control parameter C-82 output_is_activity parameter C-83 output_start_char parameter C-84 output_stop_char parameter C-84 output_ttl parameter C-84 parameter conventions C-33 to C-37 descriptions C-37 to C-120 entering values C-34 setting to supplied defaults C-35 to C-37 all parameters C-37 Annex parameters C-35 asynchronous port parameters C-36 interface parameters C-35 parallel printer port parameters C-36...
Page 357 read command C-19 redisplay_line parameter C-96 remote_address parameter synchronous port C-96 reset command C-21 to C-23 keywords for C-23 reset t1 command C-21 reset_idle_time_on parameter C-96 reset_internal_modem command C-21 resume session command C-126 retrans_limit parameter C-97 ring parameter C-97 rip_accept parameter C-97 valid options for C-97 rip_advertise parameter C-98 valid options for C-98...
Page 358 squelch C-121 statistics for Annex C-185 for serial line C-185 stats -c command reference C-187 stats command arguments C-184 command display C-185 to C-193 displaying Annex statistics C-185 reference C-184 to C-193 stop_bits parameter C-106 stty command reference C-194 to C-203 setting parameters with C-194 to C-202 su command C-122 reference C-204...
Page 359 parallel printer port C-117 type_of_modem parameter C-118, C-155 user_name parameter C-118, C-230 utilities C-235 to C-246 erpcd daemon C-239 rtelnet daemon C-244 vcli_groups parameter C-118 vcli_password parameter C-119 vcli_security parameter C-119 environments C-126 non-privileged Annex VMS commands C-126, C-127 privileged Annex VMS commands C- 127 to C-132 who command arguments C-232...

This manual is also suitable for:

4000 5390 6100 5391