Contents for Application Security Registration Utility
Contents for ICA Editor

 What is the ICA Editor?

 To Make an ICA Editor Installation Diskette

 Installing the ICA Editor

 Creating an ICA File

 Editing an ICA File

 Deleting an ICA File

 ICA File Properties


What is the ICA Editor?

The ICA Editor creates and maintains ICA files. ICA files are used by the WinFrame Client for Web Computing to launch published applications on a WinFrame server. The ICA file and the published application definition file together define the attributes of the session to be launched on the WinFrame server including:

The address of the WinFrame server

The username, password, and domainname to use when connecting to the WinFrame server

The name of the application, used for application publishing

The application window size and color depth

The encryption level and compression

The ICA editor can be installed on any Windows 95, or Windows NT 4.0 computer. Administrators can use the Application Configuration utility to create ICA files for published applications. The ICA Editor can be used by both administrators and non-administrators to create ICA files. You can use the WinFrame Client Creator to make an ICA File Editor installation diskette.

ICA files, once created, appear as icons on the desktop.

See Chapter 24, "Application Publishing" of the System Guide for more information on the ICA Editor and WinFrame application publishing.


To Make an ICA Editor Installation Diskette

1	Have a 3.5-inch floppy disk on hand. Double-click on WinFrame Client Creator in the Administrative Tools menu. The Make Installation Disk Set dialog box appears.

2	Select WinFrame ICA File Editor and click OK.

3	Follow the directions on screen.

See Also

Installing the ICA Editor


Installing the ICA Editor

1	Insert the ICA Editor installation diskette in drive A (or other appropriate drive) of the computer.

2.	Execute a:setup using the Run option of the Start menu.

3	Follow the displayed instructions.

See Also

To Make an ICA Editor Installation Diskette


Creating an ICA File

1	Click the right mouse button while the mouse pointer is on a blank portion of the desktop, or select the File pull-down menu for a disk drive, or select the File menu item from any Microsoft Explorer window to which you wish to add an ICA file.  The task menu appears.

2.	Click on New and then click on Citrix WinFrame ICA when the New menu appears.  The ICA Editor Wizard now walks you through creating an ICA file.

3.	The Select a Published Application screen appears.  The list of published applications for the network appears in the Published Applications list box.  Choose a published application from the list and select Next to continue.

4.	The Select Encryption Level screen appears. Select the level of encryption for the ICA connection. The default level is Basic. Strong encryption using the RC5 algorithm is available with the SecureICA Option Pack. The SecureICA Option Pack enables RSA RC5 encryption with 40, 56, or 128 bit session keys. Select RC5 128-bit Login Only to use encryption during authentication.

5.	The Select Compression screen appears. 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 will increase performance. If your client is on a high-speed LAN, you may not need compression.

6.	The Select a Title for the Published Application screen appears.  The title you specify in the text box will appear as the name of the ICA icon on your desktop, as the title of the application window, and as the name of the ICA file.  Select Finish to create and save the ICA file.  An ICA icon with the application name appears on your desktop.

Notes

The Primary WinFrame server value is usually Auto Locate.  Auto Locate means that the ICA Editor automatically locates the WinFrame server containing the list of published applications.  In installations where the WinFrame server containing the list of published applications is not on the local network, (for example, when there is a router or Internet connection between the WinFrame server and the client PC), you can specify the WinFrame server and network containing the published application list by clicking on Server Location.

Some Web browsers and servers cannot properly handle long file names or file names with embedded blanks or special characters.  For best results, especially with 16-bit software, you may want to use FAT-format file names (8 characters or less, with no special characters or embedded blanks).

See Also

Editing an ICA File


Editing an ICA File

1	Click the right mouse button while the mouse pointer is on the icon of the ICA file you want to edit, or select the ICA file and click on File in File Manager, or select the ICA file and click on File in Microsoft Explorer.  The Task menu appears.

2.	Select Properties.  The Properties screen appears.  The Properties screen contains operating-system dependent pages, plus three ICA pages: the Address page, the Connection page, and the Window page.  See ICA File Properties for information on the ICA Properties pages.

3	Follow the displayed instructions.

See Also

ICA File Properties


Deleting an ICA File

1	Click the right mouse button while the mouse pointer is on the icon of the ICA file you want to delete, or select the ICA file and click on File in File Manager, or select the ICA file and click on File in Microsoft Explorer.  The Task menu appears.

2.	Select Delete.  You are asked if you want to delete the ICA file.  Click Yes to delete the ICA file.


ICA File Properties

