(Windows only; Graphical interfaces only)

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 application server 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.

Note: Does not apply to SpeedScript programming.

Syntax

CODEBASE-LOCATOR [ :attribute ]
attribute
Specifies an attribute of the CODEBASE-LOCATOR handle.

Attributes

APPSERVER-INFO attribute APPSERVER-PASSWORD attribute APPSERVER-USERID attribute
END-USER-PROMPT attribute HANDLE attribute INSTANTIATING-PROCEDURE attribute
KEEP-CONNECTION-OPEN attribute KEEP-SECURITY-CACHE attribute LOCATOR-TYPE attribute
NEEDS-APPSERVER-PROMPT attribute NEEDS-PROMPT attribute PERSISTENT-CACHE-DISABLED attribute
SERVER attribute TYPE attribute URL attribute
URL-PASSWORD attribute URL-USERID attribute –

Notes

  • The CODEBASE-LOCATOR handle applies only to WebClient.
  • The following attributes represent the security cache: APPSERVER-INFO, APPSERVER-PASSWORD, APPSERVER-USERID, URL-PASSWORD, URL-USERID, and KEEP-SECURITY-CACHE. These attributes are readable and writable.
  • WebClient sets the following read-only attributes based on values stored in the application configuration (.ProwcApp) file: END-USER-PROMPT, KEEP-CONNECTION-OPEN, LOCATOR-TYPE, NEEDS-APPSERVER-PROMPT, NEEDS-PROMPT, PERSISTENT-CACHE-DISABLED, and URL.
  • Valid URL protocols depend on the LOCATOR-TYPE. If LOCATOR-TYPE is "AppServer", valid URL protocols include: HTTP, HTTPS, and AppServer. If LOCATOR-TYPE is "InternetServer", valid URL protocols include: HTTP, HTTPS, and FILE.
  • The TYPE attribute returns the widget type, PSEUDO-WIDGET.

See also

CONNECT( ) method (AppServer)