HP System Dictionary/XL SDMAIN Reference Manual (32256-90001)

2- 16
filename.groupname.accountname already exists. Is it okay to overwrite (N/Y)?
If you respond NO to the above prompt, output is directed to $STDLIST. You can use the CONFIGURE
command to change the output file during a run.
SDMAIN's Temporary Edit File
When you run SDMAIN, it creates an edit file named EDTXTxxx (where xxx is a number). EDTXTxxx is
created as a permanent file, but deleted when you exit the system (as long as you do not abort the
program). Therefore, if you issue an MPE LISTF command while running SDMAIN, this file is listed. If,
however, you already have a file with the same name and number as the EDTXTxxx file, SDMAIN
increments the EDTXT number and uses that number.
For example, if you already have a file named EDTXT0, then when the edit file is created, SDMAIN finds
EDTXT0, increments the number to 1, and creates an edit file with the name EDTXT1. There is, therefore,
no conflict between the two files, and your file, EDTXT0, is not deleted.
SDMAIN's Run Options
When SDMAIN is run, you can specify one of several run options through use of the PARM parameter.
This parameter allows you to specify how errors that you may encounter are dealt with. The basic syntax
of the RUN command with the PARM parameter is:
:RUN SDMAIN.PUB.SYS; PARM = n
The options available for the PARM value are:
Parse-Only Option
To run SDMAIN with the Parse-Only option, enter the following command:
:RUN SDMAIN.PUB.SYS;PARM = -1
All commands are checked for correct syntax, but the contents, structure, etc., of the dictionary remains
unchanged. This option can prove helpful when instructing employees how to use System Dictionary. In
this way, all commands can be entered without the dictionary contents being changed.
Perhaps the most important use of the Parse-Only option, however, occurs when running System
Dictionary in batch mode. This allows you to run the job and catch syntax errors before actually altering
dictionary contents or structure. Once the commands have been parsed, or checked for syntax errors, you
can then resubmit the job and execute the commands.
Whenever SDMAIN is run in batch mode, without the Parse-Only option, the contents of the dictionary are
altered for all valid commands, but not for any invalid commands. Therefore, the dictionary can be left in
an incomplete state since all valid commands were executed, while all invalid commands were not
executed. Also, for run options of 1 or greater, no commands encountered after the given number of errors
specified by the run option are executed. This becomes tedious, because once this occurs and the error is
corrected, the valid commands that were executed prior to the error need to be deleted. Otherwise, these
commands are executed for the second time once the batch job is resubmitted.
-1 Parse only. Only command syntax is checked. The dictionary remains unchanged.
0 Execute and do not terminate regardless of the number of errors. This is the default option.
1 Execute and terminate on the first error.
>1 Execute and terminate if the specified number of errors are encountered.