Create or Change a Job Stream

Use the Job Schedule Maintenance (JOBS) program to create or change a job stream to automate printing of reports and documents. The PowerShift Job Scheduler can also launch a job to perform cleanup functions (e.g., terminate partitions of users who failed to log out, clear rogue partitions). Contact PowerShift Support for assistance in setting up a "housekeeping" job stream.

Important!
Each type of process that can be scheduled requires a separate job stream. See Types of Job Streams.

The job scheduler is disabled in when the system is in DEMO mode or a LOCKOUT is in effect. Jobs can still be started manually when in DEMO mode.

The program displays this information for each job stream:

Field Name	Displays
Job stream name	The name of the job stream
Job description	The description assigned to this job stream
Start	The time the last job started
Last run	The date and time of the last job run
Daily	Selected if the job is run multiple times per day
Mon	Selected if the job is scheduled to be run on Mondays; blank if the job is not scheduled for Mondays
Tues	Selected if the job is scheduled to be run on Tuesdays; blank if the job is not scheduled for Tuesdays
Wed	Selected if the job is scheduled to be run on Wednesdays; blank if the job is not scheduled for Wednesdays
Thu	Selected if the job is scheduled to be run on Thursdays; blank if the job is not scheduled for Thursdays
Fri	Selected if the job is scheduled to be run on Fridays; blank if the job is not scheduled for Fridays
Sat	Selected if the job is scheduled to be run on Saturdays; blank if the job is not scheduled for Saturdays
Sun	Selected if the job is scheduled to be run on Sundays; blank if the job is not scheduled for Sundays

Choose the appropriate options:

To	Do This
Add a job stream	Click Add. See step 2.
Delete a job stream	Highlight the line and click Delete. See Delete.
Copy a job stream	Highlight the line and click Copy. See Copy.
Display or change job stream	Highlight the line and click Select or double click the line. See step 2.
Print the job stream listing	Click Print. See Print.
Exit the program	Click Exit.

Enter or change data in these fields:

Field Name	Type / Max Length	Action / Description
Job stream name	Required 15 alphanumeric	Enter a name (15 alphanumeric characters maximum) for the job stream. Note The job stream name can only be entered when you are adding a new record.
Job description	Required 40 alphanumeric	Enter a description for this job stream. This description is the subject line of emailed output. Note The sequence number can only be changed when you are adding a new record.
Mondays Tuesdays Wednesdays Thursdays Fridays Saturdays Sundays	Conditional	Select the day or days of the week you want to run this job stream, or select the Run date. See Background for scheduling guidelines.
Start time	Optional 4 alphanumeric	Enter the time you want to start this job stream. Use a 24-hour clock and the format HH:MM. For example, enter 08:00 for 8:00 AM and 16:00 for 4:00 PM. See Background for scheduling guidelines.
Run date	Conditional 10 date	Select the date you want to run this job stream or enter a date shortcut, or leave blank if the job runs on specific days. See Background for scheduling guidelines.
'+' date shortcut	Optional	Specify the + (i.e., plus n days, weeks, months, etc.) date shortcut to use. Leave blank if you are using a coded shortcut such as EOM. Set the start time and run date to the first occurrence of the job. After the job is run, the Run date will reflect the next calculated date.
Daily job?	Optional	Select if you want to execute the same job multiple times in a single day. If selected, you also need to specify which days of the week the job runs and From time, End time and Run every options also be entered.
From time	Conditional	Enter the first (i.e., earliest) time in 24-hour clock HH:MM format you want the job run on selected days
End time	Conditional	Enter the last (i.e., latest) time in 24-hour clock HH:MM format you want the job run on selected days
Run every	Conditional	Enter the number of minutes between the start of one execution and start of the next execution
Last run dt/time	Display	The last date and time the job was run automatically (i.e., the field is not updated if you start the job manually)
Job end date/time	Display	The date and time the job completed an automatic run (i.e., the field is not updated if if the job was started manually)
Spl/Qicjob Rpt/Qiclook Only	Required	Select if the job stream will run RPG/Qiclook reports, erase spool jobs, or perform other housekeeping tasks (i.e., it does not run PowerShift programs)

Choose the appropriate options:

To	Do This
Change a field	Move the cursor to the field and make changes. Click Apply to accept your changes or Cancel to abandon them.
Delete a job stream	Click Delete. See Delete.
Enter notes about this job stream	Click Notes. See Enter Notes.
Display or change the job stream	Click List jobs. See step 4.
Start the job stream now	Click Start jobs.

The program displays the job stream name followed by information about each job:

Field Name	Displays
Seq	The job stream sequence number
Program name	The description assigned to this program or report
Option name	The saved options used when the job is run

Choose the appropriate options:

To	Do This
Add a job	Click Add. See step 5.
Delete a job	Highlight the line and click Delete. See Delete.
Copy a job	Highlight the line and click Copy. See Copy.
Display or change job stream	Highlight the line and click Select or double click the line. See step 5.
Print the job stream listing	Click Print. See Print.
Return to the job stream schedule	Click OK. See step 3.

Enter or change data in these fields:

Field Name	Type / Max Length	Action / Description
Job stream seq no	Required 4 numeric	Accept the displayed sequence number or enter another number. Jobs run in sequence from the lowest to highest number. Note The job stream sequence number can only be entered or changed when you are adding a new record.
Description	Optional 40 alphanumeric	Enter a description for this report.
Heading 1 - 2	Optional 75 alphanumeric per line	Enter the text that you want to print on the heading lines of the report.
Program name	Conditional / Required 5 alphanumeric	For a PowerShift program, click Job options and select the program name as saved in XROPT. If you selected the Spool/Qicjo Rpt/Qiclook only field, enter SPOOL, QICLOOK, REPORTS or PI.
Option name	Conditional 8 alphanumeric	For a PowerShift program, enter the name of the saved options to use when the report is run. For SPOOL, QICLOOK, REPORTS or PI, enter the appropriate command file name. #Z1SPOOL is an example of a *SPOOL command file For example,
Login branch	Conditional/Optional	For a PowerShift program, select the login branch.
User ID	Conditional/Optional 5 alphanumeric	For a PowerShift program, enter the user ID of the person to receive email notifications.

Choose the appropriate options:

To	Do This
Delete a job	Click Delete. See Delete.
Change the sequence number	Click Change no. This button is available only when you are adding a job.
Display or change options for the job	Click Job options. This button is available only for PowerShift programs.
Print the job stream listing	Click Print. See Print.
Return to the list of jobs	Click OK. See step 4.
Return the job stream schedule	Click Exit. See step 3.