Novell Documentation: Novell SecureLogin 3.51.1

MessageBox

Item	Description
Use with:	Startup scripts, Terminal Launcher, Web, Windows
SecureLogin Version:	All
Type:	Action
Usage:	MessageBox Data [-Background] [-DefaultNo] [-YesNo Variable] [-YesNoCancel ?Variable]
Arguments: Data [-Background] [-DefaultNo] [-YesNo] ?Variable [-YesNoCancel]	The text to be displayed to the user. can be several strings, variables or a combination of the two. When specified, allows the user to open an application and work in that application, without having to respond to the MessageBox. If this parameter isn't used, the MessageBox remains the topmost window and the user must respond to the MessageBox before continuing with any other work. An optional parameter, used only with the -YesNo and -YesNoCancel flags. When the -DefaultNo parameter is set, default focus goes to the No button instead of to the Yes button. Allows the user to select either Yes or No within the message box rather than being limited to an OK button only. Required with the -YesNo or -YesNoCancel flag to store the result of the user action. Allows the user to select either Yes, No, or Cancel when a message box is presented.
Description:	Displays a dialog box that contains the text specified in the Data variable. The script is suspended until the user reacts to this message. As the following line illustrates, MessageBox can take any number of text arguments, including variables: MessageBox "The User "$Username" has just been logged into the system" You can set the -YesNo flag when calling a MessageBox. If the -YesNo flag is set, the MessageBox prompts the user with a box that has a Yes and a No button rather then an OK button. You can capture the result of the MessageBox immediately after the flag by using a runtime ?Variable. The variable value is set to Yes, No, or Cancel.
Syntax Examples:	MessageBox "Script completed successfully" MessageBox "Do you want to continue?" -YesNo ?Result MessageBox "Do you want to continue?" -YesNoCancel ?Result -Background -DefaultNo
Example 1: Windows Script SecureLogin detects the change password dialog box, asks the user whether the user wants to change the password, and informs the user that the change was successful.	# Change Password Dialog Box Dialog Class #32770 Title "Change Password" EndDialog MessageBox "Your password has expired. Would you like to change it now?" -YesNo ?Result If ?Result Eq "Yes" Type $Username #1015 Type $Password #1004 ChangePassword $Password Random Type $Password #1005 Type $Password #1006 Click #1 MessageBox "Password changed successfully" Else Click #2 MessageBox "You elected not to change your password." EndIf
Example 2: Terminal Launcher Script Message boxes can be useful when troubleshooting scripts. You can display a box before each step in the script, to enable you to see where the script fails to execute. NOTE: The WaitForText command cuts off the first character because it will find both Password and password and respond to all password entry points.	MessageBox "Beginning wait for Login prompt" WaitForText "ogin:" MessageBox "Login detected. Now entering Username." Type $Username MessageBox "Username entered. Now simulating Enter." Type @E MessageBox "Enter has been simulated. Now waiting for Password" WaitForText "assword:" MessageBox "Password detected. Now entering Password." Type $Password MessageBox "Password entered. Now simulating Enter." Type @E MessageBox "Sequence completed. The user should now be logged in"