USUB - User Report Submission
(telnet version)

The usub command may be used to submit any job for immediate or delayed execution. Additionally, an automatic repeat interval may be specified for running a job regularly. Usub is invoked from the system command prompt (usually the ">" symbol). You must use telnet software to log in to your laurel account to use usub.

The general form for usub is:

usub <optional run-time parameters> <jobname and job parameters>
For example, to immediately run the job 'sectenroll' for term 199840 and Dept=Math, use:

usub sectenroll 199840 M NS MATH
To run this same job at 5am every day (interval=1) starting on May 1, 1998 use:

usub 0500 1-may-98 1 sectenroll 199840 M NS MATH
To remove this job from the queue type: unsub cataudits

To see all the jobs you may have waiting to run type: qfind
To find out more information about any job, type "jobname help". For example:

sectenroll help
NOTE: You may be prompted for your Banner user name and password. Enter the name and password you use for access to Banner forms.


Additional Details:

Submit a Job to the User Queue to be run Once or Repeatedly:

usub [run-time] [run-date] [interval] jobname [parameters]

Optional run-time parameters (run job now if no run-time parameters):
run-time 4 digits, values 0000-2359
(default is now)
run-date date (dd-mon-yy) or days from today (must be provided to specify a interval)
(default is today)
interval # of days between repeat runs
(default is to run once)

Job parameters:
jobname the name of the job to run.
Use "index job" to get a list of available jobs.
parameters vary with job. Type "jobname help" to see job-specific parameters.


Examples:  
usub test1 xxx yyy
(run test1 now with parameters xxx and yyy)
usub 1800 test1
(run test1 at 6PM today with no parameters)
usub 0200 1 7 test1
(run test1 at 2AM weekly starting tomorrow)
usub 2300 1-dec-93 test1
(run test1 at 11PM on Dec 1st)


Notes:

- The order of date and time does not matter, but must precede interval.
- The job may be removed from the queue with unsub. Use "unsub jobname" or type "unsub help" for more information. Unsub jobs may also be scheduled with usub for running at a later date. (usub <date time> unsub <jobname>)
- Before using usub the first time, enter the following command at the ">" prompt: /u/jobs/bin/uconfig
Only do this once, and then log out and back in for it to take effect.