Starting Program Neighborhood

To access applications published on MetaFrame servers, you must first start Program Neighborhood.

To start Program Neighborhood:

1.	Double-click the Program Neighborhood icon on your desktop. The Program Neighborhood window appears.

2.	If you specified a default application set or if your system administrator specified one for you, this window contains all the applications you can run. If no default is specified, a list of application sets appears. Select the application set you want to view. From the File menu, click Open. A logon dialog box appears.

3.	Enter a valid user name, domain, and password. If you are connecting to a MetaFrame server or published application that is configured to use Novell Netware Directory Services (NDS), enter your NDS distinguished name in the User Name field and your password in the Password field. Leave the Domain field blank.

4.	To save your password after you exit Program Neighborhood and close all connections, select Save password. If you leave this check box blank, your password will be retained only while the Program Neighborhood window and the current connections are open.

Note:  Administrators can disable the Save Password check box; if disabled, the check box is not available.

5.	To add a published application or desktop outside your application set, click Custom ICA Connections to add a Custom ICA Connection.

Important

Application sets are not supported on connections to a MetaFrame Server for UNIX Operating Systems. To connect to applications or desktops published on a MetaFrame Server, you must use Custom ICA Connections.

See also:

Specifying a Default Application Set

Finding a New Application Set

Viewing an Application Set

Adding a Custom ICA Connection


Changing Window Properties

To change your default window properties for application sets or custom ICA connections:

1. 	Select the application set or custom ICA connection whose default window properties you want to change.

2. 	For an application set, click the Settings icon in the Program Neighborhood toolbar and click the Default Options tab.

For a custom ICA connection, click the Properties icon in the Program Neighborhood toolbar and click the Options tab.

3. 	For application sets, clear the Use Server Default check box.

For custom ICA connections, clear the Use Custom Default check box.

4. 	In the Windows Properties section, choose the appropriate options from the Window Colors and Window Size menus.

See also:

Window Colors

Window Size


Defining Hotkeys

Hotkeys are used to control the behavior of Program Neighborhood, and as substitutes for the standard Windows hotkeys for a published application.

To set default hotkeys for Program Neighborhood:

1. 	From the Tools menu, select ICA Settings to display the ICA Settings dialog box.

2. 	Select the Hotkeys tab.

3. 	For each hotkey in the list, select a shift state and a key.

4. 	You can disable the hotkey by selecting (none) for the key.

For more information about the hotkeys, choose one of the following topics:

Task List

Close Remote Application

Toggle Title Bar

CTRL-ALT-DEL

CTRL-ESC

ALT-ESC

ALT-TAB

ALT-BACKTAB

CTRL-SHIFT-ESC

Toggle Latency Reduction


Creating a Desktop Shortcut

You can place shortcuts to published applications or application sets on your local desktop.

1. 	Select the application set or published application for which you want to create a shortcut.

2. 	From the File menu, click Create Desktop Shortcut.

3. 	A shortcut to the published application or application set appears on your desktop. For future connections, just double-click this shortcut icon.

If you are running Program Neighborhood on a Windows 3.51 or WinFrame server:

1. 	Select the application set or published application for which you want to create a shortcut.

2. 	From the File menu, click Create Desktop Shortcut. The Create Shortcut dialog box appears.

3. 	From the drop-down list, select the program group where you want your shortcut to appear, or create a new program group by typing a name in the field.


Ending Your Program Neighborhood Session

To exit from Program Neighborhood:

From the File menu, click Close.


Configuring Client Modems

Dial-In connections require a configured modem.

To add and configure your modem:

1. 	From the Tools menu, click Modems. The Phone and Modem  Options dialog box appears.

2. 	To add a new modem, click Add on the Modems tab. Follow the instructions in the Install New Modem wizard to add your modem. To remove a modem, select the modem you want to remove, then click the Remove button.

3. 	To view and change your modem properties, click the Properties button. The Modem Properties dialog box appears.

4. 	To configure dialing properties, click the Dialing Properties button. The Dialing Properties dialog box appears.


Configuring Client Serial Devices

To add and configure your serial devices:

1. 	From the Tools menu, click Serial Devices to display a list of installed serial devices.

2. 	To add a new serial device, click Add. Follow the instructions in the Install New Serial Device wizard to add your serial device. To remove a serial device, select the serial device you want to remove, then click the Remove button.

3. 	To view and change your serial device properties, select the serial device, then click the Properties button. The Device Properties dialog box appears.


Finding a New Application Set

In Program Neighborhood, you can access more than one application set.

To find a new application set:

1. 	In your Program Neighborhood window, double-click the Find New Application Set icon.

2. 	Follow the instructions in the Find New Application Set wizard.


Configuring General Settings

In the Settings dialog box, you can configure settings that serve as defaults for your ICA connections.

From the Tools menu, select ICA Settings to display the General tab on the ICA Settings dialog box.

For more information about the settings you can configure, click one of the following topics:

Enable Dynamic Client Name

Client Name

Keyboard Layout

Keyboard Type

Display Connect To screen before making Dial-in Connections

Display terminal window when making Dial-in connections

Allow automatic client updates

Pass-Through Authentication

Use local credentials to log on


Deleting an Application Set

1. 	Select the application set you want to delete.

2. 	From the File menu, click Delete.

Note:	 Deleting an application set removes that application set from your Program Neighborhood window. To use that application set again, you must add it using the Find New Application Set wizard.

See also:

Finding a New Application Set


Configuring Connection Properties

To configure the connection properties for your application set:

1. 	Select the application set to configure.

2. 	In the Program Neighborhood toolbar, click the Settings icon.

3. 	Click the Connection tab in the dialog box to display the Connection page.

From the Connection page, you can configure the following:

Auto-detect network protocol

Always use Server Location Network protocol

Connection type

Server location

Server group

Address list

Firewalls


Configuring Options

To configure the Options for your application set:

1. 	Select the application set to configure.

2. 	In the Program Neighborhood toolbar, click the Settings icon.

3. 	Click the Options tab in the dialog box to display the Options page.

From the Options page, you can configure the following:

Use data compression

Use disk cache for bitmaps

Queue mouse movements and keystrokes

Turn off desktop integration for this application set

Enable sound

Encryption level

Window Colors

Window Size


Configuring Logon Information - Custom ICA Connections

To configure the logon information for a custom ICA connection:

1. 	Select the custom ICA connection to configure.

2. 	In the Program Neighborhood toolbar, click the Properties icon.

3. 	Click the Logon Information tab.

4. 	Select Local user to be prompted for authentication when you establish a connection.
Select Pass-through authentication to enable pass-through authentication based on your Windows desktop credentials.

-Or-

Select Smart card to authenticate using a smart card and Personal Identification Number (PIN), and select Pass-through authentication to enable pass-through authentication based on the smart card and the smart card PIN. If you have not done so yet, insert your smart card in the smart card reader now.

-Or-

Select User-specified credentials to authenticate using credentials you specify here. Enter your user name, password, and domain information in the appropriate text boxes.
The Save password check box is selected by default. Clear the Save password check box if you do not want to save your password in clear text.

If you are connecting to a MetaFrame server or published application that is configured to use Novell NetWare Directory Services (NDS), enter your NDS distinguished name in the User Name field and your password in the Password field. Leave the Domain field blank.

5. 	Click OK.

Note:  The Save Password check box may not appear if it is disabled by an administrator. If the check box is disabled, you can enter user name and domain information only. At logon time, the MetaFrame server always prompts you for your password.


Up

Takes you up one level.


Refresh

Refreshes the view on your screen.


Properties

Shows the properties for the selected custom ICA connection - Connection, Options, and Logon Information.


