Scripting Guide - SAS

232 Programming Methods Chapter 8
Functions that Communicate with Users
StatusMsg
Mail
The Spoken option causes captions to be read aloud by the operating system’s speech system (if available).
Spoken takes a Boolean argument, and the current setting (on or off) remains in effect until switched by
another Caption statement that includes a Spoken setting.
You can include pauses in the playback by including the named argument Delayed and a time in seconds.
Such a setting causes that caption and all subsequent caption windows to be delayed by that number of
seconds, until a different Delayed setting is issued in a Caption statement. Use Delayed(0) to stop
delaying altogether.
This script turns speaking on and leaves it on until the last caption.
caption({10,30},"A tour of the JMP Analyses", spoken(1), Delayed(5));
caption("Open a data Table");
bigClass=open("$SAMPLE_DATA/Big Class.JMP");
caption("A JMP Data Table consists of rows and columns of data");
caption("The rows are numbered and the columns are named");
caption({250,50},"The data itself is in the grid on the right");
caption({5,30},spoken(0),"A panel along the left side shows columns and other
attributes");
Each new Caption hides the previous one. In other words, there is only one caption window available at a
time. To close a caption without displaying a new one, use the named argument Remove.
caption(remove);
This command sends a message to the status bar.
StatusMsg("string")
(Windows only) Mail sends an e-mail message to alert a user about a condition in JMP. For example, a
process control manager might include a test alert script in a control chart to trigger an e-mail warning to
her pager:
mail("JaneDoe@company.com", "out of control", "Process 12A out of control at
"||Format(today(), "d/m/y h:m:s"));
Mail can also send an attachment with the e-mail. An optional fourth argument specifies the attachment.
The attachment is transferred in binary format after its existence on the disk is verified. For example, to
attach the Big Class.jmp data table, submit
mail("JohnDoe@company.com", "Interesting Data Set", "Have a look at this class
data.", "C:\myJMPData\Big Class.jmp");