[Top] [Table Of Contents] [Prev] [Next] [Index]
8 out of 25 total pages
Asynchronous Ports 5
- This chapter describes how to use the command line interface to configure asynchronous ports. The PortMaster 4 comes with two asynchronous console ports on the manager module--C0 and C1.
Note ¯
To configure the asynchronous ports, you must first access the system manager module using the set view command.
- Detailed command definitions follow a command summary table. A summary table for the modem table commands also appears in this chapter, followed by a description of the commands.
- Asynchronous ports can be configured as login, device, or network ports, or any combination of these.
Note ¯
After making any configuration changes to an asynchronous port, you must use the reset slot Slotnumber command for the changes to take effect
-
Displaying Asynchronous Port Information
- To display information about your configuration, use the following commands:
- For general information about command line interface commands, refer to Chapter 1, "Introduction."
Summary of Asynchronous Commands
- The asynchronous port commands in Table 5-1 configure asynchronous serial ports. Commands marked with a leading bullet (·) can be used only if the port is configured for a dedicated network connection with the set network hardwired command.
Table 5-1 Asynchronous Port Configuration Commands
|
Command Syntax
|
|
---|
| add modem ModemName(short) "ModemName(long)" "Speed" String
| - see page 5-37
|
| attach C0
| - see page 5-4
|
| delete modem ModemName(short)
| - see page 5-38
|
| reset C0
| - see page 2-13
|
| save ports
| - see page 2-15
|
| set C0|all access on|off
| - see page 5-6
|
·
| set C0 address Ipaddress
| - see page 5-6
|
| set C0|all cd on|off
| - see page 5-7
|
·
| set C0 compression on|off|stac|vj
| - see page 5-9
|
| set C0|all databits 5|6|7|8
| - see page 5-10
|
·
| set C0 destination Ipaddress [Ipmask]
| - see page 5-10
|
| set C0 device Device [network dialin|dialout|twoway]
| - see page 5-11
|
| set C0|all dialback_delay Seconds
| - see page 5-12
|
| set C0|all dtr_idle on|off
| - see page 5-13
|
| set C0 extended on|off
| - see page 5-13
|
| set C0|all group Group
| - see page 5-14
|
| set C0|all hangup on|off
| - see page 5-15
|
| set C0|all host default |prompt |[1 |2 |3 |4 ]Ipaddress
| - see page 5-15
|
| set C0|all idletime Number [minutes|seconds]
| - see page 5-16
|
·
| set C0|all ifilter Filtername
| - see page 5-17
|
·
| set C0 ipxnet Ipxnetwork
| - see page 5-18
|
| set C0|all login [network dialin|dialout|twoway]
| - see page 5-19
|
·
| set C0|all map Hex
| - see page 5-20
|
| set C0|all message String
| - see page 5-21
|
| set C0|all modem-type ModemName
| - see page 5-21
|
·
| set C0|all mtu MTU
| - see page 5-22
|
·
| set C0 netmask Ipmask
| - see page 5-23
|
| set C0|all network dialin|dialout|twoway
| - see page 5-23
|
| set C0|all network hardwired
| - see page 5-23
|
·
| set C0|all ofilter [Filtername]
| - see page 5-25
|
| set C0 ospf on|off
| - see page 8-7
|
| set C0|all override xon|rts|speed|parity|databits on|off
| - see page 5-25
|
| set C0|all parity even|none|odd|strip
| - see page 5-26
|
| set C0|all prompt String
| - see page 5-27
|
·
| set C0 protocol slip|ppp|x75-sync
| - see page 5-28
|
·
| set C0|all rip on|off|broadcast|listen|v2 {broadcast|multicast|on|v1-compatibility}
| - see page 7-17
|
| set C0 route-filter incoming|outgoing [Filtername]
| - see page 7-8
|
| set C0|all rts/cts on|off
| - see page 5-28
|
| set C0|all security on|off
| - see page 5-29
|
| set C0|all service_device netdata|portmaster|rlogin|telnet [Tport]
| - see page 5-30
|
| set C0|all service_login netdata|portmaster|rlogin|telnet [Tport]
| - see page 5-31
|
| set C0|all speed [1|2|3] 300|600|1200|2400|4800|9600| 19200|38400|57600|76800|115200
| - see page 5-32
|
| set C0|all stopbits 1|2
| - see page 5-33
|
| set C0|all termtype [String]
| - see page 5-33
|
| set C0 twoway Device [network dialin|dialout|twoway]
| - see page 5-34
|
| set C0 username|autolog String
| - see page 5-35
|
| set C0|all xon/xoff on|off
| - see page 5-36
|
| show all
| - see page 2-19
|
| show C0
| - see page 2-36
|
Asynchronous Port Types
- Asynchronous port types are described in Table 5-2. The first three options can be combined with the last three options. A port configured as a network hardwired port cannot be combined with another port type.
Table 5-2 Asynchronous Port Types
Port Type
|
Description
|
---|
login
| The port allows a user to log in and establish a terminal session to a host on the network.
|
device
| The port allows a user to access a shared device--for example, a printer or modem--via a host on the network, which can originate a connection to the port.
|
twoway
| The port allows both inbound and outbound connections--user login and shared modem device connections, in this case.
|
network hardwired
| The port provides a permanent network connection--for example, a WAN link over a dedicated point-to-point asynchronous leased line.
|
network dialin
| The port allows a dial-in network user to establish a network connection using SLIP or PPP.
|
network dialout
| The port allows network users to dial out to remote locations--the Internet or another office, for example--defined in the location table.
|
network twoway
| The port allows both inbound and outbound connections--network dial-in and network dial-out connections, in this case.
|
Asynchronous Commands
- These commands affect the asynchronous ports of the PortMaster.
attach C0
- This command allows you to communicate directly to a device attached to a specified asynchronous or ISDN PortMaster port.
attach C0
C0
| c0 or c1--asynchronous console port.
|
- Typical uses of this command are as follows:
- Programming a modem attached to an asynchronous port on the PortMaster
- Debugging a dial-out location on the PortMaster
- You can use AT commands with a host attached to an external analog modem connected to a PortMaster asynchronous port.
- When your host is attached to a modem connected to an ISDN BRI or PRI line, you can use the following special AT commands to make an outbound call with the following services:
at&n-- Unrestricted 64Kbps data connection.
|
at&n0-- 3.1KHz audio service.
|
at&n1-- Speech service.
|
at&n55-- 3.1KHz audio service.
|
at&n56-- Restricted 56Kbps data connection.
|
at&n64-- Unrestricted 64Kbps data connection.
|
-
Note ¯
Speech and 3.1KHz audio services each uses a single voice-grade channel. The speech service, however, can be used with compression and encoding techniques that are appropriate only for human speech. The 3.1KHz audio service is useful for data-over-voice communications between countries using T1 lines--such as the U.S.A., and countries using E1 lines--such as those in Europe.
- Each of these special AT commands returns an "OK." You must then enter the
atdt + telephone number command to place the call.
- To communicate directly to an analog modem attached to asynchronous port C0, and configure the modem with the AT command at&f1s0=1&w , use the attach command as follows:
Command> attach C0
Trying 192.168.1.1
Connected - Escape character is `^]' (Ctrl + Right bracket )
at&f1s0=1&w
OK
^]
telnet> send esc
Connection Closed
Command>
set C0|all access
- This command sets the access override for a single asynchronous port or all asynchronous ports, and is used in conjunction with the access filter.
set C0|all access on|off
on
| Turns access override on.
|
off
| Turns access override off. This is the default.
|
- When access override is set to on , users can override the port's access filter with their own access filter by providing a correct username and password. User access filters must first be defined before you can use this option. Refer to the PortMaster 4 Configuration Guide for more information on defining access filters.
- You can set the access override for all asynchronous ports simultaneously by using the set all access command.
Example
Command> set c0 access on
Access Enhancement for port C0 changed from off to on
See Also
set C0 ifilter - page 5-17
set C0 address
- This command sets the local IP address of a selected network hardwired asynchronous port to create a numbered interface.
set C0 address Ipaddress
Ipaddress
| Hostname or IP address.
|
- If the local IP address is set to 0.0.0.0, the PortMaster uses the Ether1 IP address for this end of the serial link. If the local IP address is set to 255.255.255.255, the PortMaster negotiates an IP address for the hardwired connection.
Note ¯
This command is used only on network hardwired asynchronous ports. Dial-in users must use the user table or RADIUS instead. Dial-out locations must use the location table instead.
Example
Command> set c0 address 192.168.7.2
Port C0 local address changed from 0.0.0.0 to 192.168.7.2
See Also
set Ether0 address - page 4-3
set reported_ip - page 3-21
set C0|all cd
- This command enables the PortMaster to monitor the presence of the data carrier detect (DCD) signal on an external modem attached to the asynchronous port to determine whether the line is in use.
set C0|all cd on|off
on
| Monitors presence of the DCD signal.
|
off
| Does not monitor presence of the DCD signal. This is the default.
|
- You can set the command for all asynchronous ports simultaneously by using the set all cd command.
- If set on , the PortMaster tracks the actual state of the DCD signal as input on the port.
If set off , the PortMaster assumes that DCD is always asserted--DCD is high.
- The following table indicates the effect of DCD assertion for each port type:
Asynchronous Port
|
Effect of DCD Assertion
|
Type
|
DCD Low--Not Asserted
|
DCD High--Asserted
|
login
| The port is unavailable.
| The PortMaster initiates authentication and displays a login prompt.
|
device
| The port is unavailable.
| The port is available for the device service.
|
twoway
| The port is available for device services.
| The port attempts to establish an inbound connection and disable the device service.
|
network hardwired
| The port is unavailable.
| The port attempts to establish a network connection.
|
network dialin
| The port is unavailable.
| The PortMaster initiates authentication and displays a login prompt.
|
network dialout
| The transition of DCD from asserted to not asserted resets the port.
| The port is unaffected. However, a change in DCD to not asserted resets the port.
|
network twoway
| The port is available for network dial-in.
| The port attempts to establish a network connection and disable the network dial-in.
|
Example
Command> set c0 cd on
CD required for port C0 changed from off to on
See Also
add modem - page 5-37
show table modem - page 5-40
set C0 compression
- This command sets Van Jacobson TCP/IP header compression and/or Stac LZS data compression on a network hardwired asynchronous port.
set C0 compression on|off
on
| Enables compression. The PortMaster tries to negotiate both Van Jacobson and Stac LZS compression.
|
off
| Disables compression.
|
stac
| Enables Stac LZS data compression only.
|
vj
| Enables Van Jacobson TCP/IP header compression only.
|
|stac|vj
- Van Jacobson TCP/IP header compression can be used for SLIP and PPP connections. With SLIP, both sides need to be configured identically. For PPP connections, the PortMaster supports both bidirectional and unidirectional compression.
- The PortMaster supports Stac LZS data compression only for PPP connections with bidirectional compression. Stac LZS data compression cannot be used for SLIP connections.
Note ¯
This command is used only on network hardwired asynchronous ports. Dial-in users must use the user table or RADIUS instead. Dial-out locations must use the location table instead.
Example
Command> set c0 compression on
Compression for port C0 changed from off to on
See Also
set location compression - page 11-6
set C0 protocol - page 5-28
set user compression - page 10-6
set C0|all databits
- This command sets the number of data bits per byte for a single asynchronous port or all asynchronous ports.
set C0|all databits 5|6|7|8
5
| 5 data bits.
|
6
| 6 data bits.
|
7
| 7 data bits.
|
8
| 8 data bits. This is the default.
|
- The default of 8 is the most widely used.
- You can set the data bits for all the asynchronous ports simultaneously by using the
set all databits command.
Example
Command> set c0 databits 8
Data bits for port C0 changed from 7 to 8
See Also
set C0 modem-type ModemName - page 5-21
set C0 parity - page 5-26
set C0 speed - page 5-32
set C0 stopbits - page 5-33
set C0 destination
- This command sets the IP address and the netmask of the remote router for a network hardwired asynchronous port connection.
set C0 destination Ipaddress [Ipmask]
Ipaddress
| IP address in dotted decimal notation or 39-character hostname of the remote router.
|
Ipmask
| IP netmask in dotted decimal notation.
|
- If the remote destination is set to 255.255.255.255 for PPP connections, the PortMaster attempts to learn the remote system IP address. If the destination is set to 0.0.0.0, the port is disabled.
Note ¯
This command is used only on network hardwired ports. Dial-in users must use the user table or RADIUS instead. Dial-out locations must use the location table instead.
Example
Command> set c0 destination 255.255.255.255
Port C0 destination changed from 0.0.0.0 to 255.255.255.255
See Also
set W1 destination - page 6-8
set C0 device
- This command sets an asynchronous port to provide access to a shared network device via a host--or for device sharing and remote dial-in and/or dial-out access.
set C0 device Device [network dialin|dialout|twoway]
Device
| Designation for the shared host device--usually a printer or modem--for example, /dev/ttyp0 or /dev/network .
|
dialin
| In addition to allowing device sharing, the port accepts dial-in-only network connections. The remote system is required to enter a username and password. Dial-in connections to the network are controlled by the RADIUS server or the user table.
|
dialout
| In addition to allowing device sharing, the port becomes available for dialing to remote destinations and initiating network connections to those destinations. Dial-out connections from the network are controlled by the location table.
|
twoway
| In addition to allowing device sharing, the port accepts dial-in connections to the network, as well as being available for dial-out to remote destinations.
|
- An asynchronous port configured as a device port operates as a host device. You must also do the following to establish device sharing:
- In addition to setting an asynchronous port for device sharing, you can also set it for network dial-in and/or dial-out use by multiple users. Multiple users can dial in to the network through the port from remote locations, dial out from the network through the port to remote locations--like another office or the Internet--or both.
- In the following example, a PortMaster shared device--/dev/ttyp0 --is shown. Note that two ports cannot have the same tty designation.
Example
Command> set c0 device /dev/ttyp0
Port type for port C0 changed from User Login to Host Device(/dev/ttyp0)
See Also
set C0 host - page 5-15
set C0 login - page 5-19
set C0 twoway - page 5-34
set C0|all dialback_delay
- This command sets the delay between the disconnection of a callback user and the time when the PortMaster can return the user's call to establish a connection.
set C0|all dialback_delay Seconds
Seconds
| The delay time from 0 to 60, in seconds. The default is 0.
|
- Modems that take a long time to reset after DTR drops require a callback delay, so that the modem is ready to accept dial commands after the PortMaster has disconnected the user.
- You can simultaneously set the delay time for all ports by using the set all dialback_delay command.
Example
Command> set c0 dialback_delay 5
Dialback delay for port C0 changed from 0 to 5
See Also
set user dialback - page 10-7
set C0|all dtr_idle
- This command turns the DTR signal off to enable bidirectional communications, or turns it back on.
set C0|all dtr_idle on|off
on
| DTR is on, and any DTR drop is for 500ms. This is the default.
|
off
| DTR is off. Allows bidirectional communications.
|
- This command changes the behavior of the port to better accommodate connecting the PortMaster to systems or hosts that do not support TCP/IP, but do have serial ports. This type of connection requires that you connect the PortMaster port to the host, typically with a null modem cable.
- Set DTR idle when you want to connect a PortMaster to a bulletin board service (BBS) or other host allowing bidirectional communications. You can simultaneously turn DTR on or off on all ports by using the set all dtr-idle command.
- Refer to the PortMaster 4 Configuration Guide for more information.
Example
Command> set c0 dtr_idle off
DTR Idle for port C0 changed from on to off
See Also
set C0 hangup - page 5-15
- set C0 modem-type ModemName - page 5-21
set C0|all extended
- This command sets the extended mode on or off for a single asynchronous port, or for all asynchronous ports.
set C0|all extended on|off
on
| Turns extended mode on.
|
off
| Turns extended mode off. This is the default.
|
- When extended mode is on , the show C0 command provides more detailed output.
set C0|all group
- This command assigns asynchronous ports to external modem pools for use by dial-out locations. A group number is assigned to each location in the location table. Refer to Chapter 11, "Locations and DLCIs," for more information.
set C0|all group Group
Group
| Group number, from 0 to 100. Default is 0.
|
- For dial-out modem pools to work, each port must be assigned to a dial group, and each location must specify a dial group. All ports can be assigned to a single group with the set all group Group command.
Example
Command> set c0 group 2
Group number for port C0 changed from 0 to 2
See Also
set location group - page 11-7
-
set C0|all hangup
- This command controls whether the DTR signal on a port, or on all ports, is dropped for 500 milliseconds (ms) after the termination of a user session.
set C0|all hangup on|off
on
| DTR is dropped after the session terminates. This is the default.
|
off
| DTR is not dropped after the session terminates.
|
- Resetting the port administratively with the reset command always drops the DTR signal.
set C0|all host
- This command sets the default IP address or hostname for login sessions for a single asynchronous port or all asynchronous ports.
set C0|all host default|prompt|[1|2|3|4]Ipaddress
default
| Uses the default host setting.
|
prompt
| Displays the host prompt before the login prompt. The user is required to enter a valid hostname or Internet address for a host on the network. Entering PPP or SLIP at the prompt returns a login prompt.
|
Ipaddress
| A specified IP address or hostname of a login host or device host.
|
1|2|3|4
| Used to specify alternate hosts, with the primary host being 1. The default is 1.
|
- The login host is the host to which the user is connected upon login, in one of the three ways. Use the set host command to define a default host. After you set the login host on a port, prompts are displayed in the following order:
host:
login:
Password:
- You can set the login host for all asynchronous ports simultaneously by using the
set all host command, as shown in the example.
- If you do not want the PortMaster to provide login or host device service, do not use this command. Setting the hostname to 0.0.0.0 removes the entry.
Examples
Command> set host 172.16.200.1
Default host changed from to 172.16.200.1
Command> set c0 host prompt
User will be prompted for host on port S0
Command> set all host default
Host changed to default for all ports
See Also
set C0 service_device - page 5-30
set C0 service_login - page 5-31
set user host - page 10-8
-
set C0|all idletime
- This command indicates how long the PortMaster waits after outbound activity stops on a single asynchronous port or all asynchronous ports, before disconnecting a dial-in connection.
set C0|all idletime Number [minutes|seconds]
Number
| Timeout value in minutes or seconds. Any value from 0 to 240. The default value is 0.
|
minutes
| Sets the idle time in minutes. This is the default.
|
seconds
| Sets the idle time in seconds.
|
- If the idle time value is set to 0, the idle timer is disabled.
- If the value is set to 2 seconds or a longer interval, the port is reset after having no traffic for the designated time.
- If the idle time is set to the special value of 1 second, a dial-in user has 5 minutes to respond to a login, password, or host prompt. If the user does not respond, the port resets and becomes available to another user. Setting the idle time to 1 second also turns off the idle timer after the user logs in.
Note ¯
The idle time special value of 1 second applies only to asynchronous ports that have modem control turned on with the set C0 cd on command. Ports that are in the command state--with an administrator logged on--are not timed out with the special value of 1 second.
- To simultaneously set the idle time for all asynchronous ports, use the set all idletime command as shown in the example.
set C0|all ifilter
- This command sets an input packet filter for packets entering the PortMaster on a single network hardwired asynchronous port, or all network hardwired asynchronous ports. The command can also be used to set an access filter for login users on these ports.
set C0|all ifilter [Filtername
Filtername
| Input filter name that is in the filter table. Maximum of 15 characters.
|
]
- When an input filter is specified on a network hardwired port, all packets received from the interface are evaluated against the rule set for this filter.
- This filter is used as an access filter for login users who are prompted for a host, and as the input filter for network hardwired ports. Filters become effective after the port is reset and when a user logs in.
- This setting is not used for dial-in and dial-out networking. Filters for dial-in users are set in the user table or RADIUS, and filters for dial-out locations are set in the location table.
- To remove the input filter, enter the command without a filter name.
- To simultaneously set the input filter for all hardwired asynchronous, use the set all ifilter command.
Note ¯
This command is used only on network hardwired asynchronous ports. Dial-in users must use the user table or RADIUS instead. Dial-out locations must use the location table instead.
Example
Command> set c0 ifilter c0.in
Input filter for port C0 changed from to c0.in
See Also
add filter - page 12-3
set C0 ofilter - page 5-25
set C0 ipxnet
- This command sets the IPX network number for the network hardwired asynchronous or synchronous connection.
set C0 ipxnet Ipxnetwork
Ipxnetwork
| IPX network number--a 32-bit hexadecimal value.
|
- IPX traffic can be passed through a port if you assign an IPX network number to the hardwired network connection. The serial link itself must have a unique IPX network number that is different from those at each end of the Ethernet.
Note ¯
This command is used only on network hardwired asynchronous or synchronous ports. Dial-in users must use the user table or RADIUS instead. Dial-out locations must use the location table instead.
Example
Command> set c0 ipxnet OXC009C801
Port C0 ipxnet changed from 00000000 to OXC009C801
See Also
set Ether0 ipxnet - page 4-8
set ipx on - page 3-13
set W1 ipxnet - page 6-11
set C0|all login
- This command sets a single asynchronous port or all asynchronous ports for user login--or for user login and remote dial-in and/or dial-out access.
set C0|all login [network dialin|dialout|twoway]
dialin
| In addition to allowing user login, the port accepts dial-in-only network connections. The remote system is required to enter a username and password. Dial-in connections to the network are controlled by the RADIUS server or the user table.
|
dialout
| In addition to allowing user login, the port becomes available for dialing to remote destinations and initiating network connections to those destinations. Dial-out connections from the network are controlled by the location table.
|
twoway
| In addition to allowing user login, the port accepts dial-in connections to the network, as well as being available for dial-out to remote destinations.
|
- Using the set C0 login command with no optional keywords sets the port for user login. You must also do the following if the host and service settings are not configured in the user profile:
- Define a login host with the set C0 host command.
- Define a login service with the set C0 service_login command.
- After being verified, or authenticated, a login session is established to the host computer.
- In addition to setting an asynchronous port for user login, you can also set it for network dial-in and/or dial-out use by multiple users. Multiple users can dial in to the network through the port from remote locations, dial out from the network through the port to remote locations--like another office or the Internet--or both.
- By using the all keyword, you can set the port type to user login--and to network dialin , network dialout , or network twoway --for all asynchronous ports simultaneously, as shown in the second example.
Examples
Command> set c0 login network dialin
Port type for port C0 changed from Login to User Login/Network(dialin)
See Also
set C0 device - page 5-11
set C0 host - page 5-15
set C0 service-login - page 5-31
set C0|all map
- This command sets the PPP asynchronous map for the interpretation of nonprinting ASCII characters found in the data stream for a single network hardwired asynchronous port, or all network hardwired asynchronous ports.
set C0|all map Hex
Hex
| A 32-bit hexadecimal number. The default is 0x00000000.
|
- The PPP protocol supports the replacement of nonprinting ASCII data in the PPP stream. These characters are not sent through the line, but instead are replaced by a special set of characters that the remote site interprets as the original characters. The PPP asynchronous map is a bit map of characters that must be replaced. The lowest-order bit corresponds to the first ASCII character NUL, and so on. Most environments set the asynchronous map to 0 (zero) to achieve maximum throughput. This command does not apply to the Serial Line Internet Protocol (SLIP).
- You can set the PPP asynchronous map for all the hardwired asynchronous ports simultaneously by using the set all map command. The command set C0 map 0 disables the asynchronous mapping.
Note ¯
This command is used only on network hardwired asynchronous ports. Dial-in users must use the user table or RADIUS instead. Dial-out locations must use the location table instead.
Example
Command> set c0 map 0xc0a86000
Async Char Map for port C0 changed from 0x0 to 0xc0a86000
See Also
set location map - page 11-12
set C0 protocol - page 5-28
set user map - page 10-12
set C0|all message
- This command sets the login message to be displayed to the user prior to the login prompt on a single asynchronous port or all asynchronous ports.
set C0|all message String
String
| Login message. The maximum length is 224 characters--or 224 characters minus the login prompt, if set.
|
- The value for this parameter is a string. Use the caret symbol (^) to designate new lines. It can be helpful to include network identification information in this message.
- You can set the login message for all asynchronous ports simultaneously by using the set all message command.
Note ¯
The combined maximum length of the strings in set C0 message and set C0 prompt must not exceed 224 characters.
Example
Command> set c0 message Welcome to the Network (PMI/0)
New message:
Welcome to the Network (PMI/0)
For ports: C0
See Also
set C0 prompt - page 5-27
set C0|all modem-type
- This command selects an external modem from the modem table.
set C0|all modem-type ModemName
ModemName
| Name of modem from the modem table. The modem name can contain from 0 to 16 characters.
|
- Before you can select a modem name, you must first define the names and associated parameters in the modem table. (Refer to Table 5-3, "Modem Table Configuration," on page 5-37 for more information.)
- You can set all ports for the same modem type by using the set all modem-type command.
Example
Command> set c0 modem-type usr-v34
Modem type for port C0 changed from to usr-v34
See Also
add modem - page 5-37
show table modem - page 5-40
set C0|all mtu
- This command sets the maximum transmission unit (MTU) for a single network hardwired asynchronous port, or all network hardwired asynchronous ports.
set C0|all mtu MTU
MTU
| Valid values for MTU are between 100 and 1500 bytes.
|
- The MTU defines the largest frame or packet that can be sent through this port, without fragmentation or discard. A packet that exceeds this value is automatically fragmented if IP, or discarded if IPX. PPP connections have a maximum of 1500 bytes, and SLIP connections have a maximum of 1006. For IPX, the MTU must be set to 1500.
- You can set the MTU for all hardwired asynchronous ports simultaneously by using the set all mtu command.
Note ¯
This command is used only on network hardwired asynchronous ports. Dial-in users must use the user table or RADIUS instead. Dial-out locations must use the location table instead.
Example
Command> set c0 mtu 1500
MTU for port C0 changed from 0 to 1500
See Also
set C0 protocol - page 5-28
set C0 netmask
- This command sets the IP netmask of the remote router for a network hardwired asynchronous port.
set C0 netmask Ipmask
Ipmask
| IP netmask in dotted decimal notation.
|
Usage
Note ¯
This command is used only on network hardwired asynchronous ports. Dial-in users must use the user table or RADIUS instead. Dial-out locations must use the location table instead.
Example
Command> set c0 netmask 255.255.255.0
C0 netmask changed from 0.0.0.0 to 255.255.255.0
See Also
set Ether0 netmask - page 7-7
set location netmask - page 11-15
set user netmask - page 10-14
set W1 netmask - page 6-13
set C0|all network dialin|dialout|twoway
- This command sets a single asynchronous port or all asynchronous ports to provide dial-in network access to multiple remote users, dial-out access for multiple users from the network to remote locations--or both--via PPP or SLIP.
set C0|all network dialin|dialout|twoway
dialin
| The port accepts dial-in-only network connections. When a DCD signal is detected by the PortMaster system, PPP packets are forwarded, and PAP or CHAP authentication is initiated automatically with no prompt for a username or password. Dial-in connections to the network are controlled by the RADIUS server or the user table.
|
dialout
| The port becomes available for dialing to remote destinations and initiating network connections to those destinations. Dial-out connections from the network are controlled by the location table.
|
twoway
| The port accepts dial-in connections to the network, as well as being available for dial-out to remote destinations.
|
- An asynchronous port set for any of these three network uses can also be configured to support user login and/or device sharing concurrently.
- By using the all keyword, you can set the port type to network dialin , network dialout , or network twoway for all asynchronous ports simultaneously, as shown in the second example.
Examples
Command> set c0 network twoway
Port type for port C0 changed from Login to Network(twoway)
See Also
set C0 device - page 5-11
set C0 login - page 5-19
set C0 twoway - page 5-34
set C0|all network hardwired
- This command sets a single asynchronous port or all asynchronous ports for a permanent network connection that requires no dialing or authentication.
set C0|all network hardwired
- Use this command for ports used in a dedicated or hardwired network connection between two sites. The port immediately begins running the specified protocol. None of the other port types can be combined with network hardwired .
- You can set the port type to network hardwired for all the asynchronous ports simultaneously by using the set all network hardwired command.
- You must also set the address of the other end of the network hardwired connection with the set C0 destination command.
- set C0 destination - page 5-10
set C0|all ofilter
- This command sets a packet filter for packets exiting the PortMaster on a single network hardwired asynchronous port, or all network hardwired asynchronous ports.
set C0|all ofilter [Filtername
Filtername
| Output filter name that is in the filter table. Maximum of 15 characters.
|
]
- When this command is specified, all packets being sent from the network hardwired port are evaluated against the rule set for this filter. Only packets permitted by this filter are sent out of the PortMaster.
- You remove the filter by entering the command without a filter name.
- You can set the output filter for all hardwired asynchronous ports simultaneously by using the set all ofilter command.
Note ¯
This command is used only on network hardwired asynchronous ports. Dial-in users must use the user table or RADIUS instead. Dial-out locations must use the location table instead.
Example
command> set c0 ofilter c0.out
Output filter for port C0 changed from to c0.out
See Also
add filter - page 12-3
set C0 ifilter - page 5-17
set C0|all override
- This command sets a single asynchronous port or all asynchronous port parameters as overrideable by the host in Host Device mode.
set C0|all override xon|rts|speed|parity|databits on|off
xon
| Software flow control.
|
rts
| Hardware flow control.
|
speed
| Baud rate.
|
parity
| Parity checking.
|
databits
| Number of data bits per byte.
|
on
| Allows the host to override the selected parameter.
|
off
| Does not allow the host to override the selected parameter. The default is that all overrides are off.
|
- The PortMaster allows overrides to be set for baud rate, parity, databits, and flow control. This feature allows the host running in.pmd to alter the active parameters through software control, by using operating system I/O calls (ioctl calls in UNIX).
- You can set an override parameter for all the asynchronous ports simultaneously by using the set all override command.
Example
Command> set c0 override speed on
Host override of speed for port C0 changed from off to on
See Also
set C0 device - page 5-11
set C0 modem-type ModemName - page 5-21
set S0 parity - page 5-26
set C0 speed - page 5-32
set C0|all parity
- This command sets the parity checking to be used for a single asynchronous port or all asynchronous ports.
set C0|all parity even|none|odd|strip
even
| Set for 7 data bits, 1 stop bit, and even parity.
|
none
| Set for 8 data bits, 1 stop bit, and no parity bit. This is the default.
|
odd
| Set for 7 data bits, 1 stop bit, and odd parity.
|
strip
| Set to strip the parity bit from the data stream when it is received by the PortMaster.
|
- When strip is selected, the parity bit is removed upon receipt by the PortMaster. For most purposes, none must be selected.
- You can set the parity for all the asynchronous ports simultaneously by using the set all parity command.
Example
Command> set c0 parity none
Parity for port C0 changed from even to none
See Also
set C0 databits - page 5-10
set C0 modem-type ModemName - page 5-21
set C0 speed - page 5-32
set C0 stopbits - page 5-33
set C0|all prompt
- This command sets the user login prompt for a single asynchronous port or all asynchronous ports.
set C0|all prompt String
String
| Login prompt-- maximum is 244 printable ASCII characters, or 244 characters minus the login message, if set. The default is $hostname login: .
|
- Any printable ASCII characters can be entered. If the string $hostname is included in the login prompt, the hostname for the port is substituted for the string. Use the caret symbol (^) to designate new lines. The command set C0 prompt returns the prompt to its default setting of $hostname login: .
- You can set the prompt for all asynchronous ports simultaneously by using the set all prompt command.
Note ¯
The combined maximum length of the strings in set C0 message and set C0 prompt must not exceed 224 characters.
-
Example
Command> set c0 prompt $hostname login:
New Login Prompt:
$hostname login:
For ports: C0
See Also
set host - page 5-15
set C0 message - page 5-21
set C0 username - page 5-35
set C0 protocol
- This command sets the transport protocol for a single network hardwired asynchronous port, or all network hardwired asynchronous ports.
set C0 protocol slip|ppp
slip
| SLIP protocol.
|
ppp
| PPP protocol.
|
x75-sync
| X.75 protocol.
|
|x75-sync
Usage
Note ¯
This command is used only on network hardwired asynchronous ports. Dial-in users must use the user table or RADIUS instead. Dial-out locations must use the location table instead.
Example
Command> set c0 protocol slip
Protocol for port C0 changed from ppp to slip
See Also
set debug - page 14-6
set C0 compression - page 5-9
set C0 mtu - page 5-22
set C0|all rts/cts
- This command sets the use of hardware flow control on a single asynchronous port or all asynchronous ports.
set C0|all rts/cts on|off
on
| Turns on hardware flow control for the port.
|
off
| Turns off hardware flow control for the port. This is the default.
|
- This parameter is used by devices that require hardware flow control. When the PortMaster is able to receive data from the attached device, it raises the RTS signal on pin 4 of the RS-232 connector. Output from the PortMaster occurs only if the modem line on pin 5 of the RS-232 connector has CTS raised by the attached device.
- You can set the hardware flow control for all the asynchronous ports simultaneously by using the set all rts/cts command.
Example
Command> set c0 rts/cts on
RTS/CTS flow control for port C0 changed from off to on
See Also
set C0 modem-type ModemName - page 5-21
set C0 xon/xoff - page 5-36
set C0|all security
- This command sets the security level for a single asynchronous port or all asynchronous ports.
set C0|all security on|off
on
| Enables security; disables passthrough logins.
|
off
| Disables security; enables passthrough logins. This is the default.
|
- If security is set to off , any username that is not found in the user table is connected to the port's host for authentication and login.
- If security is set to on , the user table is checked first. Then, if the username is not found and a RADIUS server is configured, RADIUS is consulted. When you are using RADIUS security, this command must be set to on .
- You can set the security for all asynchronous ports simultaneously by using the set all security command.
Example
Command> set c0 security on
Security for port C0 changed from off to on
See Also
set authentication_server - page 3-29
set C0|all service_device
- This command sets the device service to be used by a single asynchronous port or all asynchronous ports.
set C0|all service_device netdata|portmaster|rlogin|telnet [Tport]
netdata
| Allows netdata connections to this port from the network.
|
portmaster
| Provides host device emulation from a host with the in.pmd daemon installed. This is the default.
|
rlogin
| Allows rlogin connections to this port from the network.
|
telnet
| Allows telnet connections to this port from the network.
|
Tport
| Specifies the TCP port for the connection. Range is from 1 to 65535.
|
- If the port type is device or twoway , you can set the device service. This command allows users to connect through the PortMaster to shared devices such as printers or modems.
- You can set the device service for all asynchronous ports simultaneously by using the set all service_device command.
Example
Command> set c0 service_device portmaster
Device Service for port C0 changed from telnet to portmaster
See Also
set C0 device - page 5-11
set C0 host - page 5-15
set C0 login - page 5-19
set C0|all service_login
- This command sets the network service to use in establishing login sessions for a selected asynchronous port, or all asynchronous ports.
set S0|all service_login|netdata|portmaster|rlogin|telnet [Tport]
netdata
| Uses the netdata login service.
|
portmaster
| Uses the PortMaster login service to connect to in.pmd on the login host. This is the default.
|
rlogin
| Uses remote login to connect to the login host.
|
telnet
| Uses Telnet to connect to the login host.
|
Tport
| Specifies the designated TCP port on the host. Range is from 1 to 65535.
|
- When you set the port type as login or twoway , you can specify the login service to be used for login sessions.
- You can set the network service for all asynchronous ports simultaneously by using the set all service_login command.
Example
Command> set c0 service_login telnet
Login service for port C0 changed from portmaster to telnet
See Also
set C0 login - page 5-19
set C0 modem-type ModemName - page 5-21
set C0 service-device - page 5-30
set telnet - page 3-25
telnet - page 2-44
set C0|all speed
- This command sets the baud rate for a single asynchronous port or all asynchronous ports.
set C0|all speed [1|2|3] 300|600|1200|2400|4800|9600|19200|
38400|57600|76800|115200
1|2|3
| Indicates which of the three baud rates is being set: 1, 2, or 3. Default is 1.
|
300|600, and so on
| Indicates the data terminal equipment (DTE) rate. Default is 9600bps.
|
- Modern modems must be set to run at a fixed rate. To define a fixed rate, lock the DTE rate by setting all three baud rates to the same value.
- You can set the speed for all the asynchronous ports simultaneously by using the set all speed command.
Examples
Command> set c0 speed 115200
Speed for port C0 (1) changed from 9600 to 115200
Command> set c0 speed 2 115200
Speed for port C0 (2) changed from UNKNWN to 115200
Command> set c0 speed 3 115200
Speed for port C0 (3) changed from UNKNWN to 115200
See Also
set C0 modem-type ModemName - page 5-21
set C0|all stopbits
- This command sets the number of stop bits in the data frame on a single asynchronous port or all asynchronous ports.
set C0|all stopbits 1|2
1
| 1 stop bit. This is the default.
|
2
| 2 stop bits.
|
- The default of 1 is the most widely used.
- You can set the stop bits for all the asynchronous ports simultaneously by using the set all stopbits command.
Example
Command> set c0 stopbits 1
Stop bits for port C0 changed from 2 to 1
See Also
set C0 databits - page 5-10
set C0 modem-type ModemName - page 5-21
set C0 parity - page 5-26
set C0 speed - page 5-32
set C0|all termtype
- This command sets the terminal type in the user's environment on a single asynchronous port or all asynchronous ports that are set for user login or two-way operation via the rlogin or PortMaster login service.
set C0|all termtype String
String
| Terminal type, 0 to 15 characters.
|
- If the port is set for either login or two-way operation, this terminal type is set in the user's environment when a new session is established to the host. Make sure that the terminal type is valid on the host that the user is connected to with the rlogin or PortMaster login service.
- You can set the terminal type for all asynchronous ports simultaneously by using the set all termtype command.
Example
Command> set c0 termtype vt100
Terminal Type for port C0 changed from to vt100
See Also
set C0 login - page 5-19
set C0 twoway - page 5-34
set C0 twoway
- This command sets an asynchronous port for "two-way" operation--both user login and device sharing--or for two-way operation and remote dial-in and/or dial-out access.
set C0 twoway Device [network dialin|dialout|twoway]
twoway
| The first use of the keyword twoway sets the port for both user login and device sharing--combining the commands set C0 login and set C0 device .
The second use of the keyword twoway sets the port to two-way use for both dial-in from remote users and dial-out to remote locations.
|
Device
| Designation for the device--for example, /dev/ttyp0 or /dev/network .
|
dialin
| In addition to allowing both user login and device sharing, the port accepts dial-in-only network connections. The remote system is required to enter a username and password. Dial-in connections to the network are controlled by the RADIUS server or the user table.
|
dialout
| In addition to allowing both user login and device sharing, the port becomes available for dialing to remote destinations and initiating network connections to those destinations. Dial-out connections from the network are controlled by the location table.
|
- A PortMaster asynchronous port can be configured for several different types of operation. For example, a port set for login users can also be set to access host devices.
-
- This combined inbound and outbound use is called two-way operation. You must also do the following to establish two-way operation:
- Define a login host with the set C0 host command.
- Define a login service with the set C0 service_login command.
- Define a device service with the set C0 device_service command.
- If the port type is set to twoway , the port operates in user login mode when a data carrier detect (DCD) signal is detected on pin 8 of the RS-232 connector. Otherwise, it can be accessed as a host device on the computer through in.pmd or a Telnet session.
- In addition to setting an asynchronous port for user login, you can also set it for network dial-in and/or dial-out use by multiple users. Multiple users can dial in to the network through the port from remote locations, dial out from the network through the port to remote locations--like another office or the Internet--or both.
Example
Command> set c0 twoway /dev/ttyp0
Port type for port C0 changed from Login to TwoWay(/dev/ttyp0)
See Also
set C0 device - page 5-11
- set C0 host - page 5-15
set C0 login - page 5-19
set C0 network twoway - page 5-34
set C0 service_device - page 5-30
set C0 service_login - page 5-31
set C0 username|autolog
- This command sets an automatic login name for the asynchronous port.
set C0 username|autolog [String
String
| Username for automatic login--a maximum of 8 printable ASCII characters.
|
]
- If this command is used, the user does not receive the standard login prompt. Instead, the PortMaster initiates a session to the default host as if the user had typed String in response to the login prompt.
- To disable the automatic login, use the command set c0 autolog without a value String .
Example
Command> set c0 autolog posales
Username for port C0 changed from off to posales
See Also
set C0 message - page 5-21
set C0 prompt - page 5-27
set C0|all xon/xoff
- This command sets the use of software flow control on a single asynchronous port or all asynchronous ports.
set C0|all xon/xoff on|off
on
| Turns on software flow control for the port. This is the default.
|
off
| Turns off software flow control for the port.
|
- The PortMaster uses software flow control, with the ASCII control characters DC1 and DC3, to communicate with the attached device to start and stop the flow of data. Use this command only if Request To Send/Clear To Send (RTS/CTS) flow control is not available on the attached device.
- You can set the software flow control for all the asynchronous ports simultaneously by using the set all xon/xoff command.
Example
Command> set c0 xon/xoff off
Xon/Xoff flow control for port C0 changed from on to off
See Also
set C0 rts/cts - page 5-28
Modem Commands
- The modem table commands in Table 5-3 are used to view and configure the modem table, which stores configuration information for external modems you commonly use.
Note ¯
ComOS 4.0 and ComOS 4.1 do not support the add modem , delete modem , show table modem , and show modems commands for external modems. If you are running ComOS 4.0 and ComOS 4.1, you cannot use the commands in this section to configure external modems on asynchronous ports C0 and C1. Instead, you can attach a previously configured modem to the C0 or C1 ports. Although you cannot display the modem's settings with the show modem command, it will function if properly configured.
- See also the following commands for modems attached to asynchronous ports:
-
Table 5-3 Modem Table Configuration
Command Syntax
|
|
---|
add modem ModemName(short) ModemName(long) Speed String
| - see page 5-37
|
delete modem ModemName(short)
| - see page 5-38
|
show modem ModemName
| - see page 5-39
|
show table modem
| - see page 5-40
|
Note ¯
When the console diagnostic switch is in the left (on) position, the PortMaster 4 does not attempt to configure the modem specified for the console port. This feature allows a terminal to be attached to the console even if a modem was previously attached.
add modem
- This command adds details and configuration information about external modems to the modem table.
add modem ModemName(short) "ModemName(long)" Speed "String
ModemName(short)
| Abbreviated name used to identify the external modem. ModemName can be up to 16 characters.
|
ModemName(long)
| Long name that includes modem information--for example, the manufacturer or model name. Enclose the name in quotation marks. Up to a maximum of 64 characters.
|
Speed
| The DTE speed in bits per second.
|
String
| The initialization send/expect string for the modem. Enclose the string in quotation marks. Use a \r for a carriage return, and a caret (^ ) to separate the send and expect characters in the string. The PortMaster expects OK , as shown in the example.
|
"
-
- The short and long names are chosen by the user.
Example
Command> add modem multitech-v34 "at&f&w\r^OK^at&c1&d3$ba0$sb115200s0=1&w\r^OK"
New script entry successfully added.
Modem multitech-v34 successfully added.
See Also
show modem - page 5-39
show table modem - page 5-40
delete modem
- This command deletes an external modem from the modem table.
delete modem ModemName(short)
ModemName(short)
| The abbreviated name used to identify the modem when it was added to the modem table.
|
- Use the modem short name in the command, exactly as it is listed in the output of a show table modem command.
Example
Command> delete modem att-v34
Modem att-v34 successfully deleted.
See Also
show modem - page 5-39
show table modem - page 5-40
-
show modem
- This command shows configuration information on individual external modems that are in the modem table.
show modem ModemName(short)
ModemName(short)
| Short name given to the modem when the configuration information was added to the modem table.
|
- Use the modem short name in the command, exactly as it is listed in the show table modem response.
show table modem
- This command displays a table listing the external modems currently configured in the modem table.
show table modem
- The list provides the names of the modems, which can then be used to display details of the modem configuration.
Example
Command> show table modem
|
|
Short Name
| Long Name
| Type
|
-------------
| ------------------------------------
| ------------
|
att-v34
| AT&TV.34
| User
|
hayes
| HayesOptimaV34
| User
|
See Also
add modem - page 5-37
delete modem - page 5-38
show modem - page 5-39
[Top] [Table Of Contents] [Prev] [Next] [Index]
8 out of 25 total pages
spider@livingston.com
Copyright © 1999, Lucent Technologies. All rights
reserved.