Views

Lists the view options for your desktop - Large Icons, Small Icons, List, and Detail.


Application Set

Your view of the applications published on a commonly-administered group of MetaFrame servers, known as a server farm.


What Is Program Neighborhood?

The Program Neighborhood Client is the Citrix ICA Client software you use to start applications published on MetaFrame servers.

When you use Program Neighborhood, you have a view of applications published throughout the enterprise that you are authorized to access.

See also:

Application Set

Published application

Server farm


The Program Neighborhood Toolbar

Use the Program Neighborhood toolbar to:

·	Navigate within the Program Neighborhood window

·	Configure connection properties and options for your application set or published application

·	Change your view of the Program Neighborhood window

·	Refresh your view to reflect any changes to your application sets

For a description of a specific button, click one of the following:

Up

Properties

Settings

Views

Refresh

Delete

Use the Program Neighborhood menu bar to:

·	View an application set

·	Specify a default application set

·	Access online help for Program Neighborhood

·	Start a published application

·	Configure settings, modems, and serial devices

For a description of a specific menu item, click one of the following:

File

View

Tools

Help


Window Colors

1. 	To change the number of window colors, clear the Use Server Default check box.

2. 	From the drop-down list, select the number of window colors to use.

3. 	Click OK to save the changes.

To return to the server default setting, select the Use Server Default check box.


Window Size

1. 	To change the window size from the server default setting, clear the Use Server Default check box.

2. 	From the drop-down list, select a specific window size for your ICA session or choose one of the following:

•	Seamless Window: Select this option to run your published application in a separate, seamless window on your local desktop.

•	Percent of Screen Size: Select this option to configure the view of your published application as a percentage of the total screen size.

•	Full Screen: Select this option to view your published application in full screen mode.


Viewing an Application Set

1.	Select the application set you want to view.

2.	From the File menu, select Open, or double-click the application set you want to view.

3.	If you did not enter your user credentials for this application set, a logon dialog box appears. Enter a valid user name, domain, and password.

If you are connecting to a MetaFrame server or published application that is configured to use Novell NetWare Directory Services (NDS), enter your NDS distinguished name in the User Name field and your password in the Password field. Leave the Domain field blank. After you log on successfully, the list of all the applications you can run appears in the Program Neighborhood window. To see a more detailed view of your applications, click Views from the toolbar.

See also:

Starting Published Applications

Playing Published Videos


Specifying a Default Application Set

If you specify a default application set, all the applications you can access appear as soon as you start Program Neighborhood.

Default application sets are generally specified by your system administrator.

The first time you start Program Neighborhood, you are prompted to choose a default application set. If you want to change the default application set at a later time, follow the steps below:

1. 	Select the application set you want to have as your default.

2. 	From the File menu, choose Set as Default, or right-click the application set and choose Set as Default from the shortcut menu.

3. 	The next time you start Program Neighborhood, the published applications in the application set appear in your Program Neighborhood window.


Starting Published Applications

You can start any published application that appears in an application set.

To start a published application:

1. 	Select the application you want to use.

2. 	From the File menu, click Open, or double-click the icon for the application.

See also:

Playing Published Videos


Playing Published Videos

You can play any published video that appears in an application set.

Note: You must have Media Player installed on your system to play published videos.

To play a published video:

1. 	Select the video you want to play.

2. 	From the File menu, click Open, or double-click the icon for the published video you want to run.

3. 	The video will begin in a separate, Media Player window.


Task List

The Task List hotkey displays the Windows Task List for your local Windows NT 3.51 computer or the local Start menu if your local machine is a Windows NT 4.0 or Windows 9x computer. The default value for the Task List hotkey is SHIFT+F1.


Close Remote Application

The Close Remote Application hotkey disconnects the published application from the MetaFrame server and closes the Program Neighborhood window. The behavior of this hotkey is the same as choosing Close from the system menu of the Program Neighborhood window.

Closing the published application in this manner either leaves the associated application in a disconnected state on the MetaFrame server, or exits the application on the MetaFrame server, depending on how the server is configured.


Toggle Title Bar

The Toggle Title Bar hotkey causes the Program Neighborhood window to alternately display and hide its title bar.  When the title bar is displayed, you can move or close the Program Neighborhood window.

The Toggle Title Bar hotkey must be used to return to a seamless window after accessing the Windows NT Security dialog box using the CTRL+ALT+DEL hotkey.


CTRL-ALT-DEL

The CTRL-ALT-DEL hotkey causes the CTRL-ALT-DEL key sequence to be sent to the Windows NT session that is running the remote application.  In Windows NT, the CTRL-ALT-DEL key sequence causes a Windows NT session to switch to the Windows NT Security desktop.

The Toggle Title Bar hotkey must be used to return to a seamless window after accessing the Windows NT Security dialog box using the CTRL+ALT+DEL hotkey.


CTRL-ESC

The CTRL-ESC hotkey causes the CTRL-ESC key sequence to be sent to the Windows NT session that is running the remote application. CTRL-ESC is a standard Windows hotkey.  Refer to your Windows documentation for more information about the CTRL-ESC hotkey.


ALT-ESC

The ALT-ESC hotkey causes the ALT-ESC key sequence to be sent to the Windows NT session that is running the remote application.  ALT-ESC is a standard Windows hotkey.  Refer to your Windows documentation for more information about the ALT-ESC hotkey.


ALT-TAB

The ALT-TAB hotkey causes the ALT-TAB key sequence to be sent to the Windows NT session that is running the remote application.  ALT-TAB is a standard Windows hotkey.  Refer to your Windows documentation for more information about the ALT-TAB hotkey.


ALT-BACKTAB

The ALT-BACKTAB hotkey causes the ALT-SHIFT-TAB key sequence to be sent to the Windows NT session that is running the remote application.  ALT-SHIFT-TAB is a standard Windows hotkey.  Refer to your Windows documentation for more information about the ALT-SHIFT-TAB hotkey.


CTRL-SHIFT-ESC

The CTRL-SHIFT-ESC hotkey causes the CTRL-SHIFT-ESC key sequence to be sent to the Windows NT session that is running the remote application.  CTRL-SHIFT-ESC is a standard Windows NT 4.0 hotkey.  Refer to your Windows NT 4.0 documentation for more information about the CTRL-SHIFT-ESC hotkey.


Client Name

The Client Name field allows you to change the client name of your computer. The MetaFrame server uses the client name to uniquely identify resources (such as mapped printers and disk drives) associated with a given client device. The client name must be unique for each computer running Program Neighborhood.


Keyboard Layout

Allows you to specify the keyboard layout of your client device. The MetaFrame server uses the keyboard layout information to configure your user session for your keyboard. The default value of (User Profile) uses the keyboard layout specified in your user profile.


Keyboard Type

Allows you to specify the keyboard type of your client device. The MetaFrame server uses the keyboard type information to configure your user session for your keyboard type. Use the default value of Default for most English and European keyboards. When used with a Japanese keyboard, Default auto-detects the keyboard type.


Display Connect To screen

Select this check box to display the Connect To screen when you make a Dial-In connection.


Display terminal window

Select this check box if your Dial-In configuration includes third-party products, such as security devices and X.25 PADs, that require an ASCII dialog before connecting to the MetaFrame server.


Allow automatic client updates

Select this check box to allow the MetaFrame server to update your Program Neighborhood software when newer versions become available. When the MetaFrame server detects an outdated version of Program Neighborhood, it notifies you that a newer version is available and replaces the ICA Client files.


Connection Type

