home *** CD-ROM | disk | FTP | other *** search
/ ftp.seagate.com / 2014.07.ftp.seagate.com.tar / ftp.seagate.com / pub / palindrome / technote / tn9105.asc < prev    next >
Text File  |  1995-03-21  |  5KB  |  106 lines
  1. Tech Note #:                    9105
  2. Date:                           March 22, 1991
  3. Subject:                        Taglist File Format
  4. Keywords:                       FILE FORMAT TAG TAGLIST TAGTYPE
  5.  
  6. A taglist file is created after files have been tagged, and the
  7. Select/Write Tags option is chosen in the Network Archivist
  8. Comprehensive Menu.  The Select/Read Tags option is used to read an
  9. existing taglist file.
  10.  
  11. The two most common uses of taglists are for managing the migration
  12. process and creating a batch file for selective tape operations such as
  13. Checkpointing database files every x-hours.
  14.  
  15.  
  16. Taglist File Format
  17.  
  18. The taglist is an ASCII, comma and quote delimited file with one tag
  19. record, containing nine fields, per line.
  20.  
  21.  
  22. Taglist Record Fields
  23.  
  24.           Directory    Name of the directory the file is in.  Used to
  25.                        locate the tagged file on disk.  This directory
  26.                        path is applied to the current volume.
  27.  
  28.           Filename     Name of the tagged file.  Used to locate the
  29.                        tagged file on disk.
  30.  
  31.           Owner        Name of the NetWare identified owner of the file.
  32.  
  33.           Size         Size of the file in bytes.  Used to match the
  34.                        tagged version of the file with the appropriate
  35.                        file in the Archive History.
  36.  
  37.           Tagtype      Used to identify which tagging method was used to
  38.                        select the file.
  39.  
  40.                        "="   An equal sign tagtype indicates a tag of a
  41.                              specific file by time stamp and file size.
  42.  
  43.                              This tagtype occurs when tagging a specific
  44.                              version of a file from the History window
  45.                              or when tagging a "not-the-most-recent"
  46.                              version of a file when a Date Filter is
  47.                              active.  During a restore, the Network
  48.                              Archivist will only restore the file if an
  49.                              exact match, by time stamp and file size,
  50.                              is found.
  51.  
  52.                        ">"   A greater than tagtype indicates that a
  53.                              non-specific version of the selected file
  54.                              was tagged.
  55.  
  56.                              During a restore using a taglist this
  57.                              "generic" tag indicates the most recent
  58.                              version of the file will be restored.
  59.  
  60.                        "~"   A tilde tagtype indicates that the tagged
  61.                              file is dormant.
  62.  
  63.                              This tagtype is created when a file is
  64.                              tagged using the Select Eligible command to
  65.                              scan for dormant files eligible for
  66.                              migration.
  67.  
  68.                              When reading a taglist, if the tagtype is a
  69.                              tilde, the Network Archivist will recheck
  70.                              the file's eligibility for migration.  If
  71.                              the Last Accessed Date still indicates that
  72.                              the file meets the criteria for migration
  73.                              the file will be retagged.  If the file has
  74.                              been 'touched' since the taglist was
  75.                              created, or if the file no longer exists on
  76.                              disk, it will not be retagged.
  77.  
  78.                              If you do not want the Network Archivist to
  79.                              recheck for migration eligibility, edit the
  80.                              taglist to replace the "~" with a ">"
  81.                              symbol.
  82.  
  83.           ModDate      Date and time the file was last modified.  Used
  84.                        to match the tagged version of the file with the
  85.                        appropriate file in the Archive History.
  86.  
  87.           AccDate      Date and time the file was last accessed.  Access
  88.                        includes anytime the file was read, written, or
  89.                        executed.
  90.  
  91.           ArcDate      Date the file was last archived.  The Network
  92.                        Archivist sets the archive date when it
  93.                        checkpoints or saves a file.
  94.  
  95.           Fullname     Full name of the NetWare identified file owner.
  96.  
  97.  
  98. Taglist File Example
  99.  
  100. "Directory","Filename","Owner","Size","Tagtype","ModDate","AccDate","ArcDate","Fullname"
  101.  
  102. "\TC\TRAIN","TEST.DOC","CFJ","18944",">"," 3-05-91  8:37a"," 3-14-91"," 3-12-91","Colby Jordan"
  103. "\TC\TRAIN","DEALER.TST","CFJ","43633",">"," 3-15-91 11:54a"," 3-15-91"," 3-16-91","Colby Jordan"
  104.  
  105.  
  106.