Palm M130 Handheld Instructions Manual

							Network preferences and TCP/IP software
153
To enter a password:
1.Tap the Password field.
2.Enter the password you use to log into your ISP or dial-in server.
3.Ta p  O K .  
NOTEThe Password field updates to display the word “Assigned.”
Selecting a connection
Use the Connection setting to select the method you want to use to connect to your 
ISP or dial-in server. See “Connection preferences”earlier in this chapter for 
information about creating and configuring connection settings.
To select a connection:
1.Tap the Connection pick list.
2.Tap the connection you want to use.
Adding telephone settings
When you select the Phone field, your handheld opens a dialog box in which you 
define the telephone number you use to connect with your ISP or dial-in server. In 
addition, you can also define a prefix, disable Call Waiting, and give special 
instructions for using a calling card.
Enter password here
Tap here
Tap here to display a 
list of available 
connections 
						

							Chapter 7 Setting Preferences for Your Handheld
154
NOTEThe Phone Setup dialog box works correctly for AT&T and Sprint long-
distance services. However, because MCI works differently, MCI customers need to 
put the calling card number in the Phone # field and the phone number in the Use 
calling card field.
To enter your server phone number:
1.Tap the Phone field.
2.Enter the phone number for your ISP or dial-in server.
3.If you need to enter a prefix or disable Call Waiting, skip to those procedures. 
Otherwise, tap OK.
Entering a prefix
A prefix is a number that you dial before the telephone number to access an outside 
line. For example, many offices require that you dial “9” to dial a number outside 
the building.
To enter a prefix:
1.Tap the Dial Prefix check box to select it.
2.Enter the prefix. 
3.Ta p  O K .
Disabling Call Waiting
Call Waiting can cause your session to terminate if you receive a call while you are 
connected. If your telephone has Call Waiting, you need to disable this feature 
before logging into your ISP or dial-in server.
Enter your ISP phone 
number here
Enter your 
prefix here Select this 
box if you 
need to use a 
prefix 
						

							Network preferences and TCP/IP software
155
To disable Call Waiting:
1.Tap the Disable call waiting check box to select it.
2.Enter the code to disable Call Waiting on the Disable call waiting line.
NOTEEach telephone company assigns a code to disable Call Waiting. Contact 
your local telephone company for the code that is appropriate for you.
3.Ta p  O K .
Using a calling card
The Use calling card field enables you to use your calling card when dialing your 
ISP or dial-in server. Keep in mind that there is usually a delay before you enter 
your calling card number. When you define your calling card number, you need to 
add commas at the beginning to compensate for this delay. Each comma delays 
transmission of your calling card number for two seconds.
To use a calling card:
1.Tap the Use calling card check box to select it.
2.Enter your calling card number on the Use calling card line.
NOTEIt’s a good idea to add at least three commas before your calling card 
number to compensate for the cue delay.
3.Ta p  O K .
Enter your disable 
code here Select this 
box if you 
need to 
disable Call 
Waiting
Enter your 
calling card 
number here Select this 
box to use a 
calling card 
						

							Chapter 7 Setting Preferences for Your Handheld
156
Connecting to your service
After you set your Connection and Network Preferences, establishing a connection 
to your ISP or dial-in server is easy.
NOTEIf you are connecting to an ISP, you need a third-party application, such as a 
web browser or news reader, to take advantage of this connection. For information 
about third-party applications that support TCP/IP, check the web site www.palm.com.
To establish a connection:
nTap Connect to dial the current service and display the Service Connection 
Progress messages. 
TIPTo see expanded Service Connection Progress messages, press the lower 
half of the Scroll button.
To close a connection:
nTap Disconnect to terminate the connection between your handheld and your 
service.
Creating additional service templates
You can create additional service templates from scratch or by duplicating existing 
templates and editing information. After you create a new or duplicate template, 
you can add and edit settings.
To add a new service template:
1.Tap the Menu icon  . 
2.Tap Service, and then tap New.
An Untitled service template is added to the Service pick list.
To duplicate an existing service template:
1.Tap the Service pick list.
2.Tap the predefined service template you want to duplicate.
3.Tap the Menu icon  . 
4.Tap Service, and then tap Duplicate.
A copy of the service template is added to the Service pick list.
Adding detailed information to a service template
If you are using one of the predefined service templates, you probably only need 
to enter your user name and telephone number. If you are creating a new service 
template, you may need to provide additional information to your ISP or dial-in 
server. You use the Details dialog box to add additional information to a selected 
service template. 
						

							Network preferences and TCP/IP software
157
To select a connection type:
1.Tap the service field.
2.Tap Details.
3.Tap the Connection type pick list and select one of the following connection 
types:
NOTEIf you are not sure, try PPP; if that doesn’t work, ask your Internet 
Service Provider or your System Administrator for the correct connection type.
Idle timeout
The Idle timeout setting defines how long your handheld waits before dropping 
the connection with your ISP or dial-in server when you switch out of a TCP/IP 
application.
To set the Idle timeout:
1.Tap the Idle timeout pick list and select one of the following options:
2.Ta p  O K .
PPPPoint-to-Point protocol
SLIPSerial Line Internet Protocol
CSLIPCompressed Serial Line Internet 
Protocol
1 minuteWaits one minute for you to open another application before it 
drops the connection. 
2 minutesWaits two minutes. 
3 minutesWaits three minutes. 
NeverKeeps your PPP or SLIP connection until you turn off your 
handheld (or until it times out). This option works best with the 
PalmModem accessory.
Select connection type 
						

							Chapter 7 Setting Preferences for Your Handheld