Use the Connection page to choose a Network or Dial-In connection type for the application set. Choose LAN if you are connecting over a local area network, WAN if you are connecting over a Wide Area Network, or Dial-up networking if you are connecting by modem.

Note If you are accessing your network through a dial-in remote node connection (RAS), click Network.

See also:

Configuring Client Modems

Configuring Client Serial Devices


Server Location

If your client device is connected to a LAN, use Server Location to get a list of all MetaFrame servers on the network and a list of all published applications.

Server location is a three-step process:

1.	If you specified a MetaFrame server in the Address List box for the network protocol, go to Step 2.

If you are using TCP/IP+HTTP, the default entry in the Address List box is "ica." Program Neighborhood attempts to resolve the name "ica" to an IP address if no server is specified. You must have a MetaFrame server on your network mapped to the default name of "ica."

If you are using SSL+HTTPS, you must enter the fully qualified domain name (FQDN) of the MetaFrame server(s) hosting the digital server certificate.

If you are using TCP/IP, IPX, SPX, or NetBIOS, the default entry in the Address List  box is Auto-Locate. Program Neighborhood broadcasts a Get Nearest MetaFrame server packet. The address of the first MetaFrame server to respond is then used in the next step.

2.	Program Neighborhood sends a request for the server and published application lists to the specified MetaFrame server address.

3.	The MetaFrame server responds with a list of all MetaFrame servers on the network and a list of all published applications.

Some network configurations using routers or gateways may require you to specify the address of a MetaFrame server because of broadcast packet filtering in the router or gateway.  You can designate a particular MetaFrame server to eliminate broadcasts on your network.

See also:

Configuring Server Location Settings


Server Group

Specify and configure primary and backup server groups.

See also:

Server Location


Address list

Use the Address List field to view and change the list of MetaFrame servers used in the selected server group.

If you select TCP/IP+HTTP in the Network Protocol list, Program Neighborhood attempts to resolve the name "ica" to an IP address if no server is specified.  To use this process, you must have a MetaFrame server on your network mapped to the name "ica."

If you select SSL+HTTPS in the Network Protocol list, you must enter the fully qualified domain name (FQDN) of the server hosting the digital certificate.

If you select any other entry in the Network Protocol list, Auto-Locate is selected by default if no server is specified. If Auto-Locate is selected, the nearest server is located automatically.

Click Add to add a MetaFrame server to your server group’s address list. The Add Server Location Address dialog box appears.

Click Delete to remove the selected MetaFrame server from the address list.

See also:

Server Group


Use data compression

Data compression reduces the amount of data that needs to be transferred but requires additional processor resources to compress and decompress the data.  If your connection is bandwidth-limited, enabling data compression increases performance.


Use disk cache for bitmaps

Bitmap caching to disk stores commonly-used graphical objects such as bitmaps in a local disk cache on the client device but uses local hard disk space. If your connection is bandwidth-limited, enabling disk caching increases performance. If your client device is on a high-speed LAN, you do not need disk caching. Dial-in connections have disk caching enabled by default.


Queue mouse movements and keystrokes

Queuing causes Program Neighborhood to send mouse and keyboard updates less frequently to the MetaFrame server. Check this option to reduce the number of network packets sent from Program Neighborhood to the MetaFrame server. Leaving this option unchecked makes the session more responsive to keyboard and mouse movements. Checking this option improves performance if you are using a low-speed remote node + remote control connection.


Turn off desktop integration for this application set

Your administrator can configure your Program Neighborhood to create desktop shortcuts and add items to your Start menu for published applications. If you do not want published applications sent directly to your desktop, select this option.


Enable sound

Select this check box to enable sound support. Your client device must have a compatible sound card installed. Published applications can then play sounds on your client device.  Client Audio is not available when connecting to a MetaFrame Server for UNIX Operating Systems.

Select one of the following values for Quality:

•	High. This value provides the greatest audio quality but should be used only when bandwidth consumption is not a concern.

•	Medium. Using this value results in less bandwidth consumption than when using High. Compression of sound data provides greater bandwidth efficiency but reduces sound quality somewhat. This value is recommended for most LAN-based connections.

•	Low. This value offers the most efficient use of bandwidth but also decreases sound quality severely. This value is recommended for low-bandwidth connections, including most modem connections.


Encryption level

Select the level of encryption for the ICA connection. The default level is Basic.

The MetaFrame server must be configured to allow the selected encryption level or greater. For example, if the MetaFrame server is configured to allow RC5 56-bit connections, Program Neighborhood can connect with RC5 56 or 128-bit encryption.

Note: Selecting RC5 encryption disables automatic logon to the MetaFrame server.


Custom ICA Connection

•	User-created shortcuts to published applications and servers throughout the enterprise

•	All server and application connections defined in earlier versions of Program Neighborhood

See also:

Adding a Custom ICA Connection


Adding a Custom ICA Connection

To access published applications and MetaFrame servers that are not part of your application set, you can use the Add a Custom ICA Connection wizard.

To add a custom ICA connection:

1. 	Double-click the Custom ICA Connection icon in your Program Neighborhood window.

2. 	Double-click Add ICA Connection. Follow the instructions in the Add New ICA Connection wizard.

3. 	When your ICA connection is set up, it appears in the Custom ICA Connections window of Program Neighborhood.

See also:

Custom ICA Connection

Starting Published Applications


Server farm

A group of MetaFrame servers defined and administered as a unit.


Published application

An application installed on a MetaFrame server rather than on your computer, that you access with Program Neighborhood.


File

From the File menu, you can open an application set or custom ICA connection; select a default application set or custom ICA connection; duplicate, delete, and rename an application set or custom ICA connection; create a desktop shortcut for your application set or custom ICA connection; access the Properties dialog boxes; and close your Program Neighborhood session.


View

From the View menu, you can choose the way you view your toolbar and your window.


Tools

From the Tools menu, you can configure general settings for Program Neighborhood, add and configure modems, and add and configure serial devices.


Help

From the Help menu, you can access online help for common tasks and display version information for Program Neighborhood.


Delete

Click this button to delete the selected item.


Firewalls

Use the Firewall Settings page to configure your connection to a MetaFrame server through:

•	a firewall (using an alternate address),

•	the proxy server that your default Web browser is configured to use,

•	no proxy server (using a direct connection), or

•	a SOCKS proxy server, or

•	a Secure (HTTPS) proxy server.

See also:

Use alternate address for firewall connection

Use Web browser proxy settings

Proxy Type:

None (direct connection)

Connect through SOCKS proxy

Connect through Secure (HTTPS) proxy

 Secure Gateway


Toggle Latency Reduction

The Toggle Latency Reduction hotkey turns SpeedScreen latency reduction on or off. Turning on latency reduction reduces the time between your keyboard or mouse input and a visible response on the screen.

This hotkey combination can be customized to use a different key combination.


ICA Settings

Displays the global settings for custom ICA connections or the settings for an application set.


Configuring Bitmap Caching

To configure bitmap caching:

1.	From the Program Neighborhood menu bar, select Tools and then ICA Settings to display the ICA Settings dialog box.

2.	Click the Bitmap Cache tab.

For more information about the settings you can configure on this page, see:

Bitmap Cache page


Configuring Event Logging

To configure event logging:

1.	From the Program Neighborhood menu bar, select Tools and then Settings to display the ICA Settings dialog box appears.

2.	Click the Event Logging tab.

The Event Logging page allows you to instruct Program Neighborhood whether or not to keep a log of various events that occur while running published applications. For more information about the event logging options, choose one of the following topics:

Event Log File

Log Events


Configuring Properties for Custom ICA Connections

To configure properties for a custom ICA connection:

1.	Select the custom ICA connection to configure.

