|
|
|
|
The snajoblst command lists all the job files on the spool for an RJE workstation-jobs that have been submitted either by you or by other users in your group and that have not yet been sent to the host.
Sample command: snajoblst -b wks1
You must use this command on the computer for which the RJE workstation is configured (unless your System Administrator has set up the configuration to enable spool commands to be issued from other computers), and the SNAP-IX software must be started on that computer; however, the RJE workstation need not be running. Consult your System Administrator if necessary, or refer to the SNAP-IX Administration Guide for information about RJE workstation configuration or about starting the SNAP-IX software.
The syntax for the snajoblst command is:
snajoblst [ -s | -b ] [ -l ] [ -a ]wkst
You can use the following options with the snajoblst command:
Sent jobs only. By default, the snajoblst command lists only jobs that have been submitted but not yet sent to the host; this includes jobs that are currently being sent, or jobs for which send attempts have failed. The option lists only jobs that have been successfully sent to the host. If you use the option, you cannot use the option.
Both waiting jobs and sent jobs. This option lists all submitted jobs, regardless of whether they have been successfully sent to the host. If you use the option, you cannot use the option.
For both the and options, note that information about sent jobs is available only if you specified the list_sent_jobs parameter in the workstation style file (see define_minor_options Record, for more information on the list_sent_jobs parameter).
Long listing. By default, the snajoblst command lists only the spool ID, user ID, and job file name for each job. The option includes more detailed information. See Returned Messages, for more information.
All users. By default, the snajoblst command lists only the jobs that were submitted using your user ID. The option lists all jobs on the spool, submitted either by you or by other users of the workstation.
You must use the following parameter with the snajoblst command:
Name of the RJE workstation for which you want to list the submitted jobs. This must be the name of an RJE workstation in the SNAP-IX configuration file, whether or not the named workstation is currently running. The workstation name is not case sensitive.
Returned messages from the snajoblst command can be presented in either short format (the default) or long format (by specifying the option).
The format of the snajoblst command returned messages using the short listing is:
spool-id login-name jobfile
The format of the snajoblst command returned messages using the long listing is:
spool-id login-name date time status maxretry retrycount -options filesize jobfile
The parameters on the returned messages are as follows:
The spool ID returned when the job was submitted.
For a spooled job, this ID begins with the characters SPL, and is the ID required by the snajobcan command to cancel the job.
For a job that has been sent to the host (listed using the or option), this ID begins with the characters STS, and is the ID required by the snajobpur command to purge the stored status information for this job.
The login name of the user who submitted the job.
The full name and path of the job file submitted.
When the job was submitted.
This parameter can have the following values:
The job has not yet been sent to the host.
The job is currently being sent.
The attempt to send the job failed; either the RJE workstation terminated during sending and has since been restarted, or it has retried up to the maximum number of attempts without success (see the maxretry and retrycount parameters in this list).
The job has successfully been sent to the host.
If you use the option, only jobs in SENT state are listed. If you use the option, only jobs in WAITING or SENT state are listed. If you do not use either or , only jobs in WAITING, SENDING, or FAILED state are listed.
The maximum number of times the RJE workstation tries to send the job. This is normally 10, but a different limit may have been specified when the job was submitted (see Submitting a Job, for a description of the snajobsub command). If all the attempts fail, the job's status is changed to FAILED and it is abandoned.
The number of times the RJE workstation has tried to send the job.
The command-line options that were specified when the job was submitted.
The size of the job file in kilobytes.
The following are examples of the short and long listings of returned messages for the snajoblst command:
SPL_fgdjlh jim /usr/jim/myrjejob.file
STS_fgakrn jim 10/07/1995 12:45:17 SENT 0 -5 0 /usr/jim/myjob.01 SPL_fgdjlh jim 10/07/1995 12:47:56 WAITING 0 -5 0 /usr/jim/myjob.02
Other messages can be sent to standard error, indicating (for instance) the following:
Invalid option was supplied
Invalid workstation name was supplied
Parameter in the workstation style file was invalid
No jobs on the spool
|
|
|
 |
|