Note ¯ After making changes to a location that is in use, you must reset the port that the location is using.

Displaying Location Information.

• show table location

• show location Locname

• dial Locname -x-see page 2-4

• ifconfig-see page 2-9

Summary of Location Commands

Location Commands

add location

This command adds a location to the location table.

add location Locname

Locname

Name of a remote location, up to 12 characters.

Usage

Example

See Also

save location - page 14-5

show table location - page 14-28

delete location

This command deletes a location from the location table.

delete location Locname

Locname

A previously created location name that is in the location table.

Example

See Also

save location - page 14-5

show table location - page 14-28

save location

This command writes any changes to the location table to the nonvolatile memory of the PortMaster.

save location

Usage

Example

set location analog

This command sets the digital modems of a PortMaster 3 to analog modem service when dialing out to the specified location.

set location Locname analog on|off

Locname	Location name that is in the location table.
on	Enables analog modem service on dial-out.
off	Disables analog modem service on dial-out, and causes the service to revert to ISDN.

Usage

Example

See Also

set location automatic|manual|on_demand

This command modifies configuration parameters for the specified location.

set location Locname automatic|manual|on_demand

Locname	Location name that is in the location table.
automatic	Sets the PortMaster to dial out to the location at boot time and to redial after a delay of 30 seconds if the connection drops.
manual	Sets the PortMaster to dial to the remote location when the administrator uses the dial command or pmdial utility. This keyword is also used for network dialback users. This is the default.
on_demand	Sets the PortMaster to dial to the remote location when packets are queued for that location.

Usage

Example

See Also

set location idletime - page 14-12

set location chap

This command is used for configuring outbound CHAP authentication for a specified location.

set location Locname chap on|off

Locname	Location name that is in the location table.
on	CHAP authentication is required for an outbound dial.
off	CHAP authentication is not supported for an outbound dial. This is the default.

Usage

See Also

set location password - page 14-20

set pap - page 3-15

set location compression

This command sets the use of Van Jacobson TCP/IP header compression and Stac LZS data compression for the location, improving interactive session performance.

set location Locname compression on|off

Locname	Location name that is in the location table.
on	Enables compression. The PortMaster tries to negotiate both Van Jacobson and Stac LZS compression on PortMaster 3 and Office Router products, or Van Jacobson compression only on other PortMaster products. This is the default.
off	Disables compression.
stac	Enables Stac LZS data compression only. Stac LZS compression is supported only on PortMaster 3 and Office Router products.
vj	Enables Van Jacobson TCP/IP header compression only.

|stac|vj

Usage

The PortMaster supports Stac LZS data compression only for PPP connections with bidirectional compression. Stac LZS data compression cannot be used for SLIP connections.

Example

set location destination

This command sets the IP address expected for the system at the remote end of the dial-out connection.

set location Locname destination Ipaddress

Locname	Location name that is in the location table.
Ipaddress	IP address or 39-character hostname of the destination.

Usage

Example

set location group

This command defines which network dial-out ports can be used for a specified location.

set location Locname group Group

Locname	Location name that is in the location table.
Group	Dial group from 0 to 100. The default is 0.

Usage

Example

See Also

set W1 group - page 6-10

set location high_water

This command sets the number of bytes of queued network traffic required to open an additional dial-out line to the remote location.

set location Locname high_water Number

Locname	Location name that is in the location table.
Number	Number between 0 and 65535. The default is 0.

Usage

Generally, interactive terminal traffic has no more than a few hundred bytes queued at any one time, but file transfers (for example, FTP) queue several thousand bytes. Consider size differences when deciding the number to use for high_water.

Example

See Also

set location maxports - page 14-16

set location idletime

This command sets the length of time the line can be idle-in both directions-before the PortMaster disconnects the connection to a specified location.

set location Locname idletime Number [minutes|seconds]

Locname	Location name that is in the location table.
Number	Timeout value from 0 to 255. The default value is 0.
minutes	Sets the idle time in minutes. This is the default.
seconds	Sets the idle time in seconds.

Usage

If the idle timeout value is set to 0, the idle timer is disabled.

If the value is set to 2 seconds or a longer interval, the connection is disconnected after having no traffic for the designated time. RIP packets are not counted as traffic.

Example

set location ifilter

This command sets a packet filter for packets entering the PortMaster from the interface this location establishes.

set location Locname ifilter [Filtername

Locname	Location name that is in the location table.
Filtername	Name of the input filter. The maximum is 15 characters.

]

Usage

You remove the filter by entering the command without a filter name.

Note ¯ If a matching filter name is not in the filter table, this command is not effective and all traffic is permitted.

Example

See Also

set location ipxnet

This command sets the IPX network number for the point-to-point connection.

