Progress
Language Reference


CODEBASE-LOCATOR System Handle

Interfaces
OS
SpeedScript
Graphical only
Windows only
No

A handle to the CODEBASE-LOCATOR object. A CODEBASE-LOCATOR object specifies the location and authentication information for a client application’s codebase (that is, an application’s files) stored on an AppServer or a web server. This object allows the WebClient to access application files for download. It also allows WebClient and the client application to share authentication information.

SYNTAX

CODEBASE-LOCATOR [ :attribute ] 

attribute

Specifies an attribute of the CODEBASE-LOCATOR handle. The attributes are listed below.

Attribute
Type
Description
CHARACTER
Connection parameter for the AppServer CONNECT( ) method. Valid only if LOCATOR-TYPE is "AppServer".
CHARACTER
Password parameter for the AppServer CONNECT( ) method. Valid only if LOCATOR-TYPE is "AppServer".
CHARACTER
Userid parameter for the AppServer CONNECT( ) method. Valid only if LOCATOR-TYPE is "AppServer".
CHARACTER
A freeform string that WebClient uses when prompting for a userid and password, if it does not find those values in the security cache.
LOGICAL
Indicates whether WebClient should keep any server connection, that it creates, open after downloading a file (TRUE) or not (FALSE).
LOGICAL
Indicates whether WebClient saves the values of the attributes in the security cache between sessions (TRUE) or not (FALSE), as requested by the user. The default value is FALSE.
CHARACTER
The type of server on which
the application files are stored. Valid values are "AppServer" or "InternetServer".
LOGICAL
Indicates whether WebClient should prompt for AppServer connection parameters, if it does not find those values in the security cache, (TRUE) or not (FALSE). Valid only if LOCATOR-TYPE is "AppServer".
LOGICAL
Indicates whether WebClient should prompt for an Internet server userid and password, if it does not find those values in the security cache, (TRUE) or not (FALSE).
LOGICAL
Indicates whether WebClient disables the saving of security cache attribute values between sessions (TRUE) or not (FALSE). When TRUE, KEEP-SECURITY-CACHE will be FALSE.
HANDLE
Returns the server handle to the Progress AppServer for use in accessing application files. Valid only if LOCATOR-TYPE is "AppServer".
CHARACTER
The CODEBASE-LOCATOR widget type, which is PSEUDO-WIDGET.
CHARACTER
A URL to connect to an AppServer, through the AppServer Internet Adapter (AIA), or a web server. Valid URL values depend on the LOCATOR-TYPE.
CHARACTER
Password parameter for connecting to the server referenced in the URL, if required by the URL protocol.
CHARACTER
Userid parameter for connecting to the server referenced in the URL, if required by the URL protocol.

NOTES

SEE ALSO

CONNECT( ) Method (AppServer)


Copyright © 2004 Progress Software Corporation
www.progress.com
Voice: (781) 280-4000
Fax: (781) 280-4095