1.0 Quick Command Reference

This section provides a quick reference to the commands.

Table 1-1 Quick Command Reference

Command

Description

#

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

For detailed information, see #.

""

Use quotation marks to group together text or variables containing spaces. Quotation marks are used with commands like Type, MessageBox, and If -Text.

For detailed information, see " ".

$

Use the dollar sign to define the use of a SecureLogin variable stored in the directory for later use by that user.

For detailed information, see $.

?

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.

For detailed information, see ?.

%

Use the percentage 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.

For detailed information, see %.

!

Use the exclamation mark to define the use of a passticket. A passticket is a one-time password (OTP) that is generated by using a combination of an encryption key, encryption offset, and the current time.

For detailed information, see !.

\

Use the backslash with the Type and Send Key commands to specify the use of a special function.

For detailed information, see \.

@

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

For detailed information, see @.

-

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

For detailed information, see -.

AAVerify

Use AAVerify with SecureLogin Advanced Authentication or Novell NMAS to verify the user. It is typically used before the application Username and Password are retrieved and entered into the logon box.

For detailed information, see Section 5.2.1, AAVerify.

ADD

Adds one number to another. The numbers can be hard-coded into the application definition, or they can be variables. The result can be the output of another variable, or one of the original numbers.

For detailed information, see Section 5.2.2, ADD.

Attribute

Use the Attribute specifier in conjunction with the Tag/EndTag command to specify which HTML attributes and attribute values must exist for that particular HTML tag.

For detailed information, see Section 5.2.3, Attribute.

AuditEvent

Use the AuditEvent to audit the following events from an application definition:

  • SecureLogin client started

  • SecureLogin client exited

  • SecureLogin client activated by user

  • SecureLogin client deactivated by user

  • Password provided to an application by a script

  • Password changed by the user in response to a changepassword command

  • Password changed automatically in response to a changepassword command

For detailed information, see Section 5.2.4, AuditEvent.

BeginSplashScreen/EndSplashScreen

Use to display a Novell splash screen across the whole Terminal Emulator window. This is used to mask any flashing produced by SecureLogin scraping the screen for text. A Delay command at the start of the application definition ensures that the emulator window is in place before the splash screen is displayed.

For detailed information, see Section 5.2.5, BeginSplashScreen/EndSplashScreen.

BooleanInput

Use BooleanInput within a site block to set the state of a Boolean field (either a check box or radio button).

For detailed information, see Section 5.2.6, BooleanInput.

Break

Use Break within the Repeat/EndRepeat commands to break out of a repeat loop.

For detailed information, see Section 5.2.7, Break.

Call

Use the Call command to call and run a subroutine. When a subroutine is called, the application definition begins executing from the first line of the subroutine.

For detailed information, see Section 5.2.8, Call.

ChangePassword

Use the ChangePassword command to change a single variable and is used in scenarios where password expiry is an issue. Set the <Variable> to the new password.

For detailed information, see Section 5.2.9, ChangePassword.

Class

When a window is created, it is based on a template known as a window class. The Class command checks to see if the class of the newly created window matches its <Window-Class> argument.

For detailed information, see Section 5.2.10, Class.

ClearPlat

Use to reset the last chosen platform, causing subsequent calls to ReLoadPlat to do nothing.

For detailed information, see Section 5.2.11, ClearPlat.

ClearSite

Use within a Site block to clear the ‘matched’ status for a given site.

For detailed information, see Section 5.2.12, ClearSite.

Click

When used with windows applications, the Click command sends a click instruction to the specified <#Ctrl-ID>.

For detailed information, see Section 5.2.13, Click.

ConvertTime

Use to convert a numeric time value, for example, ?CurrTime(system), into a legible format and store it in<String Time>.

For detailed information, see Section 5.2.14, ConvertTime.

Ctrl

Use the Ctrl command to determine if a window contains the control expressed in the <#Ctrl-ID> argument. The control ID number is a constant that is established at the time a program is compiled.

For detailed information, see Section 5.2.15, Ctrl.

DebugPrint

Use the DebugPrint command to display the text specified in the <Data> variable on a Debug console.The command can take any number of text arguments, including variables, (for example, DebugPrint "The user " $Username " has just been logged onto the system").

For detailed information, see Section 5.2.16, DebugPrint.

Decrement

Use the Decrement command to subtract from a specified variable. For example, you can use Decrement to count the number of passes a particular application definition has made.

For detailed information, see Section 5.2.17, Decrement.

Delay

Use the Delay command to delay the execution of the application definition for the time specified in the<Time Period> argument.

For detailed information, see Section 5.2.18, Delay.

Dialog/EndDialog

