Viewing the Process List

To access the Process List page, select PeopleTools, and then Process Scheduler, and then Process Monitor.

This example illustrates the fields and controls on the Process List page. You can find definitions for the fields and controls later on this page.

Process List page
Field or Control Description

User ID

View the processes submitted by a user ID. Usually, you view your own user ID. Leave blank to view all of the processes that you are authorized to view.

Type

View by a process type, such as Application Engine, COBOL, SQR, or Application Engine.

All or Last or Date Range

Specify an interval of time by which to limit the process requests that appear in the list. When you select All, the time interval fields are grayed out and all process requests appear.

Select Last to display only those reports that were created in the last number of days, hours, years, or minutes. Enter a custom numerical value in the field and then select a unit type: Days, Hours, Years, or Minutes.

Select Date Range to display only those reports created between two specific dates. Enter a From date and a To date.

Refresh

After selecting your filtering options, select Refresh to display the filtered processes.

Clear

Select to clear the filters and set them to their default values.

Reset

Select to reset the filters to the last saved values in the database.

Server

View processes that are run on a particular server.

Name

View processes by a process name.

Note: You will not be able to select a value for this field until you first select a process type.

Instance

Specify an instance by which to limit the process requests that appear in the list. To limit the view to a single request, enter the required instance ID in the text field. To specify a range of instances, click the Range hyperlink, so that the label Instance changes to Instance From and an additional field named Instance To appears.

Report Manager

Select to go to the Report Manager page.

Run Status

View processes by status, such as Success or Error.

Distribution Status

View processes by distribution, such as Generated or Posted.

Save on Refresh

Select the check box to save changes to filter criteria when you select the Refresh button.

The rules applying to Save on Refresh are listed later in this section.

Select All and Deselect All

The Select All and Deselect All buttons appear at the bottom of the page when the process list contains processes that can be deleted, cancelled, held, or restarted.

Select Select All to select all valid processes. Once selected, select Delete Request to delete all the selected processes. Click Cancel Request to cancel all of the selected processes. Click Hold Request to hold all of the selected processes. Click Restart Request to restart multiple processes or jobs that are on hold.

Click Deselect All to deselect all valid processes.

Use the check box that appears to the left of each process to select individual processes. The check box is only active for valid processes.

Note: The Delete, Cancel, Hold, and Restart options can be performed only on processes with specific run statuses. Therefore, the options will only be visible when processes are filtered by a valid run status for that option.

Instance

Displays the process instance; that is, the order in which the process appears in the queue. This number is generated automatically.

Seq (sequence)

Within a PSJob, each process request has a defined sequence in which it runs in relation to the others. This column displays this sequence, such as 1, 2, 3, and so on.

Run Control ID

Displays the Run Control ID of the process, which helps you identify processes with the same process name but different Run Control ID.

Process Type

Displays the type of process, such as Application Engine, COBOL, or SQL.

Process Name

Displays the name of the process.

When a job or jobset is listed, only the main job appears and the system displays its name as the link. Job items are retrieved only through process instance search. When you search by a process instance of a process which is a job item, the system displays its name as a link. Click to see the status of all jobs and processes that are attached to the main job.

User

Displays the user ID of the person who submitted the request.

Run Date/Time

Displays the time and date at which the process request was created.

Run Status

Indicates the status of the process, such as Queued, Initiated, or Cancelled.

A complete list of Run Status values appears later in this section.

Distribution Status

Displays the distribution status for each individual job and process. Valid states are: N/A, None, Generated (OS/390), Not Posted, Posting, and Posted.

Note: If the Inter-Domain Gateway connections are done as per Push Notification configurations, Run Status Changes will get automatically updated for the processes or jobs in the list.

Details

Click to display the Process Details page.

Actions

Click the Actions menu for a list of related actions that can be performed on the current process:

Update Process: Select to view a list of actions that can be performed on the process based on the current run status of the process. The options enabled here will be the same as the actions available under Update Process of the Process Detail page.

See the Update Process section in Viewing Process Details for a list of valid actions that can be performed on the process.

Parameters: Select to view the process request parameters for the process.

Message Log: Select to view the message log for the process.

Batch Timings: Select to view the batch timings of the process.

View Log/Trace: Select to view the process log or trace details for the process.

Note: The options displayed on the list depends on the current run status of the scheduled process request.

See Understanding Jobs and JobSets, Defining Recurrence Definitions.

Process Request Run Status

The Run Status column on the Process List page indicates the current state of a process. Knowing the status of a job helps you determine where it is in the queue or identify a problem if the process has an error.

Run Status Description Updated By

Blocked

The running of this process has been blocked, which indicates that this process is waiting for one of the following: the number of active occurrences of this process to drop below Max Concurrent value, a process recognized as mutually exclusive to complete, or a dependent file to be located.

Batch program

Cancel

Indicates that a user has requested to cancel the scheduling of a process request.

Process Monitor

Cancelled

Indicates that the server agent has successfully canceled the request after it has started.

PeopleSoft Process Scheduler Server Agent

Error

Indicates that the program associated with the process request encountered an error while processing transactions within the program. In this case, delivered programs are coded to update the run status to Error before terminating.

Batch Program

Hold

Indicates that a user has requested that the scheduling of a process request be put on hold.

Process Monitor

Initiated

Indicates that a PeopleSoft Process Scheduler Server has acknowledged the new request. At this time, PeopleSoft Process Scheduler validates the parameters that are associated with this request and submits the command line to start the process.

PeopleSoft Process Scheduler

No Success

Indicates that the program encountered an error within the transaction. No Success is different from Error because the process is marked as restartable. (Application Engine is the only delivered process type that is restartable.)

Batch Program

Pending

Status assigned to an item of a new PSJob request. This indicates that this item is waiting for a previous item in the job before PeopleSoft Process Scheduler releases this item. When the previous item has completed successfully, PeopleSoft Process Scheduler changes the status of the item to Queued.

Process Request Dialog or ProcessRequest() PeopleCode function

Processing

Indicates that PeopleSoft Process Scheduler has successfully initiated the program. A status of Processing indicates that the program is running.

Batch Program

Queued

Status assigned to a new process request. The process request remains Queued until a PeopleSoft Process Scheduler Server picks up the new request.

Process Request Dialog or ProcessRequest() PeopleCode function

Restart

Indicates that a process, which encountered an error, is attempting to restart.

Batch program

Success

Indicates that the program has successfully completed.

Batch Program

Warning

A warning status is available to use in a job definition. A job definition may continue or stop when a process encounters a warning.

The warning status must be set using PeopleSoft Application Engine. Set the AE_APPSTATUS field to 1.

Batch program

Save on Refresh

The following rules apply to the Save on Refresh check box:

  • The Save on Refresh check box is selected by default.

  • Instance to values are not saved, even if the Save on Refresh check box is selected.

  • Selecting Save saves any changed filter criteria.

  • Changed filter criteria is saved if you select the Refresh button and the Save on Refresh check box is selected.

  • Changed filter criteria is not saved if you select the Refresh button and the Save on Refresh check box is not selected.

    However, a warning message appears when you attempt to leave the page.

  • The save warning message appears when changes have been made to filter criteria and you attempt to leave the page without selecting the Refresh button.