For the users of the BARR/RJE DOS program, a utility is available to extract DOS RJE form definitions to enter into the BARR/SPOOL Make FCB program. The utility provides a display of the extracted form definitions for viewing and printing, so you can create BARR/SPOOL FCB definitions to match your DOS RJE form definitions.
To extract DOS RJE form definitions for use with BARR/SPOOL’s Make FCB utility, enter the following command at the MS-DOS prompt.
FORMS [-h] [-v] [-u] infile outfile
|
Option |
Description |
|
infile |
The name of the file containing the form definitions to extract. |
|
outfile |
The name of the file to which the extracted form definitions are written. |
|
Option |
Description |
|
-u |
Processes the entire input file, even if invalid form definitions were found. By default, the utility will stop after receiving the first invalid record. When this option is used, the utility will continue through the end of the input file and display an error message for all invalid records. |
|
-v |
Displays the copyright notice and the utility version number. |
|
-h |
Displays help and usage information. |
The following example shows the proper syntax for the utility that extracts DOS RJE form definitions to BARR/SPOOL’s FCBs.
FORMS barr.cfg barr.txt
Extracts form definitions in the Barr configuration file, barr.cfg, and writes the information to a file named barr.txt.
When using the –u parameter, the DOS RJE Forms Extraction Utility returns error codes that identify problems in extracting data.
|
Error Code |
Error Message |
|
0 |
SUCCESS: Forms extraction completed. |
|
1 |
ERROR: Bad parameter on the command line. |
|
2 |
ERROR: Too many file names on the command line. |
|
3 |
ERROR: Missing file name(s) on the command line. |
|
4 |
ERROR: Could not open input file. |
|
5 |
ERROR: Could not read from input file. |
|
6 |
ERROR: Unrecognizable input file format. |
|
7 |
ERROR: Could not open output file. |
|
8 |
ERROR: Could not write to output file. |
|
9 |
ERROR: Invalid form definition found. |