eG Monitoring
 

Measures reported by PepPrsStatusTest

At any given point in time, an administrator would want to know the current status of the jobs run by a Process Scheduler. Knowing the status of a job helps an administrator determine where it is in the queue or identify a problem if the process has an error. Typically, the Process Scheduler Agent updates the Process table in the PeopleSoft database with the status of the processes run. By connecting to the PeopleSoft database and reading from the Process table, the PepPrsStatusTest reports how many processes are in which state presently.

The measures made by this test are as follows:

Measurement Description Measurement Unit Interpretation
Initiated Indicates the number of processes in the Initiated state currently. Number The Process Scheduler changes the status of a request to Initiated after:
  • Acknowledging the request;
  • Validating the parameters of the request, and;
  • Submitting the command line to start the requested process

Use the detailed diagnosis of this measure to know which processes are in the Initiated state.
Processing Indicates the number of processes that are in the Processing state currently. Number Use the detailed diagnosis of this measure to know which processes are in the Processing state.
Pending Indicates the number of processes that are pending processing. Number A non-zero value for this measure indicates that an item of a new PSJob request is waiting for a previous item in job to complete. When this previous job completes successfully, PSPRCSRV changes the status of this job to Queued.

A high value for this measure could indicate a bottleneck with the scheduler.

Use the detailed diagnosis of this measure to know which processes are in the Pending state.

Queued Indicates the number of processes that are currently in the Queued state. Number This status is assigned to a new process. The request remains queued until a PSPRCSRV picks up the new request.

Use the detailed diagnosis of this measure to know which processes are in the Queued state.
Hold_req Indicates the number of processes that are currently in the Hold state. Number A non-zero value for this measure indicates that the user requested scheduling has been put on hold for some requests.

Use the detailed diagnosis of this measure to know which processes are in the Hold state.

Posting Indicates the number of processes in the Posting state currently. Number Programs that generate reports (such as SQR and Crystal) have this run status when the report has been generated and is waiting for the Distribution Agent to post the report to Report Manager.

Use the detailed diagnosis of this measure to know which processes are in the Posting state.
Posted Indicates the number of requests in the Posted status. Number A non-zero value for this measure indicates that the Distribution Agent has posted one/more reports to the Reports Manager.

Use the detailed diagnosis of this measure to know which processes are in the Posted state.

Content_generated Indicates the number of requests in the Content Generated state. Number PSPRCSRV (Process Scheduler Agent) and PSDSTSRV (Distribution Agent) both check the status of each process in the report list table - PS_CDM_LIST. An entry in this table is inserted when PSPRCSRV initiates a process with output destination type - Web, or if server definition page is setup to transfer log/trace to Report Repository. When process completes, its status in the report list table is updated to Generated indicating files are ready to be transferred to report repository.

Use the detailed diagnosis of this measure to know which processes are in the Content Generated state.

Unable_to_post Indicates the number of processes in the Not Posted state, currently. Number A non-zero value for this measure indicates that the Distribution Agent has not been able to post one/more reports to the Reports Manager.

Ideally, the value of this measure should be 0.

Use the detailed diagnosis of this measure to know which processes are in the Unable to post state.
Blocked Indicates the number of processes in the Blocked state presently. Number This is the status assigned to a new process when only one instance of that type of process can run at a time and an instance of that process is already running in the system. Once that other process completes, the next process in line would be queued. When the blocked status appears, the user should not delete the process, as the process will eventually be queued and processed in order of submission.

Use the detailed diagnosis of this measure to know which processes are in the Blocked state.

Cancelling Indicates the number of processes in the Cancel state currently. Number A process switches to this state if the user has requested to cancel its scheduling.

Use the detailed diagnosis of this measure to know which processes are in the Cancel state.

Cancelled Indicates the current number of processes in the Cancelled state. Number A process switches to this state if the server agent has successfully cancelled it.

Use the detailed diagnosis of this measure to know which processes are in the Cancelled state.
Success Indicates the current number of processes in the Success state. Number If a process is in the Success state, it indicates that the program has successfully completed.

Use the detailed diagnosis of this measure to know which processes are in the Success state.
Success_with_Warn Indicates the current number of processes in the Success with warning state. Number Ideally, the value of this measure should be 0.

Use the detailed diagnosis of this measure to know which processes are in the Success with warning state.
Not_successful Indicates the current number of processes in the Not successful state. Number If a process is in the Not Successful state, it indicates that the program encountered an error within the transaction. Not Successful is different from Error because the process is marked as restartable. Application Engine is the only delivered process type that is restartable and not all Application Engines can be restarted.

Use the detailed diagnosis of this measure to know which processes are in the Not Successful state.
Resend Indicates the current number of processes in the Resend state. Number Use the detailed diagnosis of this measure to know which processes are in the Resend state.
Restarts Indicates the current number of processes in the Restart state. Number If a process is in this state, it means that it encountered an error and is attempting to restart.

Use the detailed diagnosis of this measure to know which processes are in the Restart state.
Deletes Indicates the current number of processes in the Delete state. Number Use the detailed diagnosis of this measure to know which processes are in the Delete state.
Errors Indicates the number of processes that are currently in the Error state. Number If a process is in the Error state, it indicates that the program that is 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.

Ideally, the value of this measure should be 0.

Use the detailed diagnosis of this measure to know which processes are in the Error state.
Others Indicates the number of processes that are in states other than the ones discussed above. Number Use the detailed diagnosis of this measure to know which processes are in the Other state.