set location Locname ipxnet Ipxnetwork

Locname	Location name that is in the location table.
IPXnetwork	IPX network to be used for a serial link. A 32-bit hexadecimal value.

Usage

Example

See Also

set location local-ip-address

This command sets the local IP address of the PortMaster serial port for a numbered serial link.

set location Locname local-ip-address Ipaddress

Locname	Location name that is in the location table.
Ipaddress	IP address or 39-character hostname.

Usage

If this value is not set, the PortMaster uses the IP address of the Ether0 port.

This command is used to create a dialout point-to-point network connection when both ends require an IP address.

Note ¯ The point-to-point connection is a network of two nodes and requires its own IP subnet.

Example

See Also

set reported_ip - page 3-18

set location map

This command sets the PPP asynchronous map for a specified location.

set location Locname map Hex

Locname	Location name that is in the location table.
Hex	A 32-bit hexadecimal number. The default is 0x00000000.

Usage

The command set location Locname map 0 disables the asynchronous mapping.

Example

set location maxports

This command sets the maximum number of network dial-out ports the PortMaster can use for this location.

set location Locname maxports Number

Locname	Location name that is in the location table.
Number	Number between 0 and 60. The default is 0.

Usage

The maximum number of ports should be the last setting configured for a location. When the number is set to greater than zero, the location is available for use.

Example

See Also

set location multilink - page 14-18

set location mtu

This command sets the maximum transmission unit (MTU) for the location.

set location Locname mtu MTU

Locname	Location name that is in the location table.
MTU	MTU value, from 100 to 1500 bytes.

Usage

Example

See Also

set location multilink

This command determines whether the PortMaster uses RFC 1990 Multilink PPP or PortMaster multiline load balancing for dial-out to a specified location through multiple ports.

set location Locname multilink on|off

Locname	Location name that is in the location table.
on	Enables Multilink PPP-for ISDN and analog connections only.
off	Enables PortMaster multiline load-balancing. This is the default.

Usage

Example

See Also

set location maxports - page 14-16

set location netmask

This command sets the IP netmask expected for the host or network at the remote end of the dial-out connection.

set location Locname netmask Ipmask

Locname	Location name that is in the location table.
Ipmask	IP netmask in dotted decimal notation.

Usage

Example

set location ofilter

This command sets a packet filter for packets exiting the PortMaster to the interface this location establishes.

set location Locname ofilter [Filtername]

Locname	Location name that is in the location table.
Filtername	Name of the output filter. The maximum is 15 characters.

Usage

You remove the filter by entering the command without a filter name.

Example

See Also

set location password

This command sets up a password for automatic location table scripting for dialing to a remote location.

set location Locname password Password

Locname	Location name that is in the location table.
Password	PAP password associated with the username. Alternatively, this password can be used with CHAP if CHAP authentication is set on for the location; see page 14-8. The maximum password length is 64 characters.

Usage

This is the preferred way to set up location table scripting when dialing to a remote location.

Example

See Also

set location script - page 14-22

set location telephone - page 14-24

set location username - page 14-25

set location protocol

This command sets the protocol for encapsulating packets for the specified location.

set location Locname protocol slip|ppp|frame_relay|x75-sync

Locname	A location name that is in the location table.
slip	SLIP protocol.
ppp	PPP protocol.
frame_relay	Frame Relay subinterface.
x75-sync	X.75 protocol.

Usage

Example

See Also

set location mtu - page 14-17

set location script

This command sets up a dial script for dialing to a remote location.

set location Locname script|v25bis RuleNumber "String1" "String2"

Locname	Location name that is in the location table.
script	Enables a dial script for dial-out on an asynchronous port. The total length of all strings in the script should not exceed 256 characters.
v25bis	Enables a dial script for synchronous V.25bis protocol dial-out, for switched 56Kbps or ISDN.
RuleNumber	Rule number, from 1 up. Use rule number 99 to delete the script.
"String1"	Send string of up to 30 characters, in quotation marks.
"String2"	Expect string of up to 30 characters, in quotation marks.

Note ¯ Alternatively, you can set up automatic location table scripting. This method is much simpler to administer, and is preferred for setting up location table scripting. See the commands set location telephone, set location username, and set location password-starting on page 14-24-for information.

Usage

Any printable ASCII character can be placed in the send or expect strings. In addition, the following special characters are available:

\r	ASCII carriage return. Send strings usually end with the \r character. Do not use \r in the send string for the V.25bis protocol.
\0XX	Replaced by the octal digit in the XX.
\\	Replaced by a single backslash.

When you are connecting to a remote PortMaster, the final expect string to verify should be SL/IP for SLIP connections and PPP or a tilde (~) for PPP connections. A tilde is always the first character of a PPP frame. For other manufacturer's products, consult their manuals.

