1 TIME_$
 The function of this command is to perform time calculation services.

 Format:

         TIME [ time-spec [ (operator) time-spec] ... ]

 By default if no operands are specified the command will display the
 current system time and the user's connect time.

 If only one operand is supplied, then instead of calculating the user's
 connect time the operand (which must be in absolute time format) will be 
 subtracted from the current system time and that resulting delta time
 displayed along with the current system time.

 [] indicates optional.  () are required for the operator.
 '...' only valid for (+),(-),(*), & (/) operators

2 Time-spec
 The times values which may be specified are absolute time, 
 delta time, or a positive integer value.

3 Absolute_time
 Formats:

    dd-mmm-yyyy[:][hh:mm:ss.ss]

 1. If you specify both the date (dd-mmm-yyyy) and the time
    (hh:mm:ss.ss), you may type the colon between the date and
    the time or seperate them with a tab or a blank.  

    The lexical function 'F$TIME()' may be used to generate 
    the current time value (this returns the value with a blank
    between the date and time fields).  

    On output there will always be a colon between the date and 
    the time of day fields.

 2. If only the date is specified the system will supply the
    current time of day for the missing time field.

 3. If you specify a time of day you can truncate the time on 
    the right.  The truncated fields will be zero filled (See
    point 4 if you wish to supply punctuation).

 4. If you omit any of the fields but supply the punctuation marks
    the system will supply the current system time values as 
    defaults (do not confuse this with truncation where the
    punctuation marks are also omited; point 3).

3 Delta_time
 Format

    dd[-]hh[:mm:ss.ss]

 When you specify a delta time value, you can truncate the time field
 on the right; you may also omit any of the variable fields, as long
 as you supply the punctuation marks.

 When any field is omitted from a delta time value, the system
 supplies a value of 0 for the field.

3 Integer
 An positive integer value may also be specified.  The value must
 be within the range:
 
    0 - 2147483647

2 Operator
 The operators available are addition, subtraction, multiplication,
 division, and comparison.
 The syntax for the operators are:

     (+)    Addition
     (-)    Subtraction
     (*)    Multiplication
     (/)    Division
     (=)    Compare for equal to
     (<>)   Compare for not equal to
     (<)    Compare for less than
     (<=)   Compare for less than or equal to
     (>)    Compare for greater than
     (>=)   Compare for greater than or equal to
     (?)    General comparison

 The operator MUST be enclosed in parenthesis's.  This is to avoid 
 syntax confusion with the '-' used in the time specifications.

 Note:  If any of the results yealds a negative time value the
        absolute value of the calculation is displayed.

3 Addition (+)
 This operator will add the two operands and return the result.
 Valid combinations and the type of result returned are shown
 below:

     TIME   absolute_time (+) delta_time     -->  absolute_time
     TIME   delta_time (+) absolute_time     -->  absolute_time
     TIME   delta_time (+) delta_time        -->  delta_time
     TIME   integer (+) integer              -->  integer

3 Subtraction (-)
 This operator will subtract the two operands and return the
 result.  Valid combinations and the type of result returned
 are shown below:

     TIME   absolute_time (-) absolute_time  -->  delta_time
     TIME   absolute_time (-) delta_time     -->  absolute_time
     TIME   delta_time (-) delta_time        -->  delta_time
     TIME   integer (-) integer              -->  integer

 Note:  If any of the results yealds a negative value the
        absolute value of the calculation is returned.

3 Multiplication (*)
 This operator will multiply the two operands and return the
 result.  Valid combinations and the type of result returnd
 are shown below:

     TIME   delta_time (*) integer           -->  delta_time
     TIME   integer (*) delta_time           -->  delta_time
     TIME   integer (*) integer              -->  integer

3 Division (/)
 This operator will divide the two operands and return the
 result.  Valid combinations and the type of result returnd
 are shown below:

     TIME   delta_time (/) delta_time        -->  integer
     TIME   delta_time (/) integer           -->  delta_time
     TIME   integer (/) integer              -->  integer

3 Comparison (?)
 This operator will compare the two operands and return the
 results of the comparison.

     TIME   absolute_time       (?)      absolute_time

                            GREATER_THAN
                              EQUAL_TO
                              LESS_THAN

     TIME   delta_time       (?)      delta_time

                         GREATER_THAN
                           EQUAL_TO
                           LESS_THAN

3 EQ (=)
 This operator wil compare the two operands and return YES
 if they are equal and NO if they are not.

     TIME   absolute_time  (=)   absolute_time
     TIME   absolute_time  (EQ)   absolute_time

     TIME   delta_time     (=)   delta_time
     TIME   delta_time     (EQ)   delta_time

3 NE (<>)
 This operator will compare the two operands and return YES
 if they are not equal and NO if they are equal.

     TIME   absolute_time  (<>)   absolute_time
     TIME   absolute_time  (NE)   absolute_time

     TIME   delta_time     (<>)   delta_time
     TIME   delta_time     (NE)   delta_time

3 LT (<)
 This operator will compare the two operands and return YES
 if the first operand is less than the second operand,
 otherwise it will return NO.

     TIME   absolute_time  (<)   absolute_time
     TIME   absolute_time  (LT)   absolute_time

     TIME   delta_time     (<)   delta_time
     TIME   delta_time     (LT)   delta_time

3 LE (<=)
 This operator will compare the two operands and return YES
 if the first operand is less than or equal to the second 
 operand, otherwise it will return NO.

     TIME   absolute_time  (<=)   absolute_time
     TIME   absolute_time  (LE)   absolute_time

     TIME   delta_time     (<=)   delta_time
     TIME   delta_time     (LE)   delta_time

3 GT (>)
 This operator will compare the two operands and return YES
 if the first operand is greater than the second operand,
 otherwise it will return NO.

     TIME   absolute_time  (>)   absolute_time
     TIME   absolute_time  (GT)   absolute_time

     TIME   delta_time     (>)   delta_time
     TIME   delta_time     (GT)   delta_time

3 GE (>=)
 This operator will compare the two operands and return YES
 if the first operand is greater than or equal to the second
 operand, otherwise it will return NO.

     TIME   absolute_time  (>=)   absolute_time
     TIME   absolute_time  (GE)   absolute_time

     TIME   delta_time     (>=)   delta_time
     TIME   delta_time     (GE)   delta_time

2 Qualifiers

/DEBUG
 This option will show the intermediate results of a sequence of 
 operations.  It also disables some internal error checking so 
 the output may not be correct.

/SYMBOL=symbol_name
 This option will cause the results of the calculation to be stored in
 the specified symbol instead of being displayed to the output device.