Use the Dialog/EndDialog command to identify the beginning and end of a dialog specification block respectively. You can use these commands to construct a dialog specification block, which consists of a series of dialog specification statements (for example Ctrl and Title).

For detailed information, see Section 5.2.19, Dialog/EndDialog.

DisplayVariables

Use the DisplayVariables command to display a dialog box that lists the user's stored variables (for example, $Username and $Password) for the current application.

For detailed information, see Section 5.2.20, DisplayVariables.

Divide

Use to divide one number by another. The numbers can be hard coded into the application definition, or they can be variables. The result can be output to another variable, or to one of the original numbers.

For detailed information, see Section 5.2.21, Divide.

DumpPage

Use the DumpPage command to provide information about the current Web page. Use for debugging Web page application definitions.

For detailed information, see Section 5.2.22, DumpPage.

EndScript

Use the EndScript command to immediately terminate execution of the application definition.

For detailed information, see Section 5.2.23, EndScript.

Event/Event Specifiers

Application definitions generally execute at the point when an application window is created. This corresponds to the WM_CREATE message that is received from an application window at startup.

By adding the Event specifier to a dialog block, you can override this behavior, so that an application definition only executes when the specified message is generated. If no Event specifier is given, it is equivalent to Event WM_CREATE.

For detailed information, see Section 5.2.24, Event/Event Specifiers.

FocusInput

Use within a Site Block to focus on an input field based on the Boolean value of “focus”.

For detailed information, see Section 5.2.25, FocusInput.

GenerateOTP

Used to generate a one time password (OTP) as an authentication method in lieu of a traditional fixed and static password.

The OTP is a hard token generated by the Vasco Digipass, RSA SecureID Token and Mini Token products or might be produced by a soft token generator funtionality embedded in SecureLogin.

For detailed information, see Section 5.2.26, GenerateOTP.

GetCheckBoxState

Use the GetCheckBoxState command to return the current state of the specified checkbooks. For detailed information, see Section 5.2.27, GetCheckBoxState.

GetCommandLine

Use the GetCommandLine command to capture the full command line of the program that is loaded, and save it to the specified variable.

For detailed information, see Section 5.2.28, GetCommandLine.

GetEnv

Use the GetEnv command to read the value of an environment variable and save it in the specified <variable>.

For detailed information, see Section 5.2.29, GetEnv.

GetHandle

Use GetHandle to capture the unique handle of the window on which the Windows application definition script is activated.

For detailed information, see Section 5.2.30, GetHandle.

GetIni

Use the GetIni command to read data from the INI file.

For detailed information, see Section 5.2.31, GetIni.

GetMD5

Use the GetMD5 command to generate an MD5 hash value of the current process the script is running for. GetMD5 works only with the Win32 scripts.

For detailed information, see Section 5.2.32, GetMD5.

GetReg

Use the GetReg command to read data from the registry and save it in the specified <variable>.

For detailed information, see Section 5.2.33, GetReg.

GetSessionName

Use the GetSessionName command to find the current HLLAPI session name that is used to connect and return it to the specified variable.

For detailed information, see Section 5.2.34, GetSessionName.

GetText

Use the GetText command to get all of the text from the screen and save it to the specified variable. It is used in a large Web application definition that might contain several If -Text statements.

For detailed information, see Section 5.2.35, GetText.

GetURL

Use the GetURL command to capture the URL of the site that is loaded and save it to the specified variable.

For detailed information, see Section 5.2.36, GetURL.

GoToURL

Use the GoToURL command to make the browser navigate to the specified <URL>. By default the command opens the new Web page in the main window, rather than the frame that started the application definition.

For detailed information, see Section 5.2.36, GetURL.

If/Else/EndIf

Use the If command to establish a block to execute if the expression supplied is true. The Else command works inside an If block. The Else command is executed if the operator in the If block is false. Use the EndIf command to terminate the If block.

For detailed information, see Section 5.2.39, If/Else/EndIf.

Include

Use the Include command to share commonly used application definition commands by multiple applications. The application definition identified by <Platform-Name> is included at execution time into the calling application definition. The application definition included with the Include command must consists of commands supported by the calling application.

For detailed information, see Section 5.2.40, Include.

Increment

Use the Increment command to add to a specified variable. For example, you can use increment to count the number of passes a particular application definition has made.

For detailed information, see Section 5.2.41, Increment.

KillApp

Use to terminate an application.

For detailed information, see Section 5.2.42, KillApp.

Local

Use the Local command to declare that a runtime variable will only exist for the lifetime of the application definition. Local runtime variables are used in the same way as normal runtime variables and are still written as ?Variable.

For detailed information, see Section 5.2.43, Local.

MatchDomain

Use MatchDomain inside a site block to filter a site based on its domain. If the domain does not match, the site block fails to match.

For detailed information, see Section 5.2.44, MatchDomain.

