Name

---

      CREATED

Purpose

---

      Return file creation host, user, and time stamp or tag.

Category

---

Calling Sequence

---

      txt = created()

Inputs

---

Keyword Parameters

---

Keywords

---

        VERB=verb First word to use (def=Created).
        /BY return text describing the calling routine.
          Can say BY=n to look back n levels. Example text:
          IDL routine: test_res in /d1/lib on system_7.
        /TAG Return a numeric date_time tag instead of text.
            Example: 20090601_111425
            Can use to time tag files. Will sort in time order.
            /Y2 Use 2-digit year for /TAG, else 4 digit.
            /DATE Date only for /TAG, else date and time.
            /TIME Time only for /TAG, else date and time.

Outputs

---

      txt = returned text. out
      Ex: Created on tesla by Sterner on Tue Jul 1 14:22:15 1997

Common Blocks

---

Notes

---

Modification History

---

      R. Sterner, 1997 Jul 1
      R. Sterner, 2004 May 28 --- Added /BY.
      R. Sterner, 2004 Sep 28 --- Now handles interactive IDL case.
      R. Sterner, 2009 Jun 01 --- Added /TAG and related keywords.
  Copyright (C) 1997, Johns Hopkins University/Applied Physics Laboratory
  This software may be used, copied, or redistributed as long as it is not
  sold and this copyright notice is reproduced on each copy made. This
  routine is provided as is without any express or implied warranties
  whatsoever. Other limitations apply as described in the file disclaimer.txt.