|
|
|
|
The snajobcan command cancels a job on the spool. The job must be canceled by the user who submitted it (using the same user ID), except that a user logged on as root can cancel any job.
Sample command: snajobcan wks1 SPL_fjghld
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 two syntax forms for the snajobcan command are:
snajobcan [ -f ] [ -r ] wkst spool-id [ spool-id ... ] snajobcan [ -f ] [ -r ] wkst ALL
You can use the following options with the snajobcan command:
Force. Normally you can cancel a job only if it is waiting for transmission to the host; the snajobcan command does not cancel a job that is in the process of being sent, or has been abandoned after a failed attempt to send it. The option forces the job to be canceled whatever its status.
Root. Normally you can cancel a job only if you submitted it (that is, if you are logged on using the same user ID with which the job was submitted); the snajobcan command does not cancel a job that was submitted using a different user ID. The option, which is valid only if you are logged on as root, forces SNAP-IX to cancel the job regardless of the user ID with which it was submitted.
You can the following parameters with the snajobcan command:
Name of the RJE workstation to which the job was submitted. 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.
Spool ID of the job to be canceled. You can cancel more than one job by specifying more than one spool ID.
The spool ID for a job is returned by the snajobsub command when the job is submitted; you can also use the snajoblst command to list the spooled jobs for a workstation with their spool IDs.
To cancel all jobs submitted using your user ID (or all jobs irrespective of user ID, if you are using the option), replace the list of spool IDs by the word ALL or all .
The format of the snajobcan command returned messages is:
Job spool-id cleared
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
You specified the option, but you are not logged on as root
If you cancel a job (using the option) after SNAP-IX has started sending it to the host, sending continues. However, if this send attempt fails (for example, if a connection failure occurs), no retries are made. (Normally, SNAP-IX would retry sending, if such an error occurred, up to ten times or the retry limit specified when the job was submitted.)
|
|
|
 |
|