******************************************************************
narchive_SEQUENCE3 - a macro to back up a Solids sequence and protocol 
                     into a compressed file for "extract".
******************************************************************
  narchive_SEQUENCE(3) is similar to archive_SEQUENCE, except that it allows 
  uppercase characters in sequencenames and adds the PKP and PKSTDY arguments. 

  Note - narchive_SEQUENCE3 zips with tar cfz. An alias archive_SUNSEQUENCE 
  zips with tar cf and compress.  Files zipped with archive_SUNSEQUENCE 
  are saved with the prefix "SUN_".  Note that older files zipped on a SUN
  may not have the prefix. 

  narchive_SEQUENCE3 - a macro to back up a Solids sequence and protocol 
     from a user directory into a compressed file for "extract". The output
     is a "tar.Z" file and a ".README" file in the directory 
     ~/vnmrsys/ARCHIVE/EXP_OUTPUT. The two files are suitable for submission
     to the userlib if the .README file uses the correct format. Also the 
     uncompressed directory is found in ~/vnmrsys/ARCHIVE named with the 
     sequence name in uppercase characters. 

  narchive_SEQUENCE3 requires the simple sequence name or protocol name as the 
  first argument without extension. Characters can be upper or lower case. 

  Examples: 

     narchive_SEQUENCE3('tancpx')
     narchive_SEQUENCE3('Tancpx')

  The following files are compressed automatically for "seqname.c" with 
  protocol Seqname: 

      ~/vnmrsys/maclib/seqname - the setup macro for the sequence. 
      ~/vnmrsys/maclib/seqname.README - the userlib submission form. 
      ~/vnmrsys/psglib/seqname.c - the C-code pulse sequence file. 
      ~/vnmrsys/parlib/Seqname.par - the parameter file for use with the 
         protocol. 
      ~/vnmrsys/manual/seqname - the manual file for the sequence.
      ~/vnmrsys/templates/vnmrj/layout/seqname - the template file for
         the acquisition tab. 
      ~/vnmrsys/templates/vnmj/protocols/Seqname.xml - the protocol for 
         the experiment selector. 

   If a file is not found, output will be generated on "line3" and in the
   text area. "Archive Complete" indicates that the macro is finished. 

   Sequences with the above files will run on standard vnmrJ2.2 or 
   vnmrj2.1b and the solidslib21b. 

   Additional files to compress can be entered as additional arguments to 
   narchive_SEQUENCE3. Include the simple file with extension in quotes.  
   Names are assumed to be macros in ~/vnmrsys/maclib if no other information
   is provided. 

   Example: 

      narchive_SEQUENCE3('hetcorlgcp2d','reset_hetcor')

   The path names for macros and other types of files can be specified with
   keywords.  All files following the keyword are assumed to have the path 
   designated by that word until another keyword is read.  

   Allowed keywords are: 

      'PKM' - designates a macro in ~/vnmrsys/maclib. 
      'PKPI' - designates a panelitem in ~/vnmrsys/templates/vnmrj/panelitems
      'PKPSG - designates a C source file in ~/vnmrsys/psg
      'PKP' - designates a .xml protocol file in ~/vnmrsys/templates/vnmrj/protocols
      'PKSTDY' - designates a study in ~/vnmrsys/studylib

   If a keyword is not found or if the file is not found in the directory given
   by the keword,  output will be generated on "line3" and in the text area.  

   Additional files from the above directories may need to be supplied if 
   versions are not present in /vnmr of VNMRJ2.2A or are not in solidslib2.1b
   for VNMRJ2.1B. 

   Example: 

      narchive_SEQUENCE3('hetcorlgcp2d','PKM','reset_hetcor','PKPI,'fslgH.xml) 

   In the example 'reset_hetcor' overides the standard "wrtp" macro called by 
   the protocol and overides the standard template group 'fslgH' called by 
   the template. Clearly extra files should be archived if they are needed and 
   not present in standard software, but be cautions about overiding standard 
   files. 
   





                                       
         