2.	From the Program Neighborhood toolbar, select the Properties icon.

3.	Select one of the following tabs in the Properties dialog box:

Connection

Options

Logon information

Application


Custom ICA Connections - Connection Settings

To configure the connection properties for your custom ICA connection:

1.	Select the custom ICA connection to configure.

2.	In the Program Neighborhood toolbar, click the Properties icon.

3.	Click the Connection tab in the dialog box to display the Connection page.

From the Connection page, you can configure the following:

Connection Type

Server Location

Server Group

Address list

Note

You can configure default server location settings that apply to all your custom ICA connections. This eliminates the need to configure each custom ICA connection individually. To configure the default server location settings, select the Settings icon on the Program Neighborhood toolbar. This displays a dialog box where you can configure Server LocationServer Group, Address list and Firewalls settings.


Custom ICA Connections - Options

To configure the Options for your custom ICA connection:

1. 	Select the custom ICA connection to configure.

2. 	In the Program Neighborhood toolbar, click the Properties icon.

3. 	Click the Options tab in the dialog box to display the Options page.

From the Options page, you can configure the following:

Use data compression

Use disk cache for bitmaps

Queue mouse movements and keystrokes

Turn off desktop integration for this application set

Enable sound

Encryption level

Window Colors

Window Size

Note: You can configure default options for all your custom ICA connections by selecting the Settings icon on the Program Neighborhood toolbar. When the Custom ICA Connections dialog box appears, select the Default Options tab to configure the default options for your custom ICA connections.  You can override these defaults by clearing the Use Custom Defaults check box in the Options dialog box.


Custom ICA Connections - Application

To specify what application to run on the MetaFrame server:

1.	In the Application field, specify the file name of the application you want to after you log on to the MetaFrame server.  Leave this field blank to run a Windows desktop on the MetaFrame server. Enter the fully qualified drive and path of the program to run, followed by any necessary command line parameters and switches.

2.	In the Working Directory field, specify the directory to use with the program specified in the Application field.


Configuring Server Location Settings

Use server location to get a list of all MetaFrame servers on the network and a list of all published applications.

TCP/IP+HTTP Server Location

Some network configurations restrict broadcast and UDP packets across routers or gateways. To retrieve MetaFrame server and published application information across a firewall, use TCP/IP+HTTP server location.

The default setting for server location for TCP/IP+HTTP is "ica." Program Neighborhood attempts to resolve the name "ica" to an IP address if no server is specified. You must have a MetaFrame server on your network mapped to the default name "ica."  TCP/IP+HTTP server location does not support the Auto-Locate function.

To add a server location address:

1.	Select TCP/IP+HTTP from the Network Protocol drop-down list.

2.	Click Add to display the Add Server Location Address dialog box.

3.	Enter the name or IP address of a MetaFrame server and a recognized port number (the default is port 80) and click OK.

4.	The specified server responds with a list of all servers and published applications in its server farm.

SSL+HTTPS Server Location

To connect to the MetaFrame server using Secure Sockets Layer (SSL), use SSL+HTTPS server location.

1.	Select SSL+HTTPS from the Network Protocol drop-down list.

2.	Click Add to display the Add Server Location Address box.

3.	Enter the fully qualified domain name of the MetaFrame server hosting the digital certificate and click OK.

Important:

Both TCP/IP+HTTP and SSL+HTTPS server location retrieve information only on a per server farm basis. To retrieve information from more than one server farm, you must configure TCP/IP+HTTP or SSL+HTTPS server location settings for each application set.

For custom ICA connections, you must configure the TCP/IP+HTTP or SSL+HTTPS server location settings for each ICA connection. Do not place addresses from separate farms into the same server location list.

TCP/IP, IPX, SPX, NetBIOS Server Location

The default server location setting for TCP/IP, IPX, SPX, and NetBIOS is Auto-Locate. The auto-locate function works as follows:

1.	Program Neighborhood broadcasts a Get Nearest MetaFrame server packet. The address of the first MetaFrame server to respond is then used in the next step.

2.	Program Neighborhood sends a request for the server and published application lists to the specified MetaFrame server address.

3.	The MetaFrame server responds with a list of all MetaFrame servers on the network and a list of all published applications.

To specify a MetaFrame server to retrieve server and published application information:

1.	Select the network protocol to use from the Network Protocol drop-down list.

2.	Click the Add button to display the Add Server Location Address dialog box.

3.	Enter the name or IP address of a specific MetaFrame server and click OK.

Note:

You can place more than one address in the server location list to allow Program Neighborhood to continue to connect and function even if one of the servers is not available.


Citrix Secure Gateway
The Secure Gateway

If your MetaFrame environment includes the Secure Gateway deployed in Relay mode, enter the fully qualified domain name (FQDN) of the Secure Gateway server and the port number in the appropriate text boxes. Make sure to enter the server’s FQDN (for example, my_computer.my_company.com), not its IP address (for example, 10.42.1.17).

Important: If your MetaFrame environment includes the Secure Gateway deployed in the default Normal mode, you do not need to configure and use this setting. Do not configure this setting unless your MetaFrame administrator instructs you to do so. See your MetaFrame administrator if you are not sure if your MetaFrame environment includes the Secure Gateway.


Fully Qualified Domain Name (FQDN)

A fully qualified domain name (FQDN) must list, in sequence, the following three components:

•	host name

•	intermediate domain

•	top-level domain

For example: my_computer.my_company.com is an FQDN, because it lists, in sequence, a host name (my_computer), an intermediate domain (my_company), and a top-level domain (com). The combination of intermediate and top-level domains (my_domain.com) is generally referred to as the domain name.


Custom ICA Connections Logon Information

To configure the logon information for a custom ICA connection:

1. 	Select the custom ICA connection to configure.

2. 	In the Program Neighborhood toolbar, click the Properties icon.

3. 	Click the Logon Information tab.

4. 	Select Local user to be prompted for authentication when you establish a connection.
Select Pass-through authentication to enable pass-through authentication based on your Windows desktop credentials.

-Or-

Select Smart card to authenticate using a smart card and Personal Identification Number (PIN), and select Pass-through authentication to enable pass-through authentication based on the smart card and the smart card PIN. If you did not do so yet, insert your smart card in the smart card reader now.

-Or-

Select User-specified credentials to authenticate using credentials you specify here. Enter your user name, password, and domain information in the appropriate text boxes.
The Save password check box is selected by default. Clear the Save password check box if you do not want to save your password in clear text.

If you are connecting to a MetaFrame server or published application that is configured to use Novell NetWare Directory Services (NDS), enter your NDS distinguished name in the User Name field and your password in the Password field. Leave the Domain field blank.

5. 	Click OK.

Note:  The Save Password check box may not appear if it is disabled by an administrator. If the check box is disabled, you can enter user name and domain information only. At logon time, the MetaFrame server always prompts you for your password.


Configuring Logon Information - Application Sets

To configure the logon information for an application set:

1. 	Select the application set to configure.

2. 	In the Program Neighborhood toolbar, click the Settings icon.

3. 	Click the Logon Information tab.

4. 	Select Local user to be prompted for authentication when you establish a connection.
Select Pass-through authentication to enable pass-through authentication based on your Windows desktop credentials.

-Or-

Select Smart card to authenticate using a smart card and Personal Identification Number (PIN), and select Pass-through authentication to enable pass-through authentication based on the smart card and the smart card PIN. If you did not do so yet, insert your smart card in the smart card reader now.

-Or-

Select User-specified credentials to authenticate using credentials you specify here. Enter your user name, password, and domain information in the appropriate text boxes.
The Save password check box is selected by default. Clear the Save password check box if you do not want to save your password in clear text.