158
Defining primary and secondary DNS
The Domain Naming System (DNS) is a mechanism in the Internet for translating 
the names of host computers into IP addresses. When you enter a DNS number (or 
IP address), you are identifying a specific server that handles the translation 
services.
Each IP address has four sections, separated by periods. In the Details dialog box, 
you enter each section separately. Each section of an IP address is made up of a 
number from 0 to 255; numbers are the only allowable characters in this field.
Ask your Internet Service Provider or System Administrator for the correct 
Primary or Secondary DNS IP numbers.
TIPMany systems do not require that you enter a DNS. If you are not sure, leave the 
DNS field blank.
To enter a primary and secondary DNS:
1.Tap the Query DNS check box to deselect it.
2.Tap the space to the left of the first period in the Primary DNS field, and then 
enter the first section of the IP address. 
NOTEEach section must be a number from 0 to 255.
3.Repeat step 2 for the second, third, and last sections of the Primary DNS field.
4.Repeat steps 2 and 3 for the Secondary DNS number.
5.Ta p  O K .
IP address
Everyone who logs on to the Internet needs to have a unique identifier (an IP 
address), whether permanent or temporary. Some networks dynamically assign a 
temporary IP address when clients log in. The IP Address field lets you identify 
whether your network provides automatic (dynamic) temporary IP addressing.
NOTEIf your IP address is permanently assigned, you need to get that information 
from your System Administrator. If you are not sure, select Automatic. 
						

							Network preferences and TCP/IP software
159
To identify dynamic IP addressing:
nTap the IP Address check box to select it.
To enter a permanent IP address:
1.Tap the IP Address check box to deselect it and display a permanent IP address 
field below the check box.
2.Tap the space to the left of the first period then enter the first section of the IP 
address. 
NOTEEach section must be a number from 0 to 255.
3.Tap and enter the remaining sections of the IP address.
4.Ta p  O K .
Login scripts
A login script is a series of commands that automates logging into a network 
server, for example, your corporate network or your ISP. A login script is associated 
with a specific service template created in Network Preferences.
A login script is something that you are likely to receive from your IS System 
Administrator if your company has a system in which you log into the corporate 
servers from your handheld using a modem or network connection. The script is 
generally prepared by the System Administrator and distributed to users who 
need it. It automates the events that must take place in order to establish a 
connection between your handheld and the corporate servers.
You can create login scripts in two ways:
nIn a text editor on your desktop computer, in which you create a file with the 
extension PNC, which you then install on your handheld using the Install Tool 
(this method is not available to Mac computer users)
nIn the Login Script dialog box on your handheld, accessed from the Details 
dialog box in Network Preferences
Tap to select automatic IP 
address 
						

							Chapter 7 Setting Preferences for Your Handheld
160
NOTEYou can also use non-ASCII and literal characters in your login script. See 
Appendix C for more information.
Creating a login script on your handheld
You can create login scripts by selecting commands from the Command pick list in 
the Login Script dialog. Some commands, such as Send, require you to supply 
additional information. Those commands have a parameter field so that you can 
add the necessary data.
To create a login script:
1.Ta p  S c r i p t .
2.Tap the End pick list.
3.Tap the command you want from the Command list. If the command requires 
additional information, a field appears to the right of it for you to enter the 
information. The following commands are available:
Tap here to see the list of 
available commands
Tap here 
						

							Network preferences and TCP/IP software
161
4.Repeat steps 2 and 3 until the login script is complete.
5.Ta p  O K .
Wait ForTells your handheld to wait for specific characters from the TCP/IP 
server before executing the next command.
Wait For 
PromptDetects a challenge-response prompt coming from the server and 
then displays the dynamically generated challenge value. You 
then enter the challenge value into your token card, which in turn 
generates a response value for you to enter on your handheld. 
This command takes two arguments, separated by a vertical bar 
(|) on the input line.
SendTransmits specific characters to the TCP/IP server to which you are 
connecting.
Send CRTransmits a carriage return or LF character to the TCP/IP server to 
which you are connecting.
Send User IDTransmits the User ID information entered in the User ID field of 
the Network Preferences screen.
Send 
Pa ss wordTransmits the password entered in the Password field of the 
Network Preferences screen. If you did not enter a password, this 
command prompts you to enter one. The Password command is 
usually followed by a Send CR command.
DelayTells your handheld to wait a specific number of seconds before 
executing the next command in the login script.
Get IPReads an IP address and uses it as the IP address for your 
handheld. This command is used with SLIP connections.
PromptOpens a dialog box and prompts you to enter text of some kind 
(for example, a password or a security code).
EndIdentifies the last line in the login script. 
						

							Chapter 7 Setting Preferences for Your Handheld
162
Plug-in applications
You can create plug-in applications containing script commands that extend the 
functionality of the built-in script commands. A plug-in application is a standard 
PRC application that you install on your handheld just like any other application. 
After you install the plug-in application, you can use the new script commands in 
a login script. 
nPlug-in applications have the following characteristics:
nWritten in C language 
nCompiled into a device executable
nCalled properly from a login script
nAble to return control to a login script after it terminates
nCreated using a development environment that supports Palm OS software, 
such as Metrowerks CodeWarrior for Palm Platform. 
For additional information on creating plug-in applications, send 
e-mail to Palm Developer Support at [email protected].
Deleting a service template
There is only one way to delete a service template: use the Delete command from 
the Service menu.
To delete a service template:
1.Tap the Service pick list.
2.Tap the service template you want to delete.
3.Tap the Menu icon  . 
4.Tap Service, and then tap Delete.
5.Ta p  O K .
Network preferences menu commands
The Network Preferences screen includes menu commands to make it fast and easy 
to create and edit service templates. TCP/IP application menus are shown here for 
your reference. See “Using menus” in Chapter 1 for more information about 
choosing menu commands.
Service menu