Defining Jobs and JobSets

This chapter provides an overview of jobs and JobSets, and discusses how to:

Click to jump to parent topicUnderstanding Jobs and JobSets

This section lists common elements and discusses jobs and JobSets.

Click to jump to top of pageClick to jump to parent topicCommon Elements Used in This Chapter

Schedule Name

Displays the name of the JobSet definition schedule that is assigned when adding a new value.

Job Name

Displays the name of the job definition to be scheduled. The Job Name can have a maximum length of 8 characters.

Note. Although you can create a job with a job name that exceeds 8 characters, you will encounter an error message when you attempt to run the job.

JobSet Report

Click to display a hierarchical view of the processes within the JobSet.

Report Manager

Click to access the Report Manager module to view report results.

Process Monitor

Click to access the Process Monitor to view the status of job requests.

Click to jump to top of pageClick to jump to parent topicJobs and JobSets

PeopleSoft Process Scheduler enables you to schedule one or more processes as a group. In this context, job describes this type of process group.

A process is a single task, program, or routine, such as a Structured Query Report (SQR) report or COBOL program that runs either on the client or on a server. A job consists of one or more processes of the same or different types that are submitted as a unit and can run either in series or parallel. They require the scheduling support that only a server environment can offer and all processes must be API-aware.

Scheduled JobSets enable you to schedule a recurring job using a schedule JobSet definition. Each process within a job can be altered to set up its own output destination options or set the operating system where the process is to be scheduled.

Features that are available when scheduling JobSets that are not available with recurring jobs are:

See Also

Defining Scheduled JobSets

Using Process Request APIs

Click to jump to parent topicCreating Job Definitions

This section lists common elements and discusses how to:

Click to jump to top of pageClick to jump to parent topicCommon Elements Used in This Section

ID Type

Select a role or user ID.

Distribution ID

Enter the actual user ID or the name of the role.

Click to jump to top of pageClick to jump to parent topicPages Used to Create Job Definitions

Page Name

Definition Name

Navigation

Usage

Job Definition

PRCSJOBDEFN

PeopleTools, Process Scheduler, Jobs, Job Definition

Define a job definition.

Job Definition Options

PRCSJOBDEFN2

PeopleTools, Process Scheduler, Jobs, Job Definition Options

Define options for jobs that you run on a regular basis.

Job Distribution

PRCSJOBNTDIST

PeopleTools, Process Scheduler, Jobs, Job Distribution

Set up a distribution list for jobs, based on role or user ID.

Job Notification

PRCSJOBNOTIFY

PeopleTools, Process Scheduler, Jobs, Job Notification

Set up a list of users to be notified if a process encounters an error, warning, successfully completes, or is disabled.

Job Messages

PRCSJOBMESSAGE

PeopleTools, Process Scheduler, Jobs, Job Messages

Specify the messages that are sent when the Job Notification feature is used.

Job Runtime Parameters

JOB_RUNCNTL_PARAM

PeopleTools, Process Scheduler, Jobs, Job Runtime Parameters

Set the job runtime parameters.

Click to jump to top of pageClick to jump to parent topicDefining Jobs

To access the Job Definition page, select PeopleTools, Process Scheduler, Jobs, Job Definition.

Before creating a job definition, define the individual processes that are included in the job.

Run Mode

Serial: Select to run each process in the job sequentially.

Parallel: Select if you don’t have a requirement for the processes to run in a certain order. If you select this option, Run Always check boxes for all of the processes are selected.

Priority

Select High, Medium, or Low. PeopleSoft Process Scheduler initiates the job with the highest priority first.

Process Category

Select a process category for this job.

Note. The categories Default and LOADCACHE are delivered with your system.

Max Concurrent

Enter the maximum number of occurrences of this job that can be active at one time across all process schedulers. The default value is unlimited (blank).

Jobs exceeding the maximum will appear on the Process Monitor with a run status of Blocked. As active occurrences complete, blocked jobs are released and scheduled.

Override Process Retry Count

Select to override the process definition retry count for the individual processes contained in this job.

Selecting the check box activates the Retry Count field.

Retry Count

Enter the number of times the system should attempt to restart this job.

Override Process Retention Day

Select to override the process definition retention days for the individual processes contained in this job.

Retention Days

Enter the number of days before the files that are on the report repository are deleted.

JobSet Report

Click to go to the JobSet Report page.

See Defining Process Categories, Displaying a Hierarchical View of Processes in a JobSet.

Process List

This group box lists all processes and jobs that are associated with this job. To add additional rows or processes, click the Insert Row button that precedes the location where you want the new row.

Process Type

Select the processes that you want in the order that you want them to run.

Run Always on Warning

