Description
Starts this stored process executing in the background. This message is paired with End Run, which should also be called at some point after Begin Run to wait for the stored process to complete.
Returns
-1 = execution failed.
1 = not started.
2 = running.
3 = canceled.
10 = completed successfully.
11 = completed with errors.
Optional Named Arguments
Same as Run, except AutoOpenResults and NoAlerts are not supported. They are available on EndRun.
AutoResume(<filename>)
If specified with no argument, it specifies that the stored process results should be auto-opened when the stored process completes. If a quoted filename is specified, filename is opened rather than all results of the stored process being auto-opened.
AutoResumeScript(script)
Specifies that after stored process execution completes, the quoted script should be evaluated. If the script is a function taking at least one argument, the function is evaluated with the scriptable stored process object passed as the first (and only) argument. AutoResume and AutoResumeScript are mutually exclusive.
Description
Deletes all results from the execution of this stored process.
Returns
1 if deletion is successful, 0 otherwise (error message to JMP log).
Optional Named Arguments
NoAlerts(Boolean)
If True, the user is not prompted for confirmation before the attempt is made to delete results.
DeleteDirectory(Boolean)
If true, deletes the directory containing the stored process results along with the result files themselves. The default value is true.
Description
Opens the stored process window for interactively setting parameter values.
Returns
1 if the user clicks OK to dismiss the window, 0 if the user clicks Cancel.
Description
Waits a specified amount of time (or forever) for a stored process started with Begin Run to complete. If the stored process is complete, retrieves the results, and opens them.
Returns
-1 = execution failed.
1 = not started.
2 = running.
3 = canceled.
10 = completed successfully.
11 = completed with errors.
Optional Named Arguments
AutoOpenResults(Boolean)
Optional, Boolean. If True, results are automatically opened if the stored process completes in the time specified by MaxWait. If False, results are not automatically opened, and can be manually opened via the object returned by the Get Results message. Default is True.
MaxWait(milliseconds)
An integer that specifies the maximum amount of time in milliseconds to wait for the stored process to complete. If MaxWait is not specified, End Run waits forever for the stored process to complete.
NoAlerts(Boolean)
If True, error messages are sent to the JMP log rather than message boxes. The default value is False.
Description
Returns the metadata ID of the stored process.
Returns
A quoted string.
Description
Returns the full metadata path of the stored process.
Returns
A quoted string.
Description
Returns the name of the stored process.
Returns
A quoted string.
Description
Gets the enumeration labels specified by the quoted name for a parameter.
Returns
A list of quoted strings.
Arguments
name
Specifies the quoted name of the parameter whose enumeration labels to retrieve.
Description
Gets the possible enumerated values for a parameter.
Returns
A list of quoted strings.
Arguments
name
Specifies the quoted name of the parameter whose possible enumerated values to retrieve.
Description
Gets a list of parameter names for this stored process of specific types.
Returns
A list of quoted strings.
Optional Named Arguments
Visible(Boolean)
If true, gets only visible parameters. If False, gets only non-visible parameters. If not specified, gets both visible and non-visible parameters.
Modifiable(Boolean)
If true, gets only modifiable parameters. If False, gets only non-modifiable parameters. If not specified, gets both modifiable and non-modifiable parameters.
Required(Boolean)
If true, gets only required parameters. If False, gets only non-required parameters. If not specified, gets both required and non-required parameters.
Expert(Boolean)
If true, gets only expert parameters. If False, gets only non-expert parameters. If not specified, gets both expert and non-expert parameters.
Description
Gets the current value of the specified parameter.
Returns
A quoted string.
Required Argument
name
Specifies the name of the parameter whose value to retrieve.
Description
Gets the results generated by the execution of this stored process as a scriptable object.
Returns
A SAS Results scriptable object.
Description
Gets the execution status of the stored process.
Returns
-1 = execution failed.
1 = not started.
2 = running.
3 = canceled.
10 = completed successfully.
11 = completed with errors.
Description
Gets the message associated with the failure of the stored process, if any.
Returns
A quoted string.
Description
Resets all parameter values to their metadata-defined default values.
Returns
Void.
Description
Executes this stored process object in the foreground.
Returns
-1 = execution failed.
1 = not started.
2 = running.
3 = canceled.
10 = completed successfully.
11 = completed with errors.
Optional Named Arguments
AutoOpenResults(Boolean)
If True, results are automatically opened when the stored process completes. If False, results are not auto-opened, and can be manually opened via the object returned by the GetResults message. The default value is True.
UserName(username)
Specifies the quoted user name under which to run the stored process.
Password(password)
Specifies the quoted password for UserName.
AuthDomain(authDomain)
Specifies the quoted authentication domain of the credentials (username, password) given.
ODSDest(dest)
Specifies the quoted ODS destination ("HTML", "PDF", "tagsets.SASReport12") for any ODS-generated results from the stored process. This requires the stored process SAS code to call %STPBEGIN. The default value is "HTML".
GraphicsDevice(device)
Specifies the quoted SAS graphics device to use when generating graphics in ODS results. This requires the stored process SAS code to call %STPBEGIN. The default value is "GIF".
ODSStyle(style name)
Specifies the quoted ODS style to apply to the results. This requires the stored process SAS code to call %STPBEGIN. There is no default value.
ODSStyleSheet(path)
Specifies the quoted path to a CSS file on the client machine that is to be applied to generated ODS results. This requires the stored process SAS code to call %STPBEGIN. There is no default value.
NoAlerts(Boolean)
If True, error messages are sent to the JMP log rather than message boxes. The default value is False.
Description
Sets the value of the specified stored process parameter to the specified value.
Returns
1 if successful, 0 otherwise (value can violate the parameter’s constraints).
Arguments
name
Specifies the quoted name of the parameter whose value to set.
value
Specifies the quoted string that you want to set the parameter to.
Description
Sets the quoted path on the client machine where stored process results are placed.
Returns
A quoted string.
Arguments
path
Specifies the full quoted path of the directory where results of the stored process execution should be placed. The directory must exist or be creatable. If the results directory is not set, a temporary location appropriate for the operating system will be used, and that directory can be retrieved from the stored process Results scriptable object after the stored process executes.