Previous Page Contents Page Next Page

3.8 Purging Stored Information for a Sent Job

The snajobpur command purges status information for a job that has been sent to the host. The job must be purged by the user who submitted it (using the same user ID), except that a user logged on as root can purge any job.

SNAP-IX stores information about sent jobs only if the list_sent_jobs parameter is set in the workstation style file; see define_minor_options Record, for more information on the list_sent_jobs parameter. If you use this option, you should use the snajobpur command regularly to ensure that SNAP-IX does not retain too much information (which may affect disk space or the performance of RJE programs).

Sample command: snajobpur 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.

3.8.1 Syntax

The two syntax forms for the snajobpur command are:

snajobpur [ -r ] wkst spool-id [ spool-id ...] snajobpur [ -r ] wkst ALL

3.8.2 Options

You can use the following option with the snajobpur command:

Root. Normally you can purge information for 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 snajobpur command does not purge information for a job that was submitted using a different user ID. The option, which is valid only if you are logged on as root, forces the information to be purged irrespective of the user ID with which the job was submitted.

3.8.3 Parameters

You can use the following parameters with the snajobpur command:

wkst

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

Spool ID of the job for which information is to be purged. You can purge information for more than one job by specifying more than one spool ID.

To check the spool ID for a sent job, use the snajoblst command (with the option) to list the sent jobs for the workstation with their spool IDs. The spool ID is similar to the spool ID returned to the snajobsub command when the job was submitted, except that the initial characters SPL are replaced by STS when the job is successfully sent.

To purge information about all jobs submitted using your user ID (or all jobs regardless of user ID, if you are using the option), replace the list of spool IDs by the word ALL or all.

3.8.4 Returned Messages

The format of the snajobpur command returned messages is:

Job spool-id cleared

Other messages can be sent to standard error, indicating (for instance) the following:

Previous Page Contents Page Top of Page Next page