PROMPT        Display a text message in a pop-up dialog box

Top  Previous  Next

Syntax:

PROMPT

[ variable ]  [ message ]  [ title ]

Arguments:

[ variable ]

A variable to store characters typed in the prompt dialog; if the variable does not previously exist, it is created.

 

[ message ]

Variable or string defining a text message to display within a pop-up dialog box; this message is limited to up to three lines of text approximately 50 characters each.

 

[ title ]

Variable or string defining the window title displayed in the dialog box.

Options:

/history=on

When this option is used the last ten responses you type are saved for instant recall. (This history is shared with console command mode.) This option is not permitted with the /password option.

 

/history=off

When this option is used no history will be saved.

 

/large

Select this option to display the dialog box in a larger 12 point font rather than the default 8 point.

 

/local

By default, FileLink displays a message box in the center of the screen. Use this option if you wish the box to be centered relative to the FileLink window instead.

 

/nocrlf

Ignore embedded \n and/or \r carriage control.

 

/password

Select this option if you are prompting for a password and you do not want what is typed to be readable. This option is not permitted along with the /history option.

 

 

This command not allowed when running as an NT Service or in a locked minimized window.

 

This script command displays a dialog box on your display. The window title and text within the dialog are specified in the command. Control returns to next script command when you close the dialog by clicking on the OK or Cancel buttons. This command is useful to prompt for file names or other information that is not static during the course of a file transfer session.

 

If FileLink is running a script in a unlocked minimized window then FileLink’s window will be restored when this command is performed.

 

The script file can detect if the Cancel button has been clicked by testing for result code 1013 or the $ERROR variable $ERROR_PROMPT_CANCELLED.

 

Related Commands: MESSAGEBOX, ASK

See also: Running FileLink With Prompting