MatchField

Use MatchField to filter a form based on the presence of a particular field. If the field fails to match and it is not specified as optional, then the parent form fails to match.

For detailed information, see Section 5.2.45, MatchField.

MatchForm

Use MatchForm to filter a site based on the presence of a particular field. If the field fails to match and it is not specified as optional, then the site fails to match.

For detailed information, see Section 5.2.46, MatchForm.

MatchOption

Use the MatchOption command to filter a field based on the presence of a particular option.

For detailed information, see Section 5.2.47, MatchOption.

MatchReferer

Use MatchReferer inside a Site/EndSite block to match or filter a site based on a referrer.

For detailed information, see Section 5.2.48, MatchReferer.

MatchTitle

Used inside a site block. MatchTitle is used to filter a site based on its title. If the site title does not match, the site block fails to match.

For detailed information, see Section 5.2.49, MatchTitle.

MatchURL

Use MatchURL inside a site block to match or filter an HTML page within a site based on its URL. The URL can be a complex Web address or a secure Web site.

For detailed information, see Section 5.2.50, MatchURL.

MessageBox

Use the MessageBox command to display a dialog box that contains the text specified in the <Data> variable. The application definition is suspended until the user reacts to this message. The MessageBox can take any number of text arguments, including variables, (for example MessageBox "The user " $Username " has just been logged onto the system").

For detailed information, see Section 5.2.51, MessageBox.

Multiply

Use to multiply one number by another. You can hard-code the numbers into the application definition, or you can use variables. The results can be output to another variable, or to one of the original numbers.

For detailed information, see Section 5.2.52, Multiply.

OnException/ClearException

Use the OnException command to detect when certain conditions are met. Currently, this is when Cancel is clicked on either of two dialog boxes. When the condition is met, a subroutine is run. Use the ClearException command to reset the exceptions value.

For detailed information, see Section 5.2.53, OnException/ClearException.

Parent/EndParent

Use the EndParent command to terminate a Parent block and set the subject of the application definition back to the original window. You can nest the Parent command, thereby allowing the Parent block to act on the parent of the parent.

For detailed information, see Section 5.2.54, Parent/EndParent.

PickListAdd

Use the PickList command to allow users with multiple accounts for a particular system to choose the account to which they will log in.

For detailed information, see Section 5.2.55, PickListAdd.

PickListDisplay

Use the PickListDisplay command to display the pick list entries built by previous calls to PickListAdd. The PickListDisplay command returns the result in a <?Variable> sent to the command.

For detailed information, see Section 5.2.56, PickListDisplay.

PositionCharacter

Use the PositionCharacter command in a password policy application definition to enforce that a certain character in the password is a numeral, uppercase, lowercase, or a punctuation character.

For detailed information, see Section 5.2.57, PositionCharacter.

PressInput

Used within a site block to simulate a keyboard enter event.

For detailed information, see Section 5.2.58, PressInput.

ReadText

Use the ReadText command to run in both Windows and Terminal Launcher application definitions. Although the usage and arguments for the use of ReadText with Windows and Terminal Launcher are different, the results of each command are the same.

For detailed information, see Section 5.2.59, ReadText.

RegSplit

Use the RegSplit command to split a string by using a regular expression. <Output-String1> and <Output-String2> contain the first and second subexpressions.

For detailed information, see Section 5.2.60, RegSplit.

ReLoadPlat

Use to set the current platform to the last one chosen by the application definition, or if a platform is not chosen, leaves the platform unset.

For detailed information, see Section 5.2.61, ReLoadPlat.

Repeat/EndRepeat

Use the Repeat command to establish an application definition block similar to the If command. The repeat block is terminated by an EndRepeat command. Alternatively, you can use the Break or EndScript commands to break out of the loop.

For detailed information, see Section 5.2.62, Repeat/EndRepeat.

RestrictVariable

Use the RestrictVariable command to monitor a <Variable> and enforce a specified <Password-Policy> on the <Variable>. Any variable specified must match the policy or it is not saved.

For detailed information, see Section 5.2.63, RestrictVariable.

Run

Use the Run command to launch the program specified in <Command> with the specified optional [<Arg1> [<Arg2>] …] arguments.

For detailed information, see Section 5.2.64, Run.

Select

Use the Select command to select entries from a combo box or list box control.

SelectListBoxItem

Use the SelectListBoxItem command to select entries from a list box.

For detailed information, see Section 5.2.66, SelectListBoxItem.

SelectOption

Use the SelectOption command to select or deselect options within a list box or combo dialog box.

For detailed information, see Section 5.2.67, SelectOption

SendKey