If you are connecting to a MetaFrame server or published application that is configured to use Novell NetWare Directory Services (NDS), enter your NDS distinguished name in the User Name field and your password in the Password field. Leave the Domain field blank.

5. 	Click OK.

Note:  The Save Password check box may not appear if it is disabled by an administrator. If the check box is disabled, you can enter user name and domain information only. At logon time, the MetaFrame server always prompts you for your password.


None

Select this option to configure Program Neighborhood to connect to the server using a direct connection, without going through a proxy server.  This is the default connection setting. This setting applies unless you specify a different connection method.


Auto-detect network protocol

Configures the connection to automatically detect the network protocol to use.


Options or Default Options tab

Use this tab to specify:

•	Default setting for applications in your application set

•	Settings for a specific custom ICA connection

For information about the Connection Options fields, choose one of the following topics:

Use data compression

Use disk cache for bitmaps

Queue mouse movements and keystrokes

Turn off desktop integration for this application set

Use server default  (for application sets)

Use custom default  (for custom ICA connections)

Latency reduction

Enable sound

Encryption level

Window Properties


Application dialog box

Use this dialog box to identify the published application that will be run on the specified MetaFrame server. For information about a specific field, choose one of the following topics:

Application

Working directory

Change icon

The selected application must be available to the MetaFrame server in the same location.


Logon Information

To configure the logon information for an application set:

1. 	Select the application set to configure.

2. 	In the Program Neighborhood toolbar, click the Settings icon.

3. 	Click the Logon Information tab.

4. 	Select Local user to be prompted for authentication when you establish a connection.
Select Pass-through authentication to enable pass-through authentication based on your Windows desktop credentials.

-Or-

Select Smart card to authenticate using a smart card and Personal Identification Number (PIN), and select Pass-through authentication to enable pass-through authentication based on the smart card and the smart card PIN. If you did not do so yet, insert your smart card in the smart card reader now.

-Or-

Select User-specified credentials to authenticate using credentials you specify here. Enter your user name, password, and domain information in the appropriate text boxes.
The Save password check box is selected by default. Clear the Save password check box if you do not want to save your password in clear text.

If you are connecting to a MetaFrame server or published application that is configured to use Novell NetWare Directory Services (NDS), enter your NDS distinguished name in the User Name field and your password in the Password field. Leave the Domain field blank.

5. 	Click OK.

Note:  The Save Password check box may not appear if it is disabled by an administrator. If the check box is disabled, you can enter user name and domain information only. At logon time, the MetaFrame server always prompts you for your password.


Connection dialog box
Connection

Use this tab to specify how you connect to the MetaFrame server.

The Connection tab has the following fields:

Connection type

Auto-detect network protocol

Always use Server Location network protocol

Network protocol

Server group

Address list

Firewalls


Add Server Location Address

1.	If you are adding the address of a MetaFrame server that is separated from your computer by a firewall,
enter the server’s external Internet address.

If you are adding the address of a MetaFrame server that is not separated from your computer by a firewall,
enter the server’s network address.

2.	Click OK.


Settings - General

Use the General Settings page to change the following properties:

Enable Dynamic Client Name

Client Name

Keyboard Layout

Keyboard Type

Display Connect To screen when making Dial-In Connections

Display terminal window when making Dial-In Connections

Allow automatic client updates

Pass-Through Authentication

Use local credentials to log on

These settings are applied to all connections.


Bitmap Cache page

The settings on the Bitmap Cache page are:

Bitmap Cache Size

Bitmap cache directory

Change directory

Minimum size bitmap

Clear Cache Now

See also:

Use disk cache for bitmaps


Hotkeys page

The Hotkeys page allows you to set the default hotkeys for a published application.

For each hotkey, select a shift state and a key.  You can disable the hotkey by selecting (none) for the key.


Event Logging Page

The Event Logging page allows you to instruct Program Neighborhood whether or not to keep a log of various events that occur while running published applications. For more information about the event logging options, choose one of the following topics:

Event Log File

Log Events


Serial Device dialog box

The Serial Device dialog box allows you to add, remove, and change properties of serial devices configured for use by Program Neighborhood. For more information about this dialog box, choose one of the following topics:

Add

Remove

Properties


Device Properties - General

Use this tab to configure the settings for your modem or serial device.

The following settings can be changed:

Port Type

Port Name

Communication Speed


Device Properties - Connection

Use this tab to configure the connection properties for your modem or serial device.

The settings that can be changed on the Connection page are:

Data Bits

Parity

Stop Bits

Advanced


Advanced Connection Settings

The Advanced Connection Settings dialog box allows you to edit advanced serial port settings.  For more information about this dialog box, choose one of the following topics:

Flow control

Hardware Flow Control

DTR State

RTS State


Change bitmap cache directory

Specify the location of the directory containing the cached image data.  If the specified directory does not exist, it is created.


Rename server location group

Use this field to change the name of the selected server location group.

Enter the new name and then click OK to save changes.


Locate Server or Published Application

Use this dialog box to specify how to search for servers or published applications that may not be on your network.

For more information, click one of the following topics:

Network Protocol

Server Group

Address List

Firewalls

See also:

Configuring Server Location Settings


Bitmap Cache Size

Use this tool to enter the amount of disk space (in kilobytes) to use for bitmap caching.


Bitmap cache directory

The default directory is displayed in this field. To specify a new directory for cached data, click Change Directory.


Change Directory

Select Change Directory to change the location of the disk cache directory.  The Change bitmap cache directory dialog box appears.


Minimum size bitmap

Specifies the smallest bitmap that will be cached to disk.


Clear Cache Now

Click Clear Cache Now to remove all current cache data.


Event Log File

Enter the name of the file to log Program Neighborhood events to in the Name field.

Select the Overwrite existing event log button to cause the event log file to be overwritten with new events when a published application is run.

Select the Append to existing event log button to keep old events and add new ones to the end of the file.


Log Events

Use these buttons to select the event categories that you want to log.  If no events are selected, no logging takes place.

Five event categories can be selected for logging:

•	Connections and Disconnections: Logs an event whenever Program Neighborhood connects and disconnects from a MetaFrame server.  This category is selected by default.

•	Errors: Logs an event whenever Program Neighborhood encounters an error. This category is selected by default.

•	Data Transmitted: Logs an event for each packet of information sent by Program Neighborhood to the MetaFrame server. This is primarily intended for technical support purposes.

•	Data Received: Logs an event for each packet of information received by Program Neighborhood from the MetaFrame server. This is primarily intended for technical support purposes.

•	Keyboard and Mouse Data: Logs an event whenever you press a key on the keyboard or move the mouse.  This is primarily intended for technical support purposes.


Add

Add a new serial device. Launches the Install a New Serial Device wizard.


Remove

Remove the selected serial device.


Properties

Click to view and configure serial device properties.


Port Type

The type of COM port to which the serial device is connected. The default is Standard COM Port.


Port Name

The name of the COM port.

Select a port name from the list or type a name in the text box.


Communication Speed

The speed of the serial connection.

Select a baud rate that matches the baud rate used by the MetaFrame server.


Data Bits

The number of data bits.  This value is always 8 for ICA connections.


Parity

The serial parity setting to use.

Select a type from the pull-down list.  Use None whenever possible.


Stop Bits

The number of stop bits to use.

Select a number from the pull-down list.  Use 1 whenever possible.


Flow control

The flow control method to use.  The selections are:

Hardware: Uses the hardware modem control signals specified in this dialog for flow control.  This is the default setting.

Software XON/XOFF: Uses software (XON/XOFF) flow control.

