$Sir Date Err: Difference between revisions

From m204wiki
Jump to navigation Jump to search
m (remove category)
m (add links)
Line 43: Line 43:


<p class="note"><b>Note:</b> <var>$Sir_Date_Err</var> only sets the <b><i>default</i></b> datetime argument error handling.
<p class="note"><b>Note:</b> <var>$Sir_Date_Err</var> only sets the <b><i>default</i></b> datetime argument error handling.
It will affect the standard SOUL date $functions, but it will only affect the Sirius date $functions if they are coded without an error control argument.</p>
It affects the [[SOUL $functions#datex|standard SOUL date $functions]], but it will only affect the [[SOUL $functions#datetime|$Sir_Datexxx $functions]] if they are coded without an error control argument.</p>


[[Category:Sir2000 User Language Tools $functions]]
[[Category:Sir2000 User Language Tools $functions]]

Revision as of 18:09, 26 January 2018

Set and query default error handling at request level

Note: This $function require the Sir2000 User Language Tools product.

The $Sir_Date_Err function may be used to set or query the default request-level datetime error handling.

For more information on datetime error control, refer to Error handling control with DATE_ERR, and see the APPDATE command.

Syntax

%oldvalue = $Sir_Date_Err(newvalue)

Where:

%oldvalue Set to the most recent valid non-null setting of $Sir_Date_Err.
newvalue An optional error control string, which must contain one of the following values:
OFF Indicates that default datetime $function error handling is determined by the USER level setting or, if that is off, by the SYSTEM level setting.
CANCEL Indicates that if a datetime $function detects an error, the default behavior is to issue an error message and cancel the SOUL request.
REPORT Indicates that if a datetime $function detects an error, the default behavior is to issue a warning message and return the appropriate error value to the function caller.
IGNORE Indicates that if a datetime $function detects an error, the default behavior is to silently return the appropriate error value to the function caller.
'' (or empty argument) Does not affect the current request-level error processing defaults. Provided as a method to obtain the current $Sir_Date_Err setting.

The request-level datetime error handling defaults set by a $Sir_Date_Err invocation persist until the end of the SOUL request, at which time its setting is reset to OFF.

Note: $Sir_Date_Err only sets the default datetime argument error handling. It affects the standard SOUL date $functions, but it will only affect the $Sir_Datexxx $functions if they are coded without an error control argument.