Running Receivables Update

Normally, you run the Receivables Update multiprocess job as a scheduled job. You can run the job ad hoc, as needed.

Note: You can also run the job immediately from an Action page for small groups under certain circumstances, such as at the end of the period when you need to update the ledger immediately.

This section provides an overview of how to restart or reset Receivables Update, lists prerequisites, and discusses how to:

View the job message log summary.
Restart the Receivables Update multiprocess job.
Reset the Receivables Update multiprocess job.

Pages Used to Run Receivables Update

Page Name	Definition Name	Navigation	Usage
Receivable Update Request	POSTING_REQUEST	select Accounts Receivable, then select Receivables Update, then select Request Receivables Update, then select Receivable Update Request	Enter run parameters for the Receivables Update multiprocess job and run the job. See also Receivable Update Request page.
Job Message Log Summary	AR_MSGSUM	select Accounts Receivable, then select Receivables Update, then select Job Message Log Summary, then select Job Message Log Summary	View a summary of messages generated by individual processes within a multiprocess job, including individual processes run in parallel, such as processes for the Receivables Update, Payment Predictor (ARPREDCT), Aging (ARAGE), and Statements (ARSTMT) multiprocess jobs.
Process List	PMN_PRCSLIST	select PeopleTools, then select Process Scheduler, then select Process Monitor, then select Process List Click Process Monitor on the Receivable Update Request page.	Review the multiple processes in a job.
Process Reset	AR_RESET	select Accounts Receivable, then select Receivables Update, then select Reset Process, then select Process Reset	Reset the Receivables Update process. Unlock and rerun the process.

Understanding How to Restart or Reset Receivables Update

Oracle suggests that you try to restart the Receivables Update multiprocess job before resetting the process. You can restart a process that has abended as a result of an environmental problem. After you have fixed the COBOL, SQL, or data problems that caused a process to abend, you can restart the process. Not all processes are restartable from this page.

Note: Remember that Receivables Update uses temporary tables. If the temporary tables have been deleted, you cannot restart (resume processing); you must reset and rerun the process from the beginning.

If you are unable to restart a process instance that has abended, you must unlock and reset the process. When a process abends because of SQL, bad data, or a missing COBOL process, some tables with data in the groups set to post under the run control ID become locked when the process instance becomes populated with the current instance.

Unlocking and resetting the process instance to zero in the locked tables unlocks the tables and enables you to rerun the process. The system also automatically deletes the PeopleSoft Application Engine run control record from the AERUNCONTROL table.

You should only unlock and reset under certain development circumstances or in expert testing environments:

When you have corrected the problem that caused the process to abend and you want to reprocess the same groups again but do not have access to restart from the server.
When you have not corrected the problem but want to continue processing.

Prerequisites

Before you can run the Receivables Update process, you must:

Set up the PeopleSoft Receivables business units (including selection of calendar and aging options).
Define the receivable processing options (system functions and entry types).
Create groups for pending items, payment worksheets, maintenance worksheets, drafts, or direct debits.
Set up system-defined history IDs.
If you want to run Receivables Update immediately from an action page, you must:
- Define processing options for your organization on the On Demand Processing page.
- Define the processing options for each user on the Define User Preferences - Process Group page.
  
  You must define separate options for each of these source transactions: ARMNTWS (maintenance worksheet), ARITSPLT (item splits), AROPIE (online pending items), ARPAYWS (payment worksheet), ARTRNWS (transfer worksheet), ARUNPOST (unpost transactions).

Your system must also have pending items that are ready to post. These pending items can be entered online, created by a billing interface, or created during payment processing, draft processing, direct-debit processing, overdue charge processing, or during item maintenance activities.

Job Message Log Summary Page

Use the Job Message Log Summary page (AR_MSGSUM) to view a summary of messages generated by individual processes within a multiprocess job, including individual processes run in parallel, such as processes for the Receivables Update, Payment Predictor (ARPREDCT), Aging (ARAGE), and Statements (ARSTMT) multiprocess jobs.

Navigation

select Accounts Receivable, then select Receivables Update, then select Job Message Log Summary, then select Job Message Log Summary

Process Instance

Displays the process instance number for the multiprocess job.

Process Run Status

Displays the status of the multiprocess job, such as No Success or Success.

Instance

Displays the process instance number for the individual process. For example, the ARUPDATE multiprocess job with a process instance number of 510 will have several instances, such as instance number 511 for the AR_UPDATE process, instance number 512 for the AR_PGG1 process, and instance number 514 for the AR_POST1 process.

Process

Displays the name of the individual process within the multiprocess job. For example, for the ARUPDATE multiprocess job, it would display rows for the AR_UPDATE, AR_PGG1, and AR_POST1 processes.

Restarting the Receivables Update Multiprocess Job

Use the Process List page (PMN_PRCSLIST) to review the multiple processes in a job.

Navigation

select PeopleTools, then select Process Scheduler, then select Process Monitor, then select Process List
Click Process Monitor on the Receivable Update Request page.

Because Receivables Update is a job (a collection of multiple processes), you may need to restart multiple processes. Find the processes that you need to restart.

Details

Click to access the Process Detail page, and select Restart Request.

Resetting the Receivables Update Multiprocess Job

Use the Process Reset page (AR_RESET) to reset the Receivables Update process.

Unlock and rerun the process.

Navigation

select Accounts Receivable, then select Receivables Update, then select Reset Process, then select Process Reset

Enter your search criteria for the process instance and click Refresh.

In the Not Successful Process Requests grid, select the process instance that you want to reset.

Reset

Click to unlock and reset the process instance.

After the process instance is reset, you can rerun the process.