1 DATE

  DATE is a utility which displays some information about the
  current or specified date. The information consists of;

  - The name of the day (Monday....Sunday)
  - The date in absolute format
  - The julianday
  - The weeknumber

  The date can be either specified in absolute or deltatime format.

  Not only is it possible to display the information, but the 'value'
  of every item mentioned above can also be assigned to a symbol using
  /SYMBOLS on the commandline. /SYMBOLS though will suppress the
  displaying of the information, unless /OUTPUT is specified on the
  commandline.

2 Parameter

  DATE accepts either an absolute or deltaformat specified date.
  If not specified the current date will be used.

2 /SYMBOLS

  Format:

    DATE [Date_Spec] /SYMBOLS[=LOCAL/GLOBAL]

  When /SYMBOLS is specified, all items will be made available as
  either LOCAL or GLOBAL symbols (default is LOCAL). The symbols
  generated are;

  - 'Prefix'_DAY            Name of the day
  - 'Prefix'_DATE           Absolute dateformat (DD-MMM-YYYY)
  - 'Prefix'_JULIAN         Julian daynumber
  - 'Prefix'_WEEK           Weeknumber

  The symbol prefix defaults to 'DATE' (Ie. DATE_DAY etc.). You can
  specify your own prefix by specifying /PREFIX='Requested_Prefix'.
  The prefix you specify can be maximal 8 characters in length.

  Using /SYMBOLS will suppress the displaying of the information,
  unless /OUTPUT is explicitly specified on the commandline.

2 /PREFIX

  Format:

    DATE [Date_Spec] /PREFIX[=Symbol_Prefix]

  The symbol prefix defaults to 'DATE' (Ie. DATE_DAY etc.). You can
  specify your own prefix by specifying /PREFIX='Requested_Prefix'.
  The prefix you specify can be maximal 8 characters in length.

2 /CLEANUP
  /[NO]CLEANUP

  Format:

    DATE [Date_Spec] /CLEANUP

  By default 'old' DATE symbols are removed (both from the LOCAL
  and GLOBAL symbol table). This is done to prevent the possibility
  to have symbols defined in both the LOCAL and GLOBAL symbol table.
  If this is not required, specify /NOCLEANUP on the commandline.

  The DATE /NOOUTPUT /CLEANUP command will remove any 'old' DATE
  symbols, without creating new symbols.

  Use /PREFIX to define which symbols to remove.

2 /OUTPUT
  /[NO]OUTPUT

  By default DATE displays the information as mentioned before.

  Example:

    $ DATE
    Wednesday  1-JUN-1994 - Julian day 152 - Week no. 22

  But, if /SYMBOLS is used, this information display will be suppressed.
  You can explicitly force the displaying of information by specifying
  /OUTPUT on the commandline (Ie. DATE /SYMBOLS /OUTPUT).

2 Examples

  Example 1:
  ----------
    $ DATE
    Wednesday  1-JUN-1994 - Julian day 152 - Week no. 22

  Example 2:
  ----------
    $ DATE -12-0
    Friday 20-MAY-1994 - Julian day 140 - Week no. 20

  Example 3:
  ----------
    $ DATE -12-0 /SYMBOLS=GLOBAL /PREFIX=DTMP
    $ SHOW SYMBOL DTMP*
      DTMP_DATE == "20-MAY-1994"
      DTMP_DAY == "Friday"
      DTMP_JULIAN == "140"
      DTMP_WEEK == "20"
    $ DATE -22-0 /SYMBOLS /PREFIX=DTMP /NOCLEANUP /OUTPUT
    Tuesday 10-MAY-1994 - Julian day 130 - Week no. 19
    $ SHOW SYMBOL DTMP*
      DTMP_DATE = "10-MAY-1994"
      DTMP_DATE == "20-MAY-1994"
      DTMP_DAY = "Tuesday"
      DTMP_DAY == "Friday"
      DTMP_JULIAN = "130"
      DTMP_JULIAN == "140"
      DTMP_WEEK = "19"
      DTMP_WEEK == "20"
    $ DATE /NOOUTPUT /CLEANUP /PREFIX=DTMP
    $ SHOW SYMBOL DTMP*
    %DCL-W-UNDSYM, undefined symbol - check validity and spelling
    $
