2.2 Stages in Processing a Job

To use RJE, all you need to do is start the RJE workstation and submit a job. The RJE workstation sends the job to the host and receives and routes the host output.

The following steps describe the stages involved in submitting and processing a job using RJE. The numbered tasks indicate actions you, the user, can take (many of which are optional). The unnumbered tasks are performed by RJE.

1. Create the job file

Create a job file that contains the instructions required by the host. This file can include all the data required by the host, or can contain ~include commands to include additional data files.

For more information about the format of this file, see Contents of a Job File.

2. Add the job to the workstation's job spool

Use the snajobsub command to submit the job. This command adds the job to a spool of jobs waiting to be sent by the RJE workstation. The job can be sent to the host immediately (if the workstation is running and no other jobs are waiting), or can be held on the local spool and sent later (if the workstation is not running or if other jobs are already waiting to be sent).

Sample command: snajobsub wks1 myjob

For more information about this command, see Accessing the Job Spool, and Submitting a Job.

3. Check the spooled jobs

While the job is waiting on the spool, you can use the snajoblst command to list all the jobs you have submitted, or snajobcan to cancel a queued job.

Sample commands:

snajoblst wks1

snajobcan wks1 SPL_fjghld

For more information about these commands, see Accessing the Job Spool, Listing the Submitted Jobs, and Canceling a Job.

4. Run the RJE workstation

Start the RJE workstation program if it was not already running when the job was submitted.

Sample command: snarjewks wks1

For more information, see RJE Workstation.

5. Display workstation status information

You can use the snarjestat command to view information about the activities of the RJE workstation's LUs and devices.

Sample command: snarjestat wks1

For more information, see RJE Workstation, and Displaying RJE Workstation Status.

The workstation sends the job to the host

The RJE workstation takes jobs from the spool, in the order in which they were submitted, and sends them to the host for processing. The jobs are then processed by the host. If an error occurs during sending (for example, a link failure), the RJE workstation tries again to send when the session is re-established. After a number of failed attempts for the same job (normally 10, unless a different retry count was specified when submitting the job), the workstation abandons the job and does not make any further attempts to send it.

6. Send host commands to the RJE workstation

You can use the snarjecmd command to send host job entry subsystem (JES) commands to a workstation.

Sample command: snarjecmd wks1 \$p wks1.PU2

The syntax of JES commands is defined by the host; refer to your host JES documentation for more information about the commands you can use. For more information about the snarjecmd command, see Sending Host Commands.

7. View host console information

Once the job has been submitted to the host, you can use the console program to examine the status of jobs queued at the host and to view information returned by the host.

Sample command: snarjecon wks1

For more information, see RJE Console Program, and RJE Console Program.

The workstation receives and routes the host output

The host processes the job and returns output to the RJE workstation. The workstation sends the output from the host to the appropriate file, directory, or program, as specified in the configuration.

For more information, see Output Processing, and RJE Workstation.