Select to enable the next process in the queue to run, regardless of whether the process situated immediately before this process ran to warning.

Run Always on Error

Select to enable the next process in the queue to run, regardless of whether the process situated immediately before this process ran to error.

The Run Always feature only works if the process that is selected to run is always the next process in the queue after the process that ran to error or warning. For example:

A serial job contains three processes. The third process in the queue is selected to Run Always on Error. If the first process in the queue runs to error, the third process will not run because the system looks only to see if the next process in the queue is selected. Process #2 is not selected, so the job runs to No Success.

Note. After completing this page, select a server name and recurrence name on the Job Definition Options page.

Procedure for Run Always Settings

This table shows the procedure for the Run Always on Warning and Run Always on Error settings:

Run Always on Warning

Run Always on Error

Process Status

Job Status

Next Process Scheduled

0

0

Warning

Warning

No

0

0

Error

Error

No

1

0

Warning

Warning

Yes

1

0

Error

Error

No

1

1

Warning

Warning

Yes

1

1

Error

Error

Yes

Run Always - Functionality Rules

Process Scheduler uses the following rules when either of the Run Always check boxes are selected for a PSJob contained within another PSJob.

Note. The Run Always check box must be selected for individual items within a PSJob. The items do not automatically inherit the selection if the check box is selected for the PSJob.

If a serial job (JOB A) contains another job as an item (JOB B), the Run Always check box is selected for JOB B, and the item that precedes JOB B receives a status of either Error or No Success. Process Scheduler proceeds using the following rules:

Click to jump to top of pageClick to jump to parent topicSetting Job Definition Options

To access the Job Definition Options page, select PeopleTools, Process Scheduler, Jobs, Job Definition Options.

Use the Job Definition Options page to define options for jobs that you run on a regular basis.

Server Name

Enter a server name if you want to require this job to run on a specific server only. If you leave this field blank, the job finds an available server on which to run, based on the process class.

Recurrence Name

(Optional) Select a recurrence name for running at previously defined intervals.

Job Recovery Process

Process Type and Process Name

Enter the type and name of an optional process that can be run in case this job runs to an error. The job will not restart until the system recovery optional process entered here has run.

Job Definition Security

Component

To add new rows, click the Add button. This makes the job definition a member of that component. Adding a component to a job definition causes that job definition to appear on the Process Scheduler Request page when you select File, Run within that component group, if you have security to run the process.

Process Groups

Select an existing group, or add a new class by entering a unique process group. To add new rows, click the Add button. A job definition may be a member of multiple process groups. Process Groups are assigned in PeopleSoft Security Administrator. This enables you to specify the process requests that classes of users can run.

Click to jump to top of pageClick to jump to parent topicDefining Distribution Lists

To access the Job Distribution page, select PeopleTools, Process Scheduler, Jobs, Job Distribution.

Use the Job Distribution page to set up a distribution list for jobs, based on role or user ID.

Note. You must specify an output type of Web, Window, or Email for the distribution list to be accepted when the PSJob is created

Override Distribution List from Processes in Job

Select to use the distribution IDs from the job definition. If the check box is deselected, distribution IDs from both the job and process definitions are used.

Job Within Job: The Override option for the main job is ignored. Process Scheduler uses the distribution IDs from the PSJob definition. If the check box is deselected, distribution IDs from both the PSJob and process definitions are used.

Note. When the Override option is selected for the main job, Process Scheduler uses the distribution IDs from the main job definition and ignores only the distribution IDs from the individual process definitions within the main job.

Click to jump to top of pageClick to jump to parent topicDefining Notifications

To access the Job Notification page, select PeopleTools, Process Scheduler, Jobs, Job Notification.

Use the Job Notification page to set up a list of users to be notified if a process encounters an error, warning, successfully completes, or is disabled. Set up the list based on role or user ID.

Override Notification List from Processes in Job List

Select to notify only users that are specified in the job definition. If deselected, users specified in the job and process definitions are notified.

Job Within Job: Select to notify only users that are specified in the main job definition. If deselected, users specified in the main job, jobs within, and process definitions are notified.

Important! The Override option is ignored for any job listed within the main job.

On Error

Send notification to the Distribution ID if an error occurs in the process.

On Warning

Send notification to the Distribution ID if a warning occurs in the process.

On Success

Send notification to the Distribution ID when the process successfully completes.

Disabled

Select if you do not want to send notifications to users specified on this line.

Click to jump to top of pageClick to jump to parent topicSpecifying Job Notification Messages

To access the Job Messages page, select PeopleTools, Process Scheduler, Jobs, Job Messages.

Use the Job Messages page to configure the messages that are sent when the Job Notification feature is used. You can specify messages for successful completions, errors, and warnings.