The ICA File Properties pages are added to the operating system-dependent Properties pages, and are used to maintain the information contained in an ICA file.  The ICA Editor adds three ICA-specific pages:

The Address Page

The Connection Page

The Window Page


Choose the Remote Application Type

Use this screen to specify if the application definition refers to a previously published application or to an application you will define.


Click on this to create an application definition that will connect to a previously published application.


Click on this to create an application definition that will connect to a WinFrame server or server cluster and run an explicitly defined application.


Select a Network Protocol

Use this screen to specify the network protocol used to connect to the remote application.


Specify the network protocol used to publish applications.


Select a Published Application

Use this screen to select a published application or to change the WinFrame server containing the published application list.


The WinFrame server that maintains the list of published applications on the network.  If Auto-Locate is specified, this server is determined automatically.  A WinFrame server can be explicitly specified if the WinFrame server that will run the published application is on another network (for example, if the WinFrame server is on the other side of a network router or over the Internet).


Click on Server Location to change the WinFrame server containing the published application list.


Displays the list of published applications on this network.


Refreshes the list of published applications.


Choose a WinFrame Server

Use this screen to select a WinFrame server to run the application.


The WinFrame server that maintains the list of WinFrame servers on the network.  If Auto-Locate is specified, this server is determined automatically.  A WinFrame server can be explicitly specified if the WinFrame server that will run the application is on another network (for example, if the WinFrame server is on the other side of a network router or over the Internet).


Click this to change your server location settings.


This is the list of available WinFrame servers on the network.


Click this to refresh the list of WinFrame servers on the network.


Specify an Explicit Application

Use this screen to specify the command line and working directory for the explicit application.  If no command line or working directory are specified, you will run a Windows NT desktop.


Specify the command line for the explicit application.  If no command line or working directory are specified, you will run a Windows NT desktop.


Specify the working directory for the explicit application.  If no command line or working directory are specified, you will run a Windows NT desktop.


Specify Logon Information

Specify the username, domainname, and password used to log on to the remote WinFrame server.

Notes

If the application is an Anonymous published application or if RC5 encryption is specified, these fields are ignored.

If the application is an Explicit application and any of these fields are missing or incorrect, the user will get a logon prompt when the application is launched.


The username used to log on to the remote WinFrame server.


The domainname used to log on to the remote WinFrame server.


The password used to log on to the remote WinFrame server.


Choose Window Options

Use this screen to specify the size and color depth of the application window that appears on the desktop when the application is launched.


Click Absolute (in pixels) to specify the size of the application window in pixels (Width X Height).  If the specified application window size is larger than the screen, the screen’s maximum size is used.


Click Relative (% of desktop size) to specify the size of the application window as a percentage of the screen size; for example, a relative size of 25% will take up a quarter of the screen no matter what the screen size in pixels.


Specifies the width of the application window in pixels.


Specifies the height of the application window in pixels.


Specifies the size of the application window as a percentage of the screen size.


Specifies a 16-color color depth.


Specifies a 256-color color depth.


Select a Title for the Remote Application

Use this screen to specify a title for the remote application.  The title you specify appears as the name of the ICA icon on your desktop, as the title of the application window, and as the name of the ICA file.

Note: Some Web browsers and servers cannot properly handle long file names or file names with embedded blanks or special characters.  For best results, especially with 16-bit software, you may want to use FAT-format file names (8 characters or less, with no special characters or embedded blanks).


The title for the remote application.  This title appears as the name of the ICA icon on your desktop, as the title of the application window, and as the name of the ICA file.  Some Web browsers and servers cannot properly handle long file names or file names with embedded blanks or special characters.  For best results, especially with 16-bit software, you may want to use FAT-format file names (8 characters or less, with no special characters or embedded blanks).


Address property page

The Address property page contains the following information:

The network protocol used

The server location settings

The application type (published or explicit)

For published applications, the name of the published application

For explicit applications, the name of the WinFrame server


The network protocol used to publish the application.


The WinFrame server that maintains the list of WinFrame servers on the network.  If Auto-Locate is specified, this server is determined automatically.  A WinFrame server can be explicitly specified if the WinFrame server that will run the application is on another network (for example, if the WinFrame server is on the other side of a network router or over the Internet).


Click this to change your server location settings.


Click on this to change the application definition to connect to a previously published application.


Click on this to change the application definition to connect to a WinFrame server or server cluster and run an explicitly defined application.


Displays the list of published applications on this network.


Displays the WinFrame servers on this network.


Refreshes the list of published applications or WinFrame servers.


Address property page

The Address property page contains the following information:

The server location settings

The name of the published application


Connection property page

