CHAIN_S

This command closes the data entry session and loads the specified stored session. Role settings are ignored when using this command.

Syntax

CHAIN_S "stored_session_name", "ignore_save_changes"

If the specified stored_session_name does not exist, or if the user does not have access to this stored session, then the user will be prompted to select from the list of stored sessions to which they have access.

If any numeric data values have been entered but not yet saved, the "ignore_save_changes" parameter determines whether or not the user will be prompted to save this data. Valid options for this parameter are:

"ignore_save_changes"

explanation

"Y"

Do not prompt the user to store data that has not been saved.

any other value (e.g., "N" or "")

Prompt the user to store data that has not been saved.

Return value

This command returns the number 0.

Notes

When using a template to access external data from the SPC Charts and Reports module, this command will be ignored.

Examples

CHAIN_S "Job 426a", " N"

This formula prompts the user if data has been entered but not saved, closes the current data entry session, and opens the stored session named "Job 426a".

CHAIN_S "", "Y"

This formula closes the current data entry session and prompts the operator to select from the list of available stored sessions.