---

Batch Jobs

Write the commands to be executed in a file called a command procedure. Commands in this file mimic the commands that you would normally type interactively. Because you may not necessarily be on the system when the batch job is executed, the system relies on the command procedure for any information needed to complete the task. The command procedure must contain the necessary DCL commands, specialized program or package commands, and any data needed for the task.

A sample command procedure called AREA.COM is listed below:

$ fortran area 
$ link area 
$ run area 
$ exit

$ SUBMIT/NOPRINT AREA

---

The SUBMIT command assumes a file type of .COM. If you use a different file type , you must specify the entire file name.

---

When your job is entered in the system batch stream, the following sequence occurs:

1. The job is placed in the waiting queue of batch jobs, SYS$BATCH. You can see the position of your job in the queue by using the following command:

    $ SHOW QUEUE/ALL SYS$BATCH

1. When the system begins to process the job, it creates a log file in your root directory, i.e., your default directory when you login. The log file goes in the root directory regardless of the directory from which the job is submitted. The log file has the same root name as the command procedure, unless specified otherwise with the /LOG option (the /LOG option can also specify another disk or directory in which to store the log file). At the start of processing, the log file will be empty. The log file can document all commands executed during the batch job and, thus, increases in size as the job is processed. To document each command in the log file, include the SET VERIFY command at the beginning of your command procedure.

2. Since a batch job logs in under your username, your LOGIN.COM file will be executed before the batch command procedure (see "Defining Your Environment" on page 35 for information about setting up your LOGIN.COM file).

3. When the job is finished, the log file is automatically queued to the SYS$PRINT printer (unless the /NOPRINT or /NOLOG qualifier is used).

4. After the log file is printed, it is automatically deleted. You are strongly encouraged to use the /NOPRINT qualifier on the SUBMIT command.

$ HELP SUBMIT

Table 2.6: Qualifiers Used with the SUBMIT Command

Restarting a Batch Job

1. First create a command file with checkpoints (the listing in Figure 2.7 shows such a file).

Figure 2.7: Command Procedure with Checkpoints

    $ SUBMIT/RESTART MYBATCH.COM

Table 2.6: - Qualifiers Used with the SUBMIT Command

Restarting a Batch Job

Figure 2.7: - Command Procedure with Checkpoints

Generated with CERN WebMaker