APPDATE command: Difference between revisions

From m204wiki
Jump to navigation Jump to search
mNo edit summary
m (misc cleanup)
Line 1: Line 1:
<p class="note"><b>Note:</b> This is a <var class="product">[[Sirius Mods]]</var>-only command prior to Version 7.5 of <var class="product">[[Model 204]]</var>.</p>
<p class="note"><b>Note:</b> This is a <var class="product">[[Sirius Mods]]</var>-only command prior to Version 7.5 of <var class="product">[[Model 204]]</var>.</p>


The APPDATE command allows you to control the operation of date and time
The <var>APPDATE</var> command allows you to control the operation of date and time
oriented <var class="product">User Language</var> $functions, in the following two ways:
oriented <var class="product">User Language</var> $functions, in the following two ways:
<ol>
<ol>
Line 7: Line 7:
clock that is used to obtain date and time values for User Language
clock that is used to obtain date and time values for User Language
$functions.
$functions.
For application testing, this is preferred to the [[Model 204]] SYSDATE
For application testing, this is preferred to the Model&nbsp;204 <var>[[SYSDATE parameter|SYSDATE]]</var> parameter, which is much less flexible and which
parameter, which is much less flexible and which
greatly complicates the ability to do things such as share procedure
greatly complicates the ability to do things such as share procedure
files or read-only data files in the testing environment.
files or read-only data files in the testing environment.
<p>
The <var>APPDATE</var> command affects only date and time oriented User Language $functions; it does not affect any other date or time in the <var class="product">Model 204</var> environment. </p></li>


The APPDATE command affects only date and time oriented User Language
<li>You can use the <var>DATE_ERR</var> clause to
$functions; it does not affect any other date or time in the <var class="product">Model 204</var>
set switches that control the default system behavior when errors are
environment.
<li>You can use the DATE_ERR clause to
set switches that control the default system behaviour when errors are
encountered in date and time oriented <var class="product">User Language</var> $functions.
encountered in date and time oriented <var class="product">User Language</var> $functions.
The choices are to produce an error message along with request
The choices are to produce an error message along with request
cancellation, produce a warning message, or silently continue with
cancellation, produce a warning message, or silently continue with
the request.
the request.
<p>
This control is available at the system and user level, and can also
This control is available at the system and user level, and can also
be set for the duration of a User Language request, via the $SIR_DATE_ERR
be set for the duration of a User Language request, via the <var>$Sir_Date_Err</var> function. At the system and user level, you can also control whether procedure
function.
names and line numbers are available for error messages. </p></li>
At the system and user level, you can also control whether procedure
names and line numbers are available for error messages.
</ol>
</ol>


This command will perform no useful processing unless a site is authorized
This command will perform no useful processing unless a site is authorized
for the <var class="product">Sir2000 User Language Tools</var>.
for the <var class="product">Sir2000 User Language Tools</var>.
The APPDATE command has an extensive set of parameters and is more
The <var>APPDATE</var> command has an extensive set of parameters and is more completely documented in the <var class="book">[[Media:Ul2krNew.pdf|Sir2000 User Language Tools Reference Manual]]</var>.
completely documented in the <var class="book">[http://m204wiki.rocketsoftware.com/images/d/d6/Ul2krNew.pdf Sir2000 User Language Tools Reference Manual]</var>.


[[Category: User commands]]
[[Category: User commands]]
[[Category: Commands]]
[[Category: Commands]]

Revision as of 20:01, 22 September 2015

Note: This is a Sirius Mods-only command prior to Version 7.5 of Model 204.

The APPDATE command allows you to control the operation of date and time oriented User Language $functions, in the following two ways:

  1. You can specify a system-wide or user-level clock that is used to obtain date and time values for User Language $functions. For application testing, this is preferred to the Model 204 SYSDATE parameter, which is much less flexible and which greatly complicates the ability to do things such as share procedure files or read-only data files in the testing environment.

    The APPDATE command affects only date and time oriented User Language $functions; it does not affect any other date or time in the Model 204 environment.

  2. You can use the DATE_ERR clause to set switches that control the default system behavior when errors are encountered in date and time oriented User Language $functions. The choices are to produce an error message along with request cancellation, produce a warning message, or silently continue with the request.

    This control is available at the system and user level, and can also be set for the duration of a User Language request, via the $Sir_Date_Err function. At the system and user level, you can also control whether procedure names and line numbers are available for error messages.

This command will perform no useful processing unless a site is authorized for the Sir2000 User Language Tools. The APPDATE command has an extensive set of parameters and is more completely documented in the Sir2000 User Language Tools Reference Manual.