Structure Editor : Options : File Format

The File Format tab of the Options dialog presents options relating to the reading and writing of files. The first set of options relates to the character encoding used (note that internally characters are stored using the Unicode system), and can be useful when reading files from, or generating files for a legacy system, particularly when international characters are used:-

• Structure File Open - sets the encoding to use when opening structure files
• Structure File Save - sets the encoding to use when saving structure files
• Generated Code - sets the encoding to use when generating code

The remaining sets of options relate to specific file formats and control how the Structure Editor reads and writes files in those formats :-

• PDF:
  • Write childless quits as LEAF-QUIT when writing PDF - determines whether childless quits are written as LEAF-QUIT or SEQ-QUIT when writing PDF files.
  • Title lines written to files - determines whether the title lines written to PDF files mimic those generated by the UKAE PDF tool (e.g. 0 12-FEB-03 PDF V2.1C P0444 1, 7, 7, 1) or state that the file was generated by Keywood tools (e.g. 0 Sat Mar 29 12:41:47 GMT 2003 Keywood JSP/JSD Workbench P0444). Alternatively, the user may substitute a simple string to be used in each title line instead.
• JSP-COBOL:
  • Write JSP-COBOL operations in numeric order - Determines whether the operation identifiers should be interpreted as numbers and used to sort the order of the operations when writing JSP-COBOL files.
  • Retain trailing spaces when writing - Determines whether trailing spaces are trimmed off lines when writing JSP-COBOL files.
    
  • Convert to upper case - Determines whether all the output is converted to upper case when writing JSP-COBOL files.
    
  • Write conditions as macros - if true, conditions are written as JSP-MACRO references
  • Title lines written to files - similar to the option of the same name for PDF files described above, except that this option applies to the header lines written to JSP-COBOL files.
• JSP Tool:
  • Optimize sub-trees to single nodes - If selected then when writing JSP Tool files, the Structure Editor will collapse sub-trees comprising a single level of leaf or quit nodes into a single node.
  • Use original-style formatting - governs whether the Structure Editor assumes that JSP Tool files are formatted in COBOL style (i.e. with sequence and identification columns), which is typically only the case when the output language is COBOL. Important Note: This option effects how the first line of operations and conditions are stored. If incorrectly set file corruption is possible.
    
  • Allow use of sequence column - sets whether or not the sequence column (for original-style COBOL formatting) is read in and presented in the editor or discarded. In general editing of operations and conditions will be easier if the sequence column is not included; however any information in the sequence column will be lost. (Also some COBOL programmers may find this scheme confusing.)
    
  • Separate Operations from Quits - in JSP Tool files quit conditions can contain embedded operation text (separated by "==="). If this option is set then such text is treated as an explicit operation (however for maximum compatibility with JSP Tool this option should not be set).