Message Type

Select the message type:

Default Message: Use the basic default message.

Customized Message: Create your own message.

Message Catalog: Select a message from the Message Catalog.

Message Set/Number

Select the Message Catalog set and number of the message. Complete these fields when the message type is Message Catalog.

Text

Enter the message text when the message type is Customized Message.

Click to jump to top of pageClick to jump to parent topicSetting Job Runtime Parameters

To access the Job time Parameters page, select PeopleTools, Process Scheduler, Jobs and click the Job Runtime Parameters tab.

Use this page to enable the Run option from the Reporting Console.

Enable Generic Prompting

Select this check box to allow users to schedule this job from the Reporting Console.

Allow Access By User With

Select the type of permission required to schedule the job from the Reporting Console. It specifies whether full process security or process group security should be applied when the process is run from the Reporting Console or a web service.

  • Full Process Security indicates that the process security defined on the Job Definition Options page will be used to determine which users can schedule this process from the Reporting Console. The user must have permission to at least one of the Components, as well as be a member of at least one of the Process Groups listed on the Job Definition Options page.

  • Process Security Group indicates that the user must be a member of at least one of the Process Groups listed on the Job Definition Options page to schedule this process from the Reporting Console.

Note. Users with the role PeopleSoft Administrator will always get the Run option on the Reporting Console if Generic Prompting is enabled. Users with the role PeopleSoft Administrator have access to run all jobs regardless of process security settings.

Click to jump to parent topicDefining Scheduled JobSets

This section provides an overview of schedule JobSets and discusses how to:

Click to jump to top of pageClick to jump to parent topicUnderstanding Scheduled JobSets

PeopleSoft Process Scheduler provides the ability to define and set up interdependencies among application jobs and processes, which enables the user to schedule jobs in accordance with the logical business model. For example, in PeopleSoft HRMS, all employees’ time cards can be tabulated in PeopleSoft Time and Labor before running the human resources (HR) payroll jobs.

Click to jump to top of pageClick to jump to parent topicPages Used to Define Scheduled JobSets

Page Name

Definition Name

Navigation

Usage

Schedule JobSet Definition

SCHDLDEFN

PeopleTools, Process Scheduler, Schedule JobSet Definitions, Schedule JobSet Definition

Set JobSet scheduling options.

JobSet Report

SCHDL_RPTOPT

Click the JobSet Report link on the Schedule JobSet Definition, Schedule Job Items, or Schedule JobSet Requests page.

Display a hierarchal view of processes in a JobSet.

Schedule JobSet Items

SCHDLITEM

PeopleTools, Process Scheduler, Schedule JobSet Definitions, Schedule JobSet Items

Specify options for individual jobs and processes.

Schedule JobSet Requests

SCHDL_RQST_LIST

PeopleTools, Process Scheduler, Schedule JobSet Definitions, Schedule JobSet Requests

View the status of each process request contained in the selected JobSet without using Process Monitor.

Click to jump to top of pageClick to jump to parent topicCreating Scheduled JobSet Definitions

To access the Schedule JobSet Definition page, select PeopleTools, Process Scheduler, Schedule JobSet Definitions, Schedule JobSet Definition.

Use the Schedule JobSet Definitions page to set JobSet scheduling options. You should use this page rather than the Process Scheduler Request page.

User ID

Displays the user ID of the person entering the information.

Description

Enter a description for the JobSet schedule. The default is the schedule name.

Status

Select Active, Completed, or Inactive (default).

To schedule the JobSet, you must enter and save changes, change the status to Active, and then save. Once scheduled, the status is Completed.

Run Control ID

Enter the run control ID.

Priority

Select High, Medium (default), or Low.

Begin Date

Enter the date on which the JobSet should begin to run. The default is today’s date.

Time

Enter the time at which the JobSet should run. The default is the current time.

Time Zone

Select the time zone in which the job will run. For instance, you might be in Eastern Standard Time (EST) and schedule the job to run in Pacific Standard Time (PST). The default is the user’s time zone.

Recurrence Name

Select a recurrence name for running at previously defined intervals.

Note. This name does not display on the Process Monitor - Process Detail page. Use the Schedule JobSet Requests page to view the next scheduled start date and time based on the recurrence definition.

Important! To eliminate the possibility of duplicating JobSets, you must configure the system with a master scheduler. The task of scheduling JobSets has been removed from a standalone PSPRCSRV and is strictly the responsibility of the master scheduler. If a master scheduler is not configured, the recurrence setting will be ignored.

Run Now

Select this button to run the process immediately.

