This command closes the data entry session and loads the specified planned session. Role settings are ignored when using this command.
Syntax
CHAIN_P "planned_session_name", "ignore_save_changes"
If the specified planned_session_name does not exist, or if the user does not have access to this planned session, then the user will be prompted to select from the list of planned 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.
Examples
CHAIN_P "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 planned session named "Job 426a".
CHAIN_P "", "Y"
This formula closes the current data entry session and prompts the operator to select from the list of available planned sessions.