Creating Record Layout (.str) files from the command line with DFSTRCL
The Record Layout Editor within the Classic Data File Tools enables the creation of structure files (.str) for use when viewing and editing records in a structured or formatted way within the Data File Editor.
Typically a Record Layout File is created within a Visual COBOL project by right-clicking on the source file name within the solution explorer that contains the Data Division information you require, and selecting Create Record Layout File.
|Note: DFSTRCL creates DEFAULT record layout (.str) files, if conditional record layout files are required use the New Record Layout Wizard from within the Data File Editor|
The Data File Structure Command Line (DFSTRCL) was added in Visual COBOL V2.3. The utility enables you to create DEFAULT record layout (.str) files from .idy files directly from the command line, and must be run from a Visual COBOL command prompt.
DFSTRCL can be used to process a single debug information (.idy) file. Alternatively, it can be configured to perform batch processing using a parameters file passed at the command line using the /r parameter. Please refer to the Visual COBOL documentation for further details.
In the example below a data file has two record layouts STUDENT-RECORD and COURSE-RECORD.
A default record layout based on the STUDENT-RECORD needs to be created, the .str will be saved in the same location as the .idy file.
- The COBOL program must be compiled for debug
- Run DFSCTRL passing the necessary parameters:
e.g. DFSTRCL STUDENTS.IDY /D STUDENT-RECORD
(where /D is record name)
- Load the data file into the Data File Editor to view/edit in formatted mode
e.g. MFDATATOOLS STUDENTS.DAT
Click on the video to follow the necessary steps:
(Note: If conditional record layout files are required use the New Record Layout wizard from within the Data File Editor)