The Connection property page contains the description for the ICA file, the encryption level, compression, and the username, domainname, and password used to logon to the WinFrame server.

Note: If the application is an anonymous application, the username, domainname, and password are not used. The username, domainname and password are not sent when RC5 encryption is specified.


The description for the ICA file.  This description appears as the name of the ICA icon on your desktop, as the title of the application window, and as the name of the ICA file.

Note: Some Web browsers and servers cannot properly handle long file names or file names with embedded blanks or special characters.  For best results, especially with 16-bit software, you may want to use FAT-format file names (8 characters or less, with no special characters or embedded blanks).


The username used when connecting to the WinFrame server.

Note: If the application is an anonymous application, the username is not used. The username is not sent when RC5 encryption is specified


The domainname used when connecting to the WinFrame server.

Note: If the application is an anonymous application, the domainname is not used. The domainname is not sent when RC5 encryption is specified


The password used when connecting to the WinFrame server.

Note: If the application is an anonymous application, the password is not used. The password is not sent when RC5 encryption is specified


The command line for an explicit application.


The working directory for an explicit application.


Window property page

The Window property page contains the size and color depth of the application window.


Click Absolute (in pixels) to specify the size of the application window in pixels (Width X Height).  If the specified application window size is larger than the screen, the screen’s maximum size is used.


Click Relative (% of desktop size) to specify the size of the application window as a percentage of the screen size; for example, a relative size of 25% will take up a quarter of the screen no matter what the screen size in pixels.


Specifies the width of the application window in pixels.


Specifies the height of the application window in pixels.


Specifies the size of the application window as a percentage of the screen size.


Specifies a 16-color color depth for the application window.


Specifies a 256-color color depth for the application window.


Server Location dialog

This dialog lets you specify the WinFrame servers that maintain the published application list, and add, delete, or reorder the servers in the list.  Auto-Locate means that the server used to maintain the published application list is determined automatically, and is on the local network.

WinFrame servers that are on another network (for example, on the other side of a router or over the Internet) must be explicitly specified in the address list to be used for application publishing.


Displays the network protocol used.


Displays the list of WinFrame servers that maintain the published application list.  Auto-Locate means that the WinFrame server used to maintain the published application list is determined automatically, and is on the local network.

WinFrame servers that are on another network (for example, on the other side of a router or over the Internet) must be explicitly specified in the address list to be used for application publishing.


Uses the last saved list for this network protocol.


Adds a WinFrame server to the address list.


Deletes a WinFrame server from the address list.


Moves the selected WinFrame server up one position in the address list.


Moves the selected WinFrame server one position down in the address list.


Add Server Address dialog

Use this dialog to specify the network address of a WinFrame server containing a published application list.  This is only needed if the WinFrame server is on another network (for example, if the WinFrame server is on the other side of a network router or over the Internet).


Specify the network address of a WinFrame server containing a published application list.  This is only needed if the WinFrame server is on another network (for example, if the WinFrame server is on the other side of a network router or over the Internet).


Select Encryption Level

Select the level of encryption for the ICA connection. The default level is Basic. Strong encryption using the RC5 algorithm is available with the SecureICA Option Pack. The SecureICA Option Pack enables RSA RC5 encryption with 40, 56, or 128 bit session keys. Select RC5 128-bit Login Only to use encryption during authentication.

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

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


Select 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 will increase performance. If your client is on a high-speed LAN, you may not need compression.


Select the level of encryption for the ICA connection. The default level is Basic. Strong encryption using the RC5 algorithm is available with the SecureICA Option Pack. The SecureICA Option Pack enables RSA RC5 encryption with 40, 56, or 128 bit session keys. Select RC5 128-bit Login Only to use encryption during authentication.


Select the level of encryption for the ICA connection. The default level is Basic. Strong encryption using the RC5 algorithm is available with the SecureICA Option Pack. The SecureICA Option Pack enables RSA RC5 encryption with 40, 56, or 128 bit session keys. Select RC5 128-bit Login Only to use encryption during authentication.


Data compression reduces the amount of data that needs to be transferred but requires additional processor resources to compress and decompress the data.


Data compression reduces the amount of data that needs to be transferred but requires additional processor resources to compress and decompress the data.


<< help not yet complete for this control>>


<< help not yet complete for this dialog>>


<< help not yet complete for this message box>>

<< If you wish to author help specific to each message box prompt, then remove the AFX_HIDP_xxx values from the [ALIAS] section of your .HPJ file, and author a topic for each AFX_HIDP_xxx value.  For example, AFX_HIDP_INVALID_FILENAME is the help topic for the Invalid Filename message box. >>