Important! The Begin Date and Time fields are populated by default with the current date and time. To run the JobSet immediately, leave the default values in these fields, activate the JobSet, and select Save. Do not click the Run Now button, as this will also trigger a process request. The Run Now button should only be used if the Begin Date and Time values are changed to a future date and time and you want the process to run immediately then.

Server Run Option

Select the server on which this job should run. Select Any Server (default), Primary Server, Specific OS, or Specific Server.

Primary Server

Select the required server if the Server Run Option value is Primary Server or Specific Server.

Operating System

Select the required operating system if the Server Run Option value is Any Server or Specific OS. The default is Any Server.

Note. Once a jobset has been scheduled, if a user changes the Begin Date, Begin Time or Time Zone fields, the next start date time will be overwritten with the new date and time. If a Recurrence exists for this schedule, the Recurrence will be blanked out because changing the initial values will break the Recurrence. The user will need to re-enter the recurrence.

Click to jump to top of pageClick to jump to parent topicDisplaying a Hierarchical View of Processes in a JobSet

Select the JobSet Report link to access the JobSet Report page.

Select the check boxes for the items you want to display. Select from:

Click to jump to top of pageClick to jump to parent topicSetting Options for JobSet Items

To access the Schedule JobSet Items page, select PeopleTools, Process Scheduler, Schedule JobSet Definitions, Schedule JobSet Items.

If the output options were specified at the main JobSet level, then these options apply to all items of that job. You can specify options for individual jobs and processes on this page. These options override the output options that are specified for the parent job.

This page lists each individual process that is contained in the jobs and JobSet and displays a hierarchical view of the processes.

This section discusses how to specify:

Specifying General Settings

To specify individual general settings:

  1. Select the General Settings tab.

  2. Enter run control IDs for the required jobs and processes.

Specifying Output Settings

To specify individual output settings:

  1. Select the Output Settings tab.

  2. Select the output type and format for the required jobs and processes.

  3. Click the Distribution link for required processes to enter distribution detail information.

    You must specify an output type of Web, Window, or Email for the distribution list to be accepted when the PSJob is created

    Important! The distribution list is based solely on the information specified for individual processes within the JobSet. Do not enter distribution information in the job header. If the JobSet has no distribution lists, the requester will be the only recipient of the reports.

Specifying Server Settings

To specify individual server settings:

  1. Select the Server Settings tab.

  2. Select the server option for the required jobs and processes:

  3. Select the required server if the server option is Primary Server or Specific Server.

  4. Select the required operating system if the server option is Any Server or Specific OS.

Note. A Master Scheduler is required to be up and running if you want to distribute the workload across multiple Process Schedulers.

See How to Use Multiple Master Schedulers.

Specifying Time Settings

To specify individual time settings:

  1. Select the Time Settings tab.

  2. Select the runtime option for the required jobs and processes:

  3. Enter the run time and estimated CPU time if the runtime option is Specific Time.

Specifying Other Settings

To specify individual other settings:

  1. Select the Other Settings tab.

  2. Click the Notification link for required jobs and processes to enter notification detail information.

    Note. Only notification information entered in the JobSet will be in effect. Once Process Scheduler detects notifications in any of the items of the JobSet, it will ignore any notification information found in the Job Definition and Process Definition.

  3. Click the Messages link for required jobs and processes to enter message detail information.

    Note. Only message information entered in the JobSet will be in effect. Once Process Scheduler detects messages in any of the items of the JobSet, it will ignore any message information found in the Job Definition and Process Definition.

  4. Click the Parameters link for required jobs and processes to enter parameter detail information.

Click to jump to top of pageClick to jump to parent topicViewing Scheduled JobSet Requests

To access the Schedule JobSet Requests page, select PeopleTools, Process Scheduler, Schedule JobSet Definitions, Schedule JobSet Requests.

Use the Schedule JobSet Requests page to view the status of each process request contained in the selected JobSet without using Process Monitor.

Next Start Datetime

Displays the date and time at which the JobSet is scheduled to run.

Request List

This group box lists each individual process contained in the jobs and JobSet.

Click to jump to parent topicMonitoring Jobs and JobSets

Select PeopleTools, Process Scheduler, Process Monitor to access the Process Monitor - Process List page.

Note. You can also access this page by clicking the Process Monitor link on either the Schedule JobSet Definition page or the Process Request Dialog page.

After a job is submitted using the Process Scheduler Request page or your scheduled job is triggered, use Process Monitor to review the status of scheduled or running processes.

When a job or JobSet is listed, only the main job appears on the Process Monitor - Process List page. To see the status of all jobs and processes that are attached to the main job, click the Job link to display the Process Monitor - Process Detail page. This page consists of a collapsible tree whenever a job is referenced. Select the Refresh button to update the status of each process.

See Also

Using Process Monitor