Syntax

   @File([REJECTABLE,][ENCODED_ATTR],<operation>,<attributeName>,<fileName>[,<characterEncoding>])
   @File([REJECTABLE,][ENCODED_PARAMS],<operation>,<attributeName>,<fileName>[,<characterEncoding>])
   
Arguments

   REJECTABLE

      Rejects features if this keyword is specified.

      Range: N/A

   ENCODED_ATTR

      If this optional argument is specified, then <attributeName> argument is
      expected to be FMEParsableText encoded

   ENCODED_PARAMS
  
      If this optional argument is specified, then all parameter values are
      expected to be FMEParsableText encoded except <operation> and <characterEncoding>

   <operation>   
   
      DestWriteSrcRead - On the destination side of a correlation line pair or 
      on factory lines, the contents of the attribute are written to the file. 
      If the file exists, then any existing value is overridden. On the source 
      line of a correlation line pair, the data is read from the file and stored 
      in the attribute.
      
      DestAppendSrcRead - On the destination side of a correlation line pair or 
      on factory lines, the contents of the attribute are appended to the file. 
      If the file exists then the information is simply written to the end of 
      the file. On the source line of a correlation line pair, the data is read 
      from the file and stored in the attribute.
      
      DestReadSrcWrite - On the source side of a correlation line pair, the 
      contents of the attribute are written to the file. If the file exists, 
      then any existing value is overridden. On the destination side of a 
      correlation line pair or on a factory line, the data is read from the file 
      and stored in the attribute.
      
      DestReadSrcAppend - On the source side of a correlation line pair the 
      contents of the attribute are appended to the file. If the file exists, 
      then any existing value is overridden. On the destination side of a 
      correlation line pair or on a factory line, the data is read from the file 
      and stored in the attribute.

      Range: (DestWriteSrcRead | DestAppendSrcRead | DestReadSrcWrite | DestReadSrcAppend)   
      
   <attributeName>   
   
      The name of the attribute whose value is to be written to the file or read 
      from the file. The entire contents of the file are stored in this 
      attribute of the feature.

      Range: String  
      
   <fileName>  
   
      The name of the target file from which data is read or to which data is 
      written.

      Range: String  

   <characterEncoding>  

      Specifies the source or destination file's character encoding.

      Range: String

      
Configuration

   File <fileName> <directive> 
   
   <fileName>  
   
      The name of the target file.
   
      Range: String  
      
   <directive> 
   
      STARTUP_DELETE - The specified file <fileName> is deleted from the system 
      during FME start-up to ensure that the file is empty when the first @File 
      function is executed.
      
      SHUTDOWN_DELETE - The specified file <fileName> is deleted from the system 
      during the FME shutdown process to ensure that the file is not left laying 
      around after the translation is complete.
   
      Range: (STARTUP_DELETE | SHUTDOWN_DELETE)
      
Description

   This function enables FME to read the contents of a file into a feature 
   attribute or write the contents of a feature attribute out to a file. The 
   configuration lines are optional, in which case the files are deleted during 
   FME start-up or shutdown as directed by the configuration line.