Use the SendKey command to work only with Generic and Advanced Generic emulators. You can use the SendKey command in the same manner as the Type command. Generally, the Type command is the preferred command to use. The Type command places the text into the clipboard, and then pastes it into the emulator screen. The SendKey command enters the text directly into the emulator screen.

For detailed information, see Section 5.2.68, SendKey.

Set

Use the Set command to copy the value of <Data> into <Variable>. The <Data> can be any text, or another variable, whereas the <Variable> must be either a ?Variable or $Variable.

For detailed information, see Section 5.2.69, Set.

SetCheckBox

Use the SetCheckBox command to select or clear a check box.

For detailed information, see Section 5.2.70, SetCheckBox.

SetCursor

Use the SetCursor command to set the cursor to a specified <ScreenPosition> or <X Co-ordinate> <Y Co-ordinate>.

For detailed information, see Section 5.2.71, SetCursor.

SetFocus

Use the SetFocus command to set the keyboard focus to a specified <#Ctrl-ID>.

For detailed information, see Section 5.2.72, SetFocus.

SetPlat

By default, variables are stored directly against the platform or application on which you have SecureLogin enabled. For example, if you enable Groupwise.exe, the Groupwise® credentials are stored against the Groupwise.exe platform. SetPlat sets the platform or application from which variables are read and saved.

For detailed information, see Section 5.2.73, SetPlat.

SetPrompt

Use the SetPrompt command to customize the text in the Enter SecureLogin Variables dialog boxes. These dialog boxes are used to prompt the user for new variables. You can also use the DisplayVariables command to customize the prompt text in the dialog box (for previously stored variables).

For detailed information, see Section 5.2.74, SetPrompt.

Site/Endsite

Begins and ends an application definition, in place of Dialog/EndDialog.

Site/Endsite are Web commands added to allow for finer control of site matching. More detailed information within a loaded Web site can now be matched upon an used to execute blocks of scripting commands.

For detailed information, see Section 5.2.76, Site/Endsite

StrCat

Use the StrCat command to append a second data string to the first data string. For example, StrCat ?Result "SecureRemote " "$Username".

For detailed information, see Section 5.2.77, StrCat.

StrLength

Use the StrLength command to count the number of characters in a variable and output that value to the destination variable.

For detailed information, see Section 5.2.78, StrLength.

StrLower

Use the StrLower command to modify a variable so that all the characters are lowercase.

For detailed information, see Section 5.2.79, StrLower.

StrUpper

Use the StrUpper command to modify a variable so that all the characters are uppercase.

For detailed information, see Section 5.2.80, StrUpper.

Sub/EndSub

Use the Sub/EndSub commands around a block of lines within an application definition to denote a subroutine.

For detailed information, see Section 5.2.81, Sub/EndSub.

Submit

Use the Submit command only in Web application definitions, and only with Internet Explorer, to allow for enhanced control of how and when a form is submitted. The Submit command performs a Submit on the form in which the first password field is found. The Submit command is ignored if used with Netscape.

For detailed information, see Section 5.2.82, Submit.

Subtract

Use the Subtract command to subtract one value from another. This is useful if you are implementing periodic password change functionality for an application. You can use the subtract command (in conjunction with the Divide function and the Slina DLL) to determine the number of days that have elapsed since the last password change. Other numeric commands include Add, Divide, and Multiply.

For detailed information, see Section 5.2.83, Subtract.

Tag/EndTag

Use the Tag/EndTag commands to find HTML tags.

For detailed information, see Section 5.2.84, Tag/EndTag.

TextInput

Use within a site block to input text into a special field.

For detailed information, see Section 5.2.85, TextInput

Title

Use the Title command to retrieve the title of a window and compare it against the string specified in the<Window-Title> argument. For this block of the application definition to run, the retrieved window title and the <Window-Title> argument must match the text supplied to the Title command in the dialog block.

For detailed information, see Section 5.2.86, Title.

Type

Use the Type command to enter data, such as usernames and passwords, into applications. There are reserved character sequences that are used to type special characters, for example TAB and ENTER. If it is not possible to determine Control IDs in a Windows application, and the Type command is not working, use the SendKey command instead.

For detailed information, see Section 5.2.87, Type.

WaitForFocus

Use the WaitForFocus command to suspend the running of the application definition until the <#Ctrl-ID> has received keyboard focus, or the <Repeat-Loops> expire. The<Repeat-Loops> is an optional value that defines the number of loop cycles to run. The<Repeat-Loops> value defaults to 3000 loops if nothing is set. After focus is received, the application definition continues.

For detailed information, see Section 5.2.89, WaitForFocus.

WaitForText

Use the WaitForText command so the Terminal Launcher waits for the specified <text> to display before continuing. For example, the user waits for a username field to display before attempting to type a username.

For detailed information, see Section 5.2.90, WaitForText.