3.5 Application Definition Elements

Application definitions use various symbols to define the function of each line.

Table 3-3 Symbol Definitions

Symbol

Description

#

Use this symbol to define a line of text as a comment. Comment fields are used to leave notes.

Any line that starts with a # is ignored.

Use comment lines for the following:

  • Defining sections of an application definition, for example the login window and Change Password window.

  • Explaining complex sections.

  • Removing command lines during creation and editing of the application definition. This saves continuously deleting and rewriting lines while testing.

  • Making notes such as when the application definition was written, what version of the software it was written for, and so on.

When used as part of a command, such as Class or Type, the sym-bol precedes a numerical value. You can use these numerical values to specify a target for the com-mand.

For example: Type $Username #1 or Class #32770

" "

Use quotation marks to group together text or variables that con-tain spaces. Quotation marks are used with commands such as Type, MessageBox, and If -Text.

For these command lines to work, you must use quotation marks in the follow-ing method to group the text together:

  • Type "Database 2"

  • MessageBox "Please confirm your log in details."

  • If -Text "Login failure"

$

Use the dollar sign to define a variable to be stored by SecureLogin as part of application credential set. The stored value will be retrieved and used by SecureLogin for any future instances of the application.

These variables are used to store information such as user-names and pass-words.

?

Use the question mark to define the use of a runtime variable. The values of these variables are not stored in the directory; they are reset each time SecureLogin is started.

Alternatively, with the use of the Local command, these variables are reset each time the application definition is started.

These variables are used for temporary information, such as counting, data processing, and date information. The question mark is also used to identify some system runtime variables. For example, ?SysUser and ?SysPassword.

%

Use the percentage sign to have SecureLogin retrieve the value of a directory attribute of the user object. The attributes available vary depending on the directory in use, and the setup of the directory.

Examples of the attributes you can use are FCN and Surname. Type %FCN or Type %Sur-name.

NOTE:The attribute name defined here needs to be in the exact case and syntax as the attribute name in the directory. Also, Quotes are required around the variable if the attribute name contains a space. For example,

Set ?text "%Login Time"

or

Messagebox "%Given Name"

For more information, see Section 4.1.2, Directory Attribute Variables.

\

Use the backslash with the Type and SendKey com-mands to specify the use of a special function.

The backslash is used along with values to perform the sim-ulation of the pressed keys on the keyboard. Examples of frequently used func-tions are provided in the fol-lowing list:

  • \Alt-F: Alt+F on the keyboard in Windows and Web applications.

  • \D: Delete key in a Windows and Web applications. Not applicable to terminal emulators.

  • \N: Enter key in a Windows and Web applications. Not applicable to terminal emulators.

  • \T: Tab in Windows and Web applications.

  • \-T: Shift+Tab in Windows and Web applications.

@

Use the same way as the backslash symbol, except its use is limited to HLLAPI-enabled emulators.

This symbol is used along with values to perform the simu-lation of pressed keys on the keyboard when communicating with a host in a terminal emulator application. For example, use @E to simulate pressing the Enter key in a terminal emulator application.

-

Use the hyphen as a switch within several commands, such as If and Type.

The hyphen is used along with values to modify the behavior of com-mands (such as -Raw), or to switch on or off certain functions (such as -YesNo).