Adding Output File Parameters

You can create output file parameters that Isight writes to during execution.

  1. From the Design Gateway, select a model.

  2. Select the component that will contain the new parameter.

  3. From the Design Gateway Files tab, click .

    Tip: You can also add a parameter from the Mappings subtab by right-clicking a component in either list on the Mappings subtab, and clicking Add Parameter.

    The File Parameter Wizard appears.

  4. Click Output, and click Next.

    The File Parameter Structure screen appears.

  5. Select whether the parameter is a Scalar, File Set, or an Array.

    For more information, see About File Parameters. All elements of the array will be initialized to point to the same location (as determined in the rest of the wizard). You must manually reconfigure each element of the array to point to a different location once the wizard finishes.

    If you selected File Set, see Configuring an Output File Set and an Output File Set Source.

  6. Click Next.

    The Output Source screen appears.

  7. Specify the source information.

    The data are stored in a regular file on the file system. The Name text box holds the base name of the file, excluding all directory path information. You can click Browse to navigate to the file that you want to use. The Path text box contains the expression that defines the directory path of the file. The meaning of the expression is determined by the Options list setting (Absolute path, Runtime directory, Model directory, or Shared file system).

    For more information, see Configuring a File as the Source or Destination.

  8. Click Next.

    The File Content Type screen appears.

  9. Select the content of the file.

    Option Description
    Text Text files are displayed faster than binary files in the Runtime Gateway and can be converted from a nonstandard character encoding.
    Binary Binary files are always copied unchanged and are displayed in an external Web browser. Whether a binary file can be viewed or not depends on what file formats are recognized by your Web browser.

  10. Click Next.

    Note: If the Show File type encoding on the Files tab preference option is selected, an additional screen is displayed for text files that allows you to set the file encoding. The file encoding is relevant only if you use text files containing non-Latin characters. For more information, see About Encoding.

    The Output Destination screen appears.

  11. Specify the location to which you want the file copied so that the file is available after the component’s runtime directory is removed:

    Option Description
    Isight File Manager Select this option to have the Isight file manager store the content of the file in the Isight runtime database. This option is recommended. The Isight file manager is part of the results database that stores the contents of output file parameters that are marked with a destination of Isight File Manager. Files are stored in the filemgr subdirectory of the Isight database directory using a path derived from the job and work item IDs. The files are deleted when the job that created them is deleted from the database.
    Specify Location Select this option to enter the location where you want the file to be placed following execution.

    An output file parameter that is saved in a fixed location is not safe for parallel execution because multiple instances of the component overwrite each other’s data.

    None Select this option to not copy the file.

    If you do not define a destination for an output file, the file parameters are not copied. Instead, the source file’s absolute path is stored. This can be more efficient for large output files. To use this configuration with parallel execution, the file names for the source of the output file parameter must be unique for every run by substituting a parameter value or the work item ID into the file name or directory path. For information about shared file systems, see Creating a SIMULIA Execution Engine Connection Profile.

  12. If you selected Specify Location, do the following:

    1. Click to configure the location.

      The Configure Data Handler dialog box appears.

      The location can be a file, an FTP server, or a Web server (if you have write access to the Web server). For more information, see Configuring a File as the Source or Destination, Configuring an FTP Site as the Input Source or Output Destination, or Configuring a URL as the Input Source or Output Destination.

      Isight copies the files from the source location to the designated location after the components executes. For FTP and URL locations, this process involves contacting a server and transferring files. The URL handler writes files with an HTTP PUT operation, which the web server needs to be configured to support.

    2. Click OK to close the Configure Data Handler dialog box.

  13. Click Next.

    The Parameter Name screen appears.

  14. In the Parameter Name, enter a name or accept the default name.

  15. Click Next.

    The Save to Database screen appears.

  16. Select Save File parameter values to the database at runtime to specify if you want Isight to save file parameters attached to components to the database.

    For more information, see About Saving File Parameters to the Database.

  17. Click Finish.

    Isight adds the new file parameter to the list on the Output Files subtab.