HP 3000 Manuals HP 3000 Manuals
Running the SDMAIN Program
You can run the SDMAIN program in either session mode or batch mode.
After logging on and defining the files that you will be using, you are
ready to run the System Dictionary Maintenance program in session mode.
Session Mode
To run SDMAIN in session mode, enter the following MPE command:
RUN SDMAIN.PUB.SYS
Now press [[RETURN]]. SDMAIN responds with the banner, followed by a
prompt character:
HP System Dictionary SDMAIN HP32256v.uu.ff - (C)Hewlett-Packard Co. 1985
SDMAIN Prompt Characters. SDMAIN uses both a command (single) prompt and
a continuation (double) prompt:
-----------------------------------------------------------------------------------
| | |
| > | Command prompt. SDMAIN expects a command. |
| | |
| >> | Command continuation prompt. SDMAIN expects a subcommand or a |
| | keyword clause to complete the command. |
| | |
-----------------------------------------------------------------------------------
Once the command prompt (>) appears, SDMAIN is ready to receive commands.
The only SDMAIN commands that are allowed at this point are:
-----------------------------------------------------------------------------------
| | |
| COMMAND | Makes a comment |
| | |
| CONFIGURE | Sets the output configuration |
| | |
| DEFINE | Defines the SDMAIN environment |
| | |
| EXIT | Terminates the program |
| | |
| FORMAT | Specifies a title and header for a report |
| | |
| HELP | Gets a list of valid commands |
| | |
| INCLUDE | Redirects input from another file |
| | |
| OPTIONS | Sets prompting, logging, and macro options |
| | |
| REDO | Redoes the previous command |
| | |
| SHOW | Shows the SDMAIN environment |
| | |
| SHOWMACRO | Shows a list of the macros currently defined |
| | |
| SHOWREDO | Displays a list of commands currently on the redo history stack |
| | |
-----------------------------------------------------------------------------------
If you enter any other command, SDMAIN issues an error message.
Batch Mode
You can also execute SDMAIN in batch mode. If you have not already
created a job file, you can create one by using the MPE text editor
system. To begin creating your job file, enter the following command:
EDITOR
You may then begin entering your job file. When executing in batch mode,
the EDIT command, REDO command, and attribute prompting are not allowed.
One example of a job file is shown below. In this example, both the
input file and the output file are redirected:
!JOB SDJOB,MARSHA.ACCT Gives job name, user name and
account name
!FILE SDIN=COMMANDS Redirects SDIN input file
!FILE SDOUT=OUTPUT Redirects SDOUT output file
!CONTINUE Overrides any job or session
errors. Allows continuation of the
job if the following command
produces a fatal error.
!RUN SDMAIN.PUB.SYS;PARM=5 Issues SDMAIN RUN command
!IF JCW=FATAL THEN Tests for FATAL JCW condition
!TELL MARSHA.ACCT Fatal Dictionary Notifies user with TELL command if
Error FATAL
!ELSE Otherwise...
!TELL MARSHA.ACCT Dictionary Job Tells the user the dictionary job
Completed is completed
!ENDIF Ends IF statement
!EOJ End of job
Notice that the RUN command specifies a PARM parameter of 5. Therefore,
if 5 or more errors are encountered, the program terminates. The JCW
condition is checked and you are then notified that a fatal dictionary
error occurred. You must use the CONTINUE command. If you do not
include it, the job stream terminates on the FATAL error and you are not
informed of the errors that occurred.
You now need to correct the errors and delete the previously executed
valid commands in the input file before you resubmit the job.
Another way to proceed would be to use the Parse-Only option, catch all
the syntax errors, and then resubmit the job. You can still test for the
termination condition and be notified by the TELL command of either a
FATAL error or a completed job.
For more information on creating jobs, see the MPE XL Commands Reference
Manual (32650-90003).