Symbols Used in Scripts

The SecureLogin scripting language uses the following symbols to define the function of lines in the script:


The Pound Symbol (#)

Use the pound or hash symbol (#) to define a line of text as a comment field, so that you can leave notes within a script. The script engine ignores any line that starts with a # symbol.

You can use comment lines to do the following:

When used within a command (for example, Class or Type), the pound or hash symbol takes on a different meaning, specifying a numerical value. This numerical value can be used to specify a target for the command. The command listings provide additional details. See SecureLogin Commands.


Quotation Marks ("")

Use quotation marks ("") to group text or variables that contains spaces. Use these symbols with commands such as Type, MessageBox, and If -Text. Without quotation marks, command lines such as the following won't work as expected:

Type Database 2 
MessageBox Confirm your login details.
If-Text Login failure

For these command lines to work, quotation marks must be used to group the text:

Type "Database 2" 
MessageBox "Confirm your login details."
If-Text "Login failure"


The Dollar Sign ($)

Use the dollar sign ($) to define a SecureLogin variable that is persistent. Use these variables to store information such as usernames and passwords. For more information on the $ variable, see Stored Variables.


The Question Mark (?)

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. However, with the use of the Local command, these variables are reset each time the script is started. Use these variables to store temporary information, such as counting, data processing, and date information.

The question mark is also used with several internal system-generated variables. For more information on the ? variable, see Runtime Variables.


The Percent Sign (%)

Use the percent sign (%) to define the use of a directory attribute. The attributes that are available vary, depending on the directory in use and the setup of the directory. Examples of the attributes you can use are %CN and %Surname.

For more information on the types of variables, see Understanding Script Variables.


The Exclamation Mark (!)

Use the exclamation mark (!) to define the use of a passticket. A passticket is a one-time password that is generated using a combination of an encryption key, encryption offset, and the current time. Such passwords are only valid for a short time (from 30 seconds up to 2 minutes). The encryption key and offset can be defined manually or automatically generated for the program.

For more information, see Passticket Variables.


The Backslash (\)

Use the backslash symbol (\) with the Type and SendKey commands to specify the use of a special function. The symbol is used in conjunction with values to simulate keystrokes. For example, use \N to simulate pressing the Enter key in a Windows application.

For details on the values that can be used with the backslash symbol, see the command listings in SecureLogin Commands.


The @ Symbol

The @ symbol is similar to the backslash symbol. However, the @ symbol is limited to HLLAPI-enabled emulators. Use it in conjunction with values to simulate keystrokes. For example, use @E to simulate pressing the Enter key in a terminal emulator application.

For more information on the @ symbol, see @ Commands Used with Emulators and the command listings.


The Hyphen (-)

Use the hyphen (-) as a switch within several commands (for example, If and Type). Use it in conjunction with values to modify the behavior of commands (such as -Raw), or to switch certain functions (such as -YesNo) on or off.

For details on the values that you can use with the hyphen, see the command listings in SecureLogin Commands.