None: No flow control.  Not recommended at high baud rates due to overrun errors.


Hardware Flow Control

These fields define the type of hardware flow control used when Hardware Flow Control is specified.  The selections are:

Turn off [RTS|DTR] when receive buffer is full:  Specifies the signal to turn off when the Program Neighborhood receive buffer is full.  The default value is RTS.  If RTS is selected, the RTS State group box is ignored.  If DTR is selected, the DTR State group box is ignored.

Transmit data when [CTS|DSR] is on: Specifies the signal used by the modem to control Program Neighborhood is allowed to transmit data.  The default value is CTS.


DTR State

This defines the state of the DTR modem control signal.

Select On to turn on the DTR signal; select Off to turn off the DTR signal.

The DTR value required depends on your hardware configuration.  The default value of the DTR State is On.  This value is ignored if DTR hardware flow control is used.


RTS State

This defines the state of the RTS modem control signal.

Select On to turn on the RTS signal; select Off to turn off the RTS signal.

The RTS value required depends on your hardware configuration.  The default value of the RTS State is Off.  This value is ignored if RTS hardware flow control is used.


Use data compression

Data compression reduces the amount of data that needs to be transferred but requires additional processor resources to compress and decompress the data.  If your connection is bandwidth-limited, enabling data compression increases performance.

Check this option to use data compression with this published application.


Use disk cache for bitmaps

Check this option to store commonly-used graphical objects such as bitmaps in a local cache on your hard drive. If your connection is bandwidth-limited, enabling caching will increase performance. If your client device is on a high-speed LAN, you may prefer to disable caching and save disk space. Dial-in connections have disk caching enabled by default.


Queue mouse movements and keystrokes

Queuing causes the Program Neighborhood to send mouse and keyboard updates less frequently to the MetaFrame server. Check this option to reduce the number of network packets sent from Program Neighborhood to the MetaFrame server. Leaving this option unchecked makes the session more responsive to keyboard and mouse movements.


Enable sound

Check this option to enable sound support. Your client device must have a Sound Blaster 16-compatible sound card installed. Published applications will be able to play sounds on your client device.

•	High. This value provides the greatest audio quality but should only be used when bandwidth consumption is not a concern.

•	Medium. Using this value results in less bandwidth consumption than when using High. Compression of sound data provides greater bandwidth efficiency but reduces sound quality somewhat. This value is recommended for most LAN-based connections.

•	Low. This value offers the most efficient use of bandwidth but also decreases sound quality severely. This value is recommended for low-bandwidth connections, including most modem connections.


Encryption level

Select the level of encryption for the ICA connection. The default level is Basic.

The MetaFrame server must be configured to allow the selected encryption level or greater. For example, if the MetaFrame server is configured to allow RC5 56-bit connections, Program Neighborhood can connect with RC5 56- or 128-bit encryption.

Note: Selecting RC5 encryption disables automatic logon to the MetaFrame server.


Window Properties

Window Size specifies the window size in which published applications run.

If you are using Windows NT 3.51, Windows NT 4.0, Windows 95, Windows 98, or Windows 2000 to connect to a published application, you can select Seamless Windows. The published application appears on your local desktop in a separate, seamless window.

Window Colors specifies the number of colors displayed.

If the default settings are being used by either of the properties, the Use Custom Default (for custom ICA connections) or Use Server Default (for application sets) check box is selected. To change the settings, clear this check box and choose new settings from the drop-down menu. Click OK to save these settings.


Connection Type

Choose a Network or Dial-In connection type for the application set. Select Local Area Network to connect to the MetaFrame server over your LAN. Select Wide Area Network to connect to the MetaFrame server from a remote location. Select ICA Dial-in to connect to the MetaFrame server using a modem.


Network Protocol

The Network Protocol field instructs Program Neighborhood what low-level network protocol to use to locate and connect to the MetaFrame server.

If you select TCP/IP+HTTP on the Network Protocol list, Program Neighborhood attempts to resolve the name "ica" to an IP address if no server is specified. You must have a MetaFrame server on your network mapped to the default name "ica."

If you choose SSL+HTTPS from the Network Protocol list, you must have in the address list field the fully qualified domain name (FQDN) of the server hosting the digital certificate.

Select a network protocol from the list box.

Note:

When you set default settings for custom ICA connections, select HTTP/HTTPS in the Network Protocol list to use TCP/IP+HTTP or SSL+HTTPS. You must enter the fully qualified domain name (FQDN) of a MetaFrame server.


Server Group

Use the Server Group and Address List fields to create lists of specific servers that you want to designate as primary and backup servers for connecting to application sets. Backup server groups provide business recovery for your client device in the event that you cannot contact any servers in your primary group.

You can define up to three groups of MetaFrame servers to which you want to connect: a primary and two backups. Each group can contain from one to five servers. When you specify a server group for your client, Program Neighborhood attempts to contact all the servers within that group simultaneously (broadcasting) and the first server to respond is the one to which you connect.

Use this field to designate whether the servers entered in the Address List field belong to your Primary, first backup (Backup 1), or second backup (Backup 2) group.


Address List

Use the Address List field to view and change the list of MetaFrame servers used in the selected server group.

If you select TCP/IP+HTTP in the Network Protocol list, Program Neighborhood attempts to resolve the name "ica" to an IP address if no server is specified.  To use this process, you must have a MetaFrame server on your network mapped to the default name "ica."

If you select SSL+HTTPS in the Network Protocol list, you must enter the fully qualified domain name (FQDN) of the server hosting the digital certificate.

If you select any other entry in the Network Protocol list, Auto-Locate is selected by default if no server is specified. If Auto-Locate is selected, the nearest server is located automatically.

Click Add to add a MetaFrame server to your server group’s address list. The Add Server Location Address dialog box appears.

Click Delete to remove the selected MetaFrame server from the address list.

See also:

Server Group


Client Name

The Client Name allows you to change the name of your client device. The MetaFrame server uses the client name to uniquely identify resources (such as mapped printers and disk drives) associated with a given client device. The client name must be unique for each computer running Program Neighborhood.


Keyboard Layout

Allows you to specify the keyboard layout of your client device. The MetaFrame server uses the keyboard layout information to configure your user session for your keyboard layout. The default value of (User Profile) uses the keyboard layout specified in your user profile.


Keyboard Type

Allows you to specify the keyboard type of your client device. The MetaFrame server uses the keyboard type information to configure your user session for your keyboard type. Use the default value of Default for most English and European keyboards. When used with a Japanese keyboard, Default auto-detects the keyboard type.


Display Connect To screen when making Dial-In Connections

Select  this check box to display the Connect To screen when you make a Dial-In connection.


Display terminal window when making Dial-In Connections

Select this check box if your Dial-In configuration includes third-party products, such as security devices and X.25 PADs, that require an ASCII dialog before connecting to the MetaFrame server.


Allow automatic client updates

Select this check box to allow the MetaFrame server to update your Program Neighborhood software when newer versions become available. When the MetaFrame server detects an outdated version of Program Neighborhood, it notifies you that a newer version is available and replaces the ICA Client files.


Find New Application Set - Connection Type

Use the Connection page to choose a Network or Dial-In connection type for the application set. Select Local Area Network to connect to the MetaFrame server over your local network. Select Wide Area Network to connect to the MetaFrame server from a remote location. Select Dial-Up Networking (PPP/RAS) to connect to the MetaFrame server from a remote dial-up location.


Find New Application Set - Description and Location

In the Description field, type a brief description of the application set you are adding.  This description appears in your Program Neighborhood window under the icon for your application set.

To locate the application set you want to add, select from the drop-down list, or, if the application set is not on your network, click the Server Location button to display the Locate New Application Set dialog box.

