HP 3000 Manuals HP 3000 Manuals
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:
-----------------------------------------------------------------------------------
| | |
| -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. |
| | |
-----------------------------------------------------------------------------------
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.
Execute and Terminate Options
The Execute and Terminate options (0, 1, or greater) allow you to specify
the number of errors that can occur before the SDMAIN program terminates.
The default option is 0--execute and do not terminate, regardless of the
number of errors. Option 1 causes the system to terminate the program
when the first error is encountered. When any number greater than 1 is
entered, the program terminates once this number of errors is
encountered.
Job Control Word (JCW)
The Job Control Word called JCW is a system parameter that indicates the
termination condition of the program. JCW is set by the system according
to the condition under which the SDMAIN program is terminated. The two
possible settings for JCW are:
-----------------------------------------------------------------------------------
| | |
| 0 | Program terminated normally with an EXIT command. |
| | |
| 32768 | Program terminated abnormally before an EXIT command. |
| | |
-----------------------------------------------------------------------------------
The Job Control Word allows a batch mode user to test for the termination
condition and act accordingly.
The JCW is set to 32768 (FATAL) whenever the system must terminate before
executing an EXIT command. This can occur as a result of several
conditions:
* The number of errors encountered equaled or exceeded the number
specified by the PARM value.
* A fatal MPE file system error was encountered.
* An SDMAIN system bug was discovered.