The dial script can also be used to implement outbound PAP authentication. If you specify a PAP username and password in the last line of the dial script, the PortMaster can be authenticated by the remote end using PAP. This capability is shown in the final example below.

Examples

Command> set location hq script 2 "\r" "ogin:"
New script entry successfully added.

Command> set location hq script 3 "my_login\r" "ssword:"
New script entry successfully added.

Command> set location hq script 4 "my_password\r" "PPP"
New script entry successfully added.

Command> set location denver v25bis 1 "CRN7005552227" "=DCD="
New script entry successfully added.

Command> set location denver v25bis 2 "=PAP=my-login/my-password"
New script entry successfully added.

See Also

set location telephone - page 14-24

set location username - page 14-25

set location telephone

This command sets up a telephone number for automatic location table scripting for dialing to a remote location.

set location Locname telephone String

Locname	Location name that is in the location table.
String	Telephone number to dial. Specify multiple numbers by separating them with ampersands (&). The maximum string length is 64 characters.

Usage

This is the preferred way to set up location table scripting when dialing to a remote location.

Examples

See Also

set location script - page 14-22

set location username - page 14-25

set location username

This command sets up a PAP or CHAP username for automatic location table scripting for dialing to a remote location.

set location Locname username Username

Locname	Location name that is in the location table.
Username	PAP or CHAP username to use when logging in to the remote location. The maximum name length is 64 characters.

Usage

This is the preferred way to set up location table scripting when dialing to a remote location.

Example

See Also

set location password - page 14-20

set location script - page 14-22

set location telephone - page 14-24

set location voice

This command forces a data-over-voice call on an outbound ISDN connection to a specified location.

set location Locname voice on|off

Locname	Location name that is in the location table.
on	Forces data-over-voice via 3.1KHz audio service on an outbound ISDN connection.
off	Disables data-over-voice on an outbound ISDN connection. This is the default.

Usage

Example

See Also

set location analog - page 14-5

show location - page 14-28

show location

This command displays configuration information for a specified location.

show location Locname

Locname

Location name that is in the location table.

Example

See Also

show S0 - page 2-34

show table location

Network dial-out destinations are configured in the location table. This command shows the current entries in the location table.

show table location

Example

DLCI Commands

add dlci

This command sets the Frame Relay subinterfaces for a specified location that has been configured to use Frame Relay service.

add dlci|ipdlci|ipxdlci Locname Dlci [Ipaddress|Ipxnode]

Note ¯ ipdlci is a synonym for dlci.

ipdlci or dlci	Use for IP connections.
ipxdlci	Use for IPX connections.
Locname	Location name that is in the location table.
Dlci	DLCI number, from 1 to 1023.
Ipaddress	Optional IP address of the router attached to the permanent virtual circuit (PVC) represented by the DLCI.
Ipxnode	IPX node address of the PortMaster attached to the permanent virtual circuit (PVC) represented by the DLCI. This value is the PortMaster MAC address-a 48-bit number.

Usage

The port to which the Frame Relay is connected must be set for Frame Relay, and must be in the same dial group as the location. Each subinterface must have its own subnet or network number.

The PortMaster can be configured for no more than 512 total active interfaces-or fewer if limited by available memory.

Refer to the PortMaster Configuration Guide for more information.

You can change values in the add dlci command by repeating the command with new values. You do not need to delete the existing DLCI entries before changing the values.

Example

Command> set s1 protocol frame
Protocol for port S1 changed from slip to frame_relay

Command> set s1 group 1
Group number for port S1 changed from 0 to 1

Command> add location sub1
Location sub1 successfully added

Command> set location sub1 protocol frame
sub1 protocol changed to frame_relay

Command> set location sub1 group 1
sub1 group number changed from 0 to 1

Command> set location sub1 address 192.168.3.1
sub1 destination changed from 0.0.0.0 to 192.168.3.1

Command> set location sub1 netmask 255.255.255.0
sub1 netmask changed from 0.0.0.0 to 255.255.255.0

Command> set location sub1 routing on
sub1 routing changed from off to on (broadcast,listen)

Command> add dlci sub1 16
New dlci successfully added

Command> add dlci sub1 17
New dlci successfully added

Command> save all

Command> reset s1

See Also

delete dlci

This command deletes entries from the DLCI table.

delete dlci|ipdlci|ipxdlci Locname Dlci

dlci or ipdlci	Use for IP connections.
ipxdlci	Use for IPX connections.
Locname	Specified location name that is in the location table.
Dlci	DLCI number, from 1 to 1023.

Usage

Examples

Command> delete dlci sub1 17
DLCI successfully deleted

See Also

delete dlci - page 6-8