For dial-up networking, select an existing entry from the drop down list, or click Configure to configure a new dial-up networking entry.


Find New Application Set - Display options

Check Enable sound to enable sound support. Your client device must have a Sound Blaster 16-compatible sound card installed. Published applications will be able to play sounds on your client device.

To override the default window properties for this application set, clear the Use Server Default check box. Select new options from the drop-down list.


Find New Application Set - Select a modem

Select a modem to use for your new application set.


Find New Application Set - Dialing Information

Enter area code, phone number, and country code to use for your new ICA connection.


Find New Application Set - Logon information

To configure the logon information for a new application set:

1. 	Select the application set to configure.

2. 	In the Program Neighborhood toolbar, click the Settings icon.

3. 	Click the Logon Information tab.

4. 	Select Local user to be prompted for authentication when you establish a connection.
Select Pass-through authentication to enable pass-through authentication based on your Windows desktop credentials.

-Or-

Select Smart card to authenticate using a smart card and Personal Identification Number (PIN), and select Pass-through authentication to enable pass-through authentication based on the smart card and the smart card PIN. If you did not do so yet, insert your smart card in the smart card reader now.

-Or-

Select User-specified credentials to authenticate using credentials you specify here. Enter your user name, password, and domain information in the appropriate text boxes.
The Save password check box is selected by default. Clear the Save password check box if you do not want to save your password in clear text.

If you are connecting to a MetaFrame server or published application that is configured to use Novell NetWare Directory Services (NDS), enter your NDS distinguished name in the User Name field and your password in the Password field. Leave the Domain field blank.

5. 	Click OK.

Note:  The Save Password check box may not appear if it is disabled by an administrator. If the check box is disabled, you can enter user name and domain information only. At logon time, the MetaFrame server always prompts you for your password.


Add New ICA Connection - File Name and Working Directory

Add New ICA Connection - Application and Working Directory

•	Application: This field specifies the filename of the application to run after the logon to the MetaFrame server is successful.  Leave it blank to run a Windows desktop on the MetaFrame server. Enter the fully qualified drive and path of the program to run, followed by any necessary command line parameters and switches.

•	Working Directory: This field specifies the working directory to use with the program specified in the Application field. Enter a working directory path in the edit field.


Add New ICA Connection - Connection Type

Use the Connection page to choose a Network or Dial-In connection type for the application set. Select Local Area Network to connect to the MetaFrame server over your local network. Select Wide Area Network to connect to the MetaFrame server from a remote location. Select ICA Dial-in to connect to the MetaFrame server using a modem. If you are accessing your network through Dial-up Networking, click Dial-Up Networking (PPP/RAS).


Add New ICA Connection - Network connection

The Network Connection dialog box is used to configure the network connection that Program Neighborhood will use to run a published application. For information about the various Network Connection fields, choose one of the following topics:

Description

Network protocol

Server

Published Application

Server Location


Add New ICA Connection - Logon Information

Enter a user name, password, and domain to use for this ICA connection or select the Use local username and password check box to use your local desktop user name and password as your logon credentials.


Add New ICA Connection - Display options

To override the default display options for this ICA connection, clear the Use Default check box. Select new options from the drop-down lists.

For Window Colors, select the number of window colors to use.

For Window Size, select the size of the window in which your ICA connection will run.


Add New Application Set - Finish

Find New Application Set - Finish

Click the Finish button to add your new application set to your Program Neighborhood window.


Custom ICA Connection - Application View

Use this dialog box to choose how to view your application.

Select Seamless Windows to view this connection in a separate window on your local desktop.

Select View in a remote desktop window to view this connection within a remote desktop.


Application

This field specifies the application to run after the logon to the MetaFrame server is successful. Leave it blank to run a Windows desktop on the MetaFrame server.


Working Directory

This field specifies the working directory to use with the program specified in the Application field.


Change icon

Click the Change Icon button to use a different icon for a published application.  The Change icon dialog box appears.


Description

A short description that appears in the Program Neighborhood window. This description also appears in the title bar of the Program Neighborhood window when the published application is run.

Enter a description in the edit field.

Note: The description cannot contain any of the following characters:  \ / : * ? " < > | , . ( ) [ ]


Server

When the Server radio button is selected, this field specifies the MetaFrame server to which the client will connect.

Note:  If the list box is empty or the name of the MetaFrame server you want to connect to is not present in the list, you may need to enter an address for the MetaFrame server, based on the Network Protocol selected.  For a TCP/IP Network Protocol, type the IP address of the MetaFrame server, for example: 128.128.1.50.  For an IPX or SPX Network Protocol, type the network : node of the MetaFrame server, for example: AA:0000E8C046BF.


Published Application

When the Published Application radio button is selected, this field specifies the published application that will be run. Choose a published application from the drop-down list.


Auto-detect network protocol

Select this radio button to auto-detect the network protocol to use to connect to the application set.


Always use Server Location network protocol

Select this radio button to use the a  Network Protocol defined in  the drop-down list of  the Server Location section of the Connection tab. This protocol will be used every time the client connects to the server.


Custom ICA Connections Properties - Default Options Tab

This page displays the default options for all of your custom ICA connections. To use these defaults, you must select the Use Custom Default check box on the Options tab for your custom ICA connection.

Note: If you are connected to the server or published application by LAN, the default sound quality is Medium. If you are connected via WAN or using Dial-Up Networking, the default sound quality is Low.

Click one of the following topics for more information about the Custom ICA Connection Options page:

Enable sound

Encryption level

Window Properties


Change Icon dialog box

Use this dialog box to change the icon for your custom ICA connection.

Click Use Default to select an icon from the default list or click Browse to search for a new icon.


Finish page

Click Finish to add your new ICA connection to your Program Neighborhood window.


Add a new ICA Connection - Dialing information

Add New ICA Connection - Dialing information

Use this dialog box to specify your dialing information for Dial-in connections.

Enter area code, phone number, and country code to use for your new ICA connection.


Add a new ICA Connection - Select a modem

Add New ICA Connection - Select a modem

Use this dialog box to select and configure your modem.

Select a modem to use for your new ICA connection. Click Configure to change the properties for the selected modem.


Custom ICA Connection - Connection Properties

The Connection Properties page is used to configure the connection that Program Neighborhood will use to run the published application. If you are making a network connection, this dialog box displays the following:

Connection Type

Network Protocol

Server

Published Application

Server group

Address list

Use Custom Default

If you are making a dial-in connection, this dialog box displays the following:

Connection Type

Device Name

Configure

Phone Number


Logon

Enter your user name, password, and domain name for this application set.


Dialing prefixes

Dialing prefix page

You can configure your dialing prefixes on Citrix ICA Clients that do not use TAPI support. The ICA Win16 and Win32 Clients do not use TAPI when run on Windows NT 3.51.

For more information about the Dialing Prefixes page, click one of the following topics:

Prefix name

Add button

Rename button

Delete Button

Prefix


Prefix name

This list box contains the name of the currently selected dialing prefix. To rename this dialing prefix, click the Rename button.


Add Dialing Prefix

Use this dialog box to add a new dialing prefix.  Enter the dialing prefix in the field and click OK.


Rename Dialing Prefix

Enter the new name for the dialing prefix and click OK


Add button

Click this button to add a new dialing prefix. The Add Dialing Prefix dialog box appears.


Rename button

Click this button to rename the selected dialing prefix. The Rename Dialing Prefix dialog box appears.


Delete Button

Click this button to delete the selected dialing prefix.


Prefix

Contains the dialing prefix associated with the currently selected dialing prefix name.


Install a New Serial Device

Use this wizard to install a new serial device.


Install a New Serial Device - Select port

Select a port type and a port name from the drop-down lists to use with the selected device.


Install a New Serial Device - Finish

Click Finish to save your settings. To change these settings later, click the device in the Serial Device list and click Properties.


Server Application Settings

To change any of these settings, you must return to the application set and click Properties. Select the Default Options tab. If the server-defined settings are not required to run the application, you can override them using the Default Options settings for the application set.


Custom ICA Connections Properties - Connection Page
Custom ICA Connections Properties - Connection tab

Use this page to specify the server location settings for your custom ICA connections.

The Connection tab has the following fields:

Network Protocol

Server Group

Address List

Firewalls


Turn off desktop integration for this application set

Select this option if you do not want this application set to appear on your desktop.


Use Server Default

If this check box is selected, the default options specified on the MetaFrame server are used. To change these default options, clear this check box.


Properties

Click to view and change the properties of the selected serial device.


Install a New Modem Device

Your modem will be automatically detected. To select a modem from a list, check Don’t detect my modem; I will select it from a list.  Click Next.


Install a new Modem Device

No modem was detected. Check to make sure your modem is attached correctly. To select from a list, click Next.


Install a New Modem Device

Select your modem from the list.


Connect To

This dialog box is presented before making a Dial-In connection to a MetaFrame server. For information about the Connect To dialog fields, choose one of the following topics:

Phone number

Prefix Name

Edit Dialing Prefixes button

Don't display this screen next time I connect

Connect button


Phone number

The phone number used to contact the MetaFrame server, including an optional dialing prefix.

Type any desired changes in the phone number field.

Note:  Changes made to the phone number are used for the current connection; they are not saved for subsequent connections.


Prefix Name

An optional dialing prefix for the phone number.


Edit Dialing Prefixes button

Click this button to edit the dialing prefixes.


Don't display this screen next time I connect

Select this check box to skip the Connect To dialog box the next time you connect.


Connect button

Click this button to connect to the MetaFrame server.


Dialing Prefixes

The settings that can be changed on the Dialing Prefix page are:

Prefix Name

Add button

Rename button

Delete button

Prefix


Prefix Name

This list box contains the name of the currently selected dialing prefix.

Choose a dialing prefix to Rename or Delete from this list.


Add button

Click Add to add a new dialing prefix.


Rename button

Click Rename to rename the selected dialing prefix.


Delete Button

Click Delete to delete the currently selected dialing prefix.


Prefix

Contains the dialing prefix associated with the currently selected dialing prefix name.


Add Dialing Prefix

Enter a name for the new dialing prefix.


Rename Dialing Prefix

Enter the new name for the dialing prefix.


Connect To

This dialog box is presented before making a Dial-In connection to a MetaFrame server. For information about the Connect To dialog fields, choose one of the following topics:

Phone number

Prefix Name

Edit Dialing Prefix

Don't display this screen next time I connect

Connect button


Firewall Settings

Use the Firewall Settings page to configure your connection to a MetaFrame server through:

•	a firewall, using an alternate address,

•	the proxy server that your default Web browser is configured to use,

•	no proxy server, using a direct connection, or

•	a SOCKS proxy server, or

•	a Secure (HTTPS) proxy server.

See also:

Use alternate address for firewall connection

Use Web browser proxy settings

Proxy Type:

None (direct connection)

Connect through SOCKS proxy

Connect through Secure (HTTPS) proxy

Secure Gateway


SOCKS Proxy Server

Select this option to configure Program Neighborhood to connect to a MetaFrame server through a SOCKS proxy server.  You must also enter the IP address and the port number of the SOCKS proxy server.


Use alternate address for firewall connection

Select this check box to browse for MetaFrame servers and published applications across a firewall. You must then return to the Connection tab to enter the external Internet address of the MetaFrame server in the Address List:

1.	Select the Use alternate address for firewall connection check box.

2.	Click OK to return to the Connection properties tab.

3.	Click Add to display the Add Server Location Address dialog box.

4.	Enter the external Internet address of the MetaFrame server.

5.	Click OK.


SOCKS

Select this option to configure Program Neighborhood to connect to a MetaFrame server through a SOCKS proxy server.  You must also enter the IP address and the port number of the SOCKS proxy server.


Device Name

Select the name of your serial device from the drop-down list.


Configure Button

To configure your serial device, click this button to display the Device Properties page.


Phone Number

Enter the phone number you are using to make the connection.


Install a New Modem Device
Install a New Modem Device - Detected Modem

A modem has been detected. Select your modem type from the drop-down list. If your modem type is unknown, it will not appear on this list, and you must click the Change button to choose a modem.


SpeedScreen Latency Reduction

Latency Reduction is a collective term used to describe the functionality that helps enhance user experience on slower network connections. Latency Reduction is available only if you are connecting to a server that is configured and licensed for latency reduction.

Select a mode from the drop-down list.

For slower connections (for example if you are connecting over a WAN or a dial-in connection), set mode to On to decrease the delay between user input and screen display. Choose either Mouse Click Feedback or Local Text Echo.

For faster connections (for example, if you are connecting over a LAN), set mode to Off.

If you are not certain of the connection speed, set mode to Auto to turn Latency Reduction on or off depending on the latency of the connection.  You can override Auto mode using the Toggle Latency Reduction hotkey.


Use local credentials to log on

Select this option to pass the local desktop password to the server.  Your local desktop password will be used for each ICA session logon, eliminating the need for multiple authentications.  Pass-Through Authentication must be enabled at the machine level by an administrator of the machine.


Address of SOCKS proxy to use

Type the address of the SOCKS proxy server to use to connect to the MetaFrame server.


Select encryption level

Select the level of encryption for the ICA connection. The default level is Basic.

The MetaFrame server must be configured to allow the selected encryption level or greater. For example, if the MetaFrame server is configured to allow RC5 56-bit connections, Program Neighborhood can connect with RC5 56- or 128-bit encryption.

Note: Selecting RC5 encryption disables automatic logon to the MetaFrame server.


Scaling the ICA Session Window

The scaling feature provides controls for you to resize the ICA session window to fit your desktop. When a new session starts, if the client device has sufficient memory, scaling is enabled. Scaling is disabled if memory resources are insufficient.

To scale the ICA session window:

1. Access the System tools by right-clicking at the top of the ICA session window.

2. Select Resize Window. The following Scaling controls are available:

Shrink - Decreases the session window size by 10%.

Expand - Enlarges the session window size by 10%.

Custom - Scales the session window to the size you specify. Enter either width and height values (in pixels), or a scaling percentage value.

Note: Scaling an ICA session reduces the display update speed.


Use Custom Default

Select this check box to use the global settings specified for all custom ICA connections. To override the global settings, clear the check box to specify new settings.


Local Text Echo

Accelerates the display of input text on the client device.


Pass-Through Authentication

If you are logged on as an administrator of the client device, select this option to enable single sign-on at the machine level. Each user must turn this feature on by selecting the Use local user name and password for logon option.


Secure (HTTPS) proxy server

Select this option to configure Program Neighborhood to connect to a MetaFrame server through a Secure (HTTPS) proxy server.  You must also enter the IP address and the port number (if other than 8080) of the Secure (HTTPS) proxy server.

Note: Enable SSL or 128-bit encryption to assure a secure connection.


Use Web browser proxy settings

Select this option for Program Neighborhood to detect and apply the proxy server settings configured through your default Web browser.


Enable Dynamic Client Name

Selecting Enable Dynamic Client Name forces your ICA Client name to match the client device name. If the device name is changed, the ICA Client name is changed to match the device name.