HP StorageWorks

Reference Information Manager for Databases

HP Live Archive Software

Receivables Call New Archive
and Purge
Application Pack Manual
for Oracle E-Business Suite Software

Part number: T5312-96015

First edition: January 2007
Legal and notice information
© Copyright 1997–2007 Hewlett-Packard Development Company, L.P.
Hewlett-Packard Company makes no warranty of any kind with regard to this material,
including, but not limited to, the implied warranties of merchantability and fitness for a
particular purpose. Hewlett-Packard shall not be liable for errors contained herein or for
incidental or consequential damages in connection with the furnishing, performance, or use
of this material.
This document contains proprietary information, which is protected by copyright. No part of
this document may be photocopied, reproduced, or translated into another language without
the prior written consent of Hewlett-Packard. The information is provided “as is” without
warranty of any kind and is subject to change without notice. The only warranties for HP
products and services are set forth in the express warranty statements accompanying such
products and services. Nothing herein should be construed as constituting an additional
warranty. HP shall not be liable for technical or editorial errors or omissions contained
herein.
TRADEMARKS
Intel and Itanium are trademarks or registered trademarks of Intel Corporation or its
subsidiaries in the United States and other countries.
Microsoft, Windows, Windows NT, and Windows XP are U.S. registered trademarks of
Microsoft Corporation.
Oracle is a registered U.S. trademark of Oracle Corporation, Redwood City, California.
UNIX is a registered trademark of The Open Group.
All other product, service, or company names mentioned herein are claimed as trademarks
and trade names by their respective companies including, Java, Xerces, Sybase, JFreeChart
(LGPL).

Receivables Call New Archive and Purge Application Pack Manual

Contents

Preface . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . iii
Conventions . . . . . . . . .. . .. ... ....................... iii
HP technical support . . .. . .. ... ....................... iv
HP-authorized reseller . .. . .. ... ....................... iv
Helpful web sites . . . . . .. . .. ... ....................... iv

1 Introduction to the Application Pack. . . . . . . . . . . . . . . . . . . 1

About the New AR Application Pack . . . . . . . . . . . . .. .. . .. . .. 1
Preparing the environment . . . . . . . . . . . . . . . . . . . .. .. . .. . .. 2
Evaluating Oracle open issues and patches . . . . . .. .. . .. . .. 2
Installing and configuring HP Live Archive products .. .. . .. . .. 3
Testing the Application Pack installation . . . . . . . . .. .. . .. . .. 3

2 Running the Application Pack . . . . . . . . . . . . . . . . . . . . . . . 5

Preparing to run the New AR Application Pack . . . . . . . . . . . . . . . 5
Eligibility requirements . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
Application Pack prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . 8
Running the Cash Management purge . . . . . . . . . . . . . . . . . . . 8
Verifying that AutoInvoice tables are empty. . . . . . . . . . . . . . . . 8
Verifying that Lockbox tables are empty . . . . . . . . . . . . . . . . . . 9
Verifying that QuickCash tables are empty . . . . . . . . . . . . . . . . 9
Running tax reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
Running Intrastat . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 10
Running the New AR Application Pack . . . . . . . . . . . . . . . . . . . . 11
Monitoring the HP Live Archive processes . . . . . . . . . . . . . . . . . . 12
Monitoring the Oracle processes . . . . . . . . . . . . . . . . . . . . . . . . 12
Using view concurrent requests . . . . . . . . . . . . . . . . . . . . . . . 12
Using SQL*Plus . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12

3 Technical analysis . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 13
Recommendations for improved performance . . . . . . . . . . . .. . . 13
Excluding transactions from the Oracle purge program . . .. . . 13
Enhancing performance in Application11i . . . . . . . . . . . .. . . 14
Application Pack custom action . . . . . . . . . . . . . . . . . . . . . .. . . 14

Receivables Call New Archive and Purge Application Pack Manual i

 Troubleshooting. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Checking utl_file_dir setup . . . . . . . . . . . . . . . . . . . . . . . . . . 14
ORA-01403 No data found . . . . . . . . . . . . . . . . . . . . . . . . . 15
Rejected invoice count . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
ORA-7445 error in 9i . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Journal Entries report . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 16
Restarting a failed Application Pack. . . . . . . . . . . . . . . . . . . . 16

4 Tables, forms, and reports . . . . . . . . . . . . . . . . . . . . . . . . 19

Managed tables . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19
Triggers . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 21
Affected forms and reports . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Oracle Receivables Call New Archive and Purge Program SQL . . 28

Index . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29

ii
Preface
• Conventions, page iii
• HP technical support, page iv
• HP-authorized reseller, page iv
• Helpful web sites, page iv

Conventions
Conventions used in this document include the following:

Convention Element

Medium blue text: Figure 1 Cross-reference links and e-mail addresses.

Medium blue, underlined Web site addresses.

text (http://www.hp.com)
Monospace font
• File and directory names
• System output
• Code
• Text typed at the command-line

Monospace, italic • Code variables

font • Command-line variables

Angle brackets (< >) Used to indicate variables in the code that need
to be replaced with the appropriate values
depending on environment.

Square brackets ([ ]) Used to indicate a set of values to choose from.

Ellipses (...) Used to indicate missing or deleted statements in

a code example.

Receivables Call New Archive and Purge Application Pack Manual iii
HP technical support
Telephone numbers for worldwide technical support are listed on the HP
support web site: http://www.hp.com/support/.
Collect the following information before calling:
• Technical support registration number (if applicable)
• Product model names and numbers
• Applicable error messages
• Operating system type and revision level
• Detailed, specific questions
For continuous quality improvement, calls may be recorded or monitored.
HP strongly recommends that customers sign up online using the
Subscriber's choice web site: http://www.hp.com/go/e-updates.
• Subscribing to this service provides e-mail updates on the latest
product enhancements, newest versions of drivers, and firmware
documentation updates, as well as instant access to numerous other
product resources.
• After signing up, you can quickly locate products by selecting Business
support and then Storage under Product Category.

HP-authorized reseller
For the name of your nearest HP-authorized reseller:
• In the United States, call 1-800-282-6672.
• Elsewhere, visit the HP web site: http://www.hp.com. Click Contact
HP to find locations and telephone numbers.

Helpful web sites

For other product information, see the following HP web sites:
• http://www.hp.com
• http://www.hp.com/go/storage
• http://www.hp.com/support/

iv
1 Introduction to the Application Pack
• About the New AR Application Pack, page 1
• Preparing the environment, page 2
The HP Live Archive Receivables Call New Archive and Purge Application
Pack archives data from the Oracle Receivables Application module. In
this manual, the Receivables Call New Archive and Purge Application
Pack is referred to as the New AR Application Pack.

About the New AR Application Pack

The New AR Application Pack archives Oracle Receivables transactions,
receipts, and associated information.

NOTE: Do not use the New AR Application Pack if your organization

uses cash basis accounting.

Oracle Receivables stores large quantities of historical data to maintain

audit trails. The archive feature lets you periodically save and delete
transactions to reclaim space in the OLTP database and improve system
performance. Transactions are deleted from the OLTP database based on
the parameters specified when the Application Pack is run. The archive
process removes eligible transactions and all activities relating to those
transactions such as adjustments, credits, reversals, and calls.
The selection, validation, archive, and purge processes run from the
Oracle Receivables Call New Archive and Purge program. This program
provides three levels of detail for archiving transaction information.
Because the New AR Application Pack bypasses the Oracle archive
processes, the archive level is irrelevant. Regardless of your choice, HP
Live Archive captures all the header, line, and distribution data.
The Call New Archive and Purge program:
• Can be run while other users are on the system.
• Generates a log entry as data is archived. If the data is ineligible, the
reason is printed in the log file. The preview option is not available.
• Does not need a cut-off date to be in a closed period. However, it only
archives eligible data such as data that has posted to general ledger,
closed payment schedules, and null balances.

Receivables Call New Archive and Purge Application Pack Manual 1

 • Commits after every chain of transactions. A chain includes a set of
related transactions. This requires smaller rollback segments.
• Generates a log of all transactions that are considered for archiving.
This log file is located in the directory specified in the init.ora file.

NOTE: The Oracle Receivables Call New Archive and Purge program
does not archive deposits, guarantees, miscellaneous receipts, or invoices
that are not posted to general ledger.

HP Live Archive has added an enhancement ensuring that only data

complying with your company’s data retention policy is archived. The
number of fiscal periods of data to retain is set at installation. For more
information, see ”Installing and configuring HP Live Archive products” on
page 3.
The New AR Application Pack captures data deleted from the OLTP
database, and saves the data to relocation tables. How the data in the
relocation tables is used later depends on the archiving strategy you have
chosen.

Preparing the environment

Follow the instructions in this section to configure the Application Pack
and test the Application Pack installation.

Evaluating Oracle open issues and patches

You should be aware of any issues that affect your use of this Application
Pack.
Evaluate open issues reported against the Oracle purge program by
reviewing the following:
• Oracle's Metalink web site
• Oracle’s Web Support
• Oracle’s Global Knowledge Repository
• the Technical Analysis chapter of this manual
Many of these issues are platform- or site-dependent and might not affect
your use of the purge program.
HP also recommends discussing with your implementation manager the
Oracle patches that are necessary for the proper functioning of the
Application Pack.

2 Introduction to the Application Pack

Installing and configuring HP Live Archive products
To install and configure HP Live Archive products, you need to meet all the
prerequisites and then install the products. For more information, see the
installation manual.
During the Application Pack installation, you are prompted for the
following parameter values:

Install parameter Default value

Choose to enable unwrapped purges No

Choose to seed unwrapped purges Yes

Periods to Retain 6

To prevent data loss, HP recommends that you use the default values for
the installation parameters.
These parameter values disable all Oracle Receivable purge programs
except for the Call New Archive and Purge program, and set the periods
to retain data.
Disabling the other concurrent programs protects data by ensuring that
only data captured by the Application Pack can be deleted from the OLTP
database.

Testing the Application Pack installation

Use this test to ensure the installation is successful and complete. This test
helps verify the following:
• Oracle purge concurrent programs redefined as required
• HP Live Archive concurrent programs defined as required
• Triggers created and disabled
• Relocation tables defined
To test the Application Pack installation:
1. Log in to Oracle Applications with the System Administrator
responsibility.
2. Navigate to Concurrent > Program > Define.

Receivables Call New Archive and Purge Application Pack Manual 3

 3. Query the concurrent program where the short name is ARARCALL.
4. Verify that the ARARCALL executable is OBTPA_PURGE.
5. Query the concurrent program where the short name is
OBTPA_ARARCALL.
6. Verify that the executable is ARARCALL.
7. Navigate to Concurrent > Program > Executable.
8. Query the concurrent executable OBTPA_PURGE.
9. Verify the values for the following:
• Application = Live Archive
• file = OBTPURGE
• method = Host
10. Return to SQL*Plus on the OLTP database as the APPS or OBT user.
11. Query the triggers table using the following SQL statement:
SELECT d.trigger_name, d.status
FROM dba_triggers d, obtpa_purge_tables_view v
WHERE d.trigger_name = v.trigger_name
AND v.purge_short_name = 'ARARCALL';
12. Verify that there are disabled triggers.
Disabled triggers start with the prefix “OBTPA_”.
The number of disabled triggers should match the managed tables
listed in ”Managed tables” on page 19. If you have customized the
purge program or added custom tables, the number of managed
tables in your environment might differ.
13. Query tables for relocation tables using the following SQL statement:
SELECT d.owner, d.table_name
FROM dba_tables d, obtpa_purge_tables_view o
WHERE (d.table_name = 'OBTA_'||o.table_base_name
OR d.table_name = 'OBTS_'||o.table_base_name )
AND d.owner = 'OBT_APPS_INTF'
AND o.purge_short_name = 'ARARCALL'
ORDER BY d.owner, d.table_name;
14. Verify that there are relocation tables.
Relocation tables start with the prefix “OBTA_” or “OBTS_”.
The prefix “OBTS_” is used if relocation tables for LONG columns are
created.
HP suggests that you perform thorough testing of the Application Pack.
For additional tests, see the configuration and operations manual.

4 Introduction to the Application Pack

2 Running the Application Pack
• Preparing to run the New AR Application Pack, page 5
• Application Pack prerequisites, page 8
• Running the New AR Application Pack, page 11
• Monitoring the HP Live Archive processes, page 12
• Monitoring the Oracle processes, page 12

Preparing to run the New AR Application Pack

Before running the New AR Application Pack, make sure that the criteria
in the following sections have been understood and met:

Eligibility requirements
Records of different types have different eligibility requirements.
The following sections describe what makes a record eligible to be
archived.

Transactions eligibility
The archive process removes eligible transactions and all activities
relating to those transactions such as adjustments, credits, reversals, and
calls.
For example, in the following diagram all of the transactions are
considered to be members of a single chain of related transactions. The
purge program rejects the entire chain if any member does not meet the
eligibility criteria.
Invoice A has been paid by Receipt 1, which also partially paid Invoice
B. Receipt 2 is used to pay the remainder of Invoice B. In addition,
Invoice B is applied to a commitment with Invoice C. Invoice C is paid by
Receipt 3 and a Credit Memo.

Receivables Call New Archive and Purge Application Pack Manual 5

 Transactions and all activities relating to the transactions such as
adjustments, credits, reversals, calls, sales credits, and receipts must meet
the following criteria:
• All transactions must be posted to general ledger (GL). The Oracle
Receivables Application module considers a transaction to be posted
if every record relating to the transaction has a GL Posted date. (This
does not apply to transactions that are not eligible for posting if the
Postable Only parameter is set to No.)
• Transactions applied to commitments are not eligible to be archived,
even if the commitment is closed. A commitment is considered closed
when the commitment balance (or deposit balance) is zero.
• Only closed transactions can be archived.
• If the transaction is a receipt, it must be related to transactions eligible
for archiving, unless it is a reversed unapplied receipt.
• If the transaction is a reversed unapplied receipt it cannot be related
to any transaction and is therefore eligible to archive.

6 Running the Application Pack

• If the transaction is a receipt, it must be fully applied, or unapplied
and reversed. For example, the status of the latest AR_CASH_
RECEIPT_HISTORY record must be Cleared, Risk_Eliminated, or
Reversed. Or, for Debit Memo reversals, the reversal date must have a
value.
• All transactions must meet the parameters you specify.
Following are general rules that transactions must meet to be considered
closed:

Transaction Description to close

type

Invoice Invoice balance is reduced to zero by application of

one or more of the following: cash receipts, credit
memos, approved adjustments, or deposits.

Debit Memo Debit memo balance is reduced to zero by

application of one or more of the following: cash
receipts, credit memos, or approved adjustments.

Credit Memo Credit memo balance is fully applied to one or more

of the following: invoices, debit memos,
chargebacks, or cash receipts.

Chargeback Chargeback is fully applied to either a cash receipt,

credit memo, or an approved adjustment.

Cash Receipt Receipt balance is fully applied to one or more of the

following: invoice, debit memo, credit memo,
chargeback. If the receipt was not applied but has
been reversed, it is also eligible for archive.

Adjustment Approved and applied to an invoice, debit memo, or

credit memo.

Receivables Call New Archive and Purge Application Pack Manual 7

Batch eligibility
The batch is eligible for archiving when all of the transactions associated
with it are assigned a status of archived.
Prior to a batch being archived, you can review a batch with some of the
transactions deleted. In the batch, the Partially Purged check box is
selected and the Control Totals fields in the batch appear to be out of
balance. This is because the Actual Count and Amount fields in the
Control Totals section do not include archived transaction data. Because
a batch is not considered to be part of a transaction chain, transactions
that are part of a batch can be archived even if all transactions in the
batch are not eligible to be archived.

Transactions related to Projects eligibility

By default, transactions related to Oracle Projects are not archived.
You can override this default by using the Receivables Invoice Purge client
extension. If you have used this or any other client extension, contact HP
technical support to discuss the necessary customizations.

Application Pack prerequisites

Before running the New AR Application Pack, perform the following steps
to prepare your system. These steps ensure that no important data is
deleted when running the Application Pack. Although many of the steps
are optional, all of them are recommended.

Running the Cash Management purge

If you are using Oracle Cash Management and:
• Release 11.5.10 or 11.5.10 CU2 is installed, or
• Revision 115.41 or later of the standard Oracle AR purge program
(ARPURGEB.pls) is installed
run the Cash Management purge before running the Application Pack.
This ensures that all eligible transactions are archived.
This step is required if Oracle Cash Management is used.

Verifying that AutoInvoice tables are empty

To ensure that you do not archive transactions that could be affected by
records in the AutoInvoice tables, verify that the following AutoInvoice
interface tables are empty:
• RA_INTERFACE_LINES
• RA_INTERFACE_SALESCREDITS
• RA_INTERFACE_DISTRIBUTIONS

8 Running the Application Pack

 If these tables are populated, run AutoInvoice and make sure it clears
these tables before running the Application Pack.
This step is optional.

Verifying that Lockbox tables are empty

To ensure that you do not archive transactions that could be affected by
records in the Lockbox tables, verify that the Lockbox Interim table is
empty:
• AR_PAYMENTS_INTERFACE
If this table is populated, run Submit Lockbox Validation Processing and
ensure it runs without errors before running the Application Pack.
This step is optional.

Verifying that QuickCash tables are empty

To ensure that you do not archive transactions that could be affected by
records in the QuickCash tables, verify that the following QuickCash
tables are empty:
• AR_INTERIM_CASH_RECEIPTS
• AR_INTERIM_CASH_RECEIPT_LINES
If these tables are populated, run Post QuickCash before running the
Application Pack.
This step is optional.

Running tax reports

Oracle requires that you run certain tax reports before archiving data.
With HP Live Archive, you can run tax reports at any time before or after
running the Application Pack. Pre-purge reports should be run from the
OLTP database. Depending on your archiving strategy, post-purge reports
should be run from either the archive database or the archive
responsibility.
For information about archiving strategy, see the configuration and
operations manual.

Receivables Call New Archive and Purge Application Pack Manual 9

 If tax type is Run the following (optional)

US Sales Tax • U.S. Sales Tax Report

• Sales Journal by General Ledger Account
• Miscellaneous Transactions
• Adjustments Register

VAT • The VAT Reconciliation Report

• Customers with 0 VAT or No VAT Registration
Number
• VAT Exception Report
• Miscellaneous Transactions
• Sales Journal by General Ledger Account
• Adjustments Register

This step is optional.

Running Intrastat
For European Union (EU) countries, Oracle requires running Intrastat
reports to satisfy the EU requirement to report movement statistics before
archiving data. With HP Live Archive, you can run Intrastat reports any
time before or after running the Application Pack. Pre-purge reports
should be run from the OLTP database. Depending on your archiving
strategy, post-purge reports should be run from either the archive
database or the archive responsibility.
For information about archiving strategy, see the configuration and
operations manual.
This step is optional.

10 Running the Application Pack

Running the New AR Application Pack
To run the Application Pack:
1. Log in with one of the following responsibility profiles:
• Receivables Archive and Purge
• User with equivalent privileges
2. Navigate to the Run Archive and Purge form.
3. Select Single Request in the Submit New Request window.
4. Enter Call New Archive and Purge.
The form prompts for the following parameter values:

Parameter Description of expected values

Cutoff Date Enter the cutoff date in the format DD-MON-YY. For
example, to archive all data prior to June 2006,
enter 01-JUN-06. See ”Eligibility requirements” on
page 5 for a description of the data eligible for
archive.

Archive Level Select an archive level from the QuickPick:

• Header level data
• Header and line level data
• Header, line, and distribution data
HP Live Archive archives all data regardless of your
selection in this field.

Number of Enter the number of parallel workers to run the

Standard Active delete process.
Workers
This number does not include the number of active
workers launched to handle large chains. The
maximum number of active workers for large chains
is 10 per cent of this number, and must be at least
1.

Customer Name From the list of values, select the name of the
customer to archive. Leave blank to archive all
customers.

Receivables Call New Archive and Purge Application Pack Manual 11

 5. Click Submit Request.
6. For Oracle 11i only, complete the Print Options and Run Options
regions of the window. Then select Submit to begin running the
program.
Working in the background, HP Live Archive launches the Oracle purge
program, captures the deleted data, and writes the data to relocation
tables.

Monitoring the HP Live Archive processes

Using the Console, you can monitor HP Live Archive jobs, runtime
program performance, data growth, and Live Archive configuration
parameters across all of the environments defined in the Repository. The
Job Monitor provides statistics on past and current archive processes. For
more information about your product and version of the Console or Job
Monitor, refer to the online help.

Monitoring the Oracle processes

The Oracle purge processes can be monitored in two different ways.

Using view concurrent requests

During processing of any archive and purge program run, multiple
concurrent requests are submitted. For example, if you submit the Oracle
Receivables Call New Archive and Purge program, there is a parent
request and child requests. You can monitor the progress of the purge
program by ensuring that each child request completes successfully.

Using SQL*Plus
To monitor the progress of each request, access the AR_ARCHIVE_
PURGE_LOG table using SQL*Plus.
Use the following commands to write the contents of the log table to a file
titled log.lst in the directory where you logged on to SQL*Plus as the
APPS user:
spool log
COLUMN MESSAGE format A50
select MESSAGE, TIME
from AR_ARCHIVE_PURGE_LOG;
spool off
Review the log.lst file to check the progress. If one of the concurrent
requests fails, access the log table to see the last message. This is the final
error message inserted before the program failed. Use this error to
determine the next course of action.

12 Running the Application Pack

3 Technical analysis
• Recommendations for improved performance, page 13
• Application Pack custom action, page 14
• Troubleshooting, page 14

Recommendations for improved performance

There are a number of improvements that can be made to optimize the
performance of the purge program.

Excluding transactions from the Oracle purge program

HP recommends caution when customizing the Oracle purge program,
ARPURGEB.pls.
You can enhance performance by adding additional logic to the Oracle
Call New Archive and Purge program, to exclude transactions based on
business requirements. Edit the ARPURGEB.pls file to exclude transactions
that you have previously identified as unpurgeable.
To exclude transactions:
1. Locate the following code in the Oracle ARPURGEB.pls file:
FUNCTION trx_purgeable(p_entity_id IN NUMBER) RETURN
BOOLEAN IS
allow_purge BOOLEAN := TRUE;
BEGIN
-- Place your logic here. Set the value of
allow_purge
-- to TRUE if you want this invoice to be purged, or
-- FALSE if you don't want it purged
RETURN allow_purge;
End;
2. Contact HP technical support for instructions on creating a customized
function or procedure to define the criteria you want to exclude.
3. Insert code to call the function you created.
For example, when adding a function, use the following:
FUNCTION trx_purgeable(p_entity_id IN NUMBER) RETURN
BOOLEAN IS
allow_purge BOOLEAN := TRUE;
BEGIN

Receivables Call New Archive and Purge Application Pack Manual 13

 -- Place your logic here. Set the value of
allow_purge
-- to TRUE if you want this invoice to be purged, or
-- FALSE if you don't want it purged
allow_purge := custom_function_name (p_entity_id);
RETURN allow_purge;
End;
Where custom_function_name is the custom function you created.
For more information, and to obtain sample code, contact HP technical
support.

Enhancing performance in Application11i

If you are running Oracle 11i, make sure that you check the latest Oracle
Receivables Call New Archive and Purge program patches.

Application Pack custom action

The New AR Application Pack has the following custom action:
• The ‘Clean Archive Tables AR_ARCHIVE_HEADER and
AR_ARCHIVE_DETAIL’ action deletes all rows from these Oracle
archive tables, as they are not relevant when using HP Live Archive.

Troubleshooting
Use the topics in this section to troubleshoot the Application Pack.

Checking utl_file_dir setup

Check the utl_file_dir setup to ensure the proper directories are specified.
If utl_file_dir does not have any specified directories, the following error
appears:
ORA-06510: PL/SQL: unhandled user-defined exception
ORA-06512: at "SYS
If utl_file_dir does not include the APPLPTMP environment variable, the
following error appears:
APP-00969 Program exited with status 1
APP-01126 Concurrent Manager got error running SQL*Plus
for request 231432

14 Technical analysis
 To check the utl_file_dir setup:
1. Verify the current settings using the following statement:
SELECT value
FROM v$parameter
WHERE name = 'utl_file_dir';
2. Make sure the specified directories exist and the database has access
to them.
3. If there is only a * shown, add a fully specified directory to the list.
Change the init.ora file to specify a directory path for the utl_file_dir
parameter.
The environment variables APPL_TMP, APPLTMP and APPLPTMP are
part of both the online and the concurrent job variables and must be
specified in the init.ora utl_file_dir parameter. The utl_file_dir can have
multiple directory entries that should be separated by commas.

ORA-01403 No data found

The following error message indicates there is no data available that
meets the eligibility criteria:
ORA-1403 No Data Found
Make sure the data meets the eligibility criteria. For more information, see
”Eligibility requirements” on page 5 and ”Application Pack prerequisites”
on page 8.

Rejected invoice count

Use the ar_counts script to analyze why some invoices are not archived.
The script counts the number of invoices that are rejected by the purge
program.
The purge program uses the drive_by_invoice query to create a list of
invoices selected for deletion. Each invoice is examined in order, along
with all of its related transactions, to make sure everything is eligible for
deletion. It follows chains of related transactions, checking to make sure
that all the information meets the criteria.
Run this script against the concurrent program log.
To run the rejected invoice count script:
1. Navigate to the directory that contains the ar_counts script. For
example:
cd <install_directory>/obt/appspack/oracle/la/modules/
ar_new/am/utils

Receivables Call New Archive and Purge Application Pack Manual 15

 2. Execute the ar_counts script using the following syntax:
./ar_counts.sh <path of log file>
The script displays the number of invoices rejected for each of the
following reasons:

Reason Description

Success The record meets all eligibility requirements and can

be deleted.

Rollback Something in the record chain did not meet eligibility

requirements.

Deleted by The transaction is part of a chain that was already

another reviewed and was successfully deleted.
instance

Already in The transaction is part of a chain that was already

unpurgeable reviewed and was ineligible for deletion.
transaction list

The total of these reasons should equal the total number of invoices
considered by the drive_by_invoice query.

ORA-7445 error in 9i
If you receive an ORA-7445 error on Oracle 9.2.0.2, upgrade to Oracle
9.2.0.4.

Journal Entries report

Because of a known problem in the Oracle code, you might experience
performance issues when running the Journal Entries report. For more
information, contact HP technical support.

Restarting a failed Application Pack

Because of HP Live Archive’s comprehensive restart capability, you can
restart Application Packs if they fail before completing successfully.
To restart the Application Pack:
1. Read the problem description in the program log file or from the
Console.

16 Technical analysis
2. Fix the problem.

Common errors To fix

Input parameters are invalid. Resubmit the job with the correct
parameters.

An index or table cannot get a Alter the table to increase maximum

needed extent. extents if maximum extents was
reached; add a data file; or clean up
the tablespace.

A table lock prevents the purge Wait until the job that has the lock on
program from deleting rows. the table is finished running.

3. Resubmit the purge program.

It is not necessary to clean up the Oracle archive tables
(AR_ARCHIVE_HEADER and AR_ARCHIVE_DETAIL) when restarting a
failed Application Pack. The tables are cleaned up by HP Live Archive
following a successful completion of the purge program.

Receivables Call New Archive and Purge Application Pack Manual 17

18 Technical analysis
4 Tables, forms, and reports
• Managed tables, page 19
• Triggers, page 21
• Affected forms and reports, page 22
• Oracle Receivables Call New Archive and Purge Program SQL,
page 28

Managed tables
The New AR Application Pack archives data from the following tables:

Table name 11 11i 11.5.10 &

11.5.10 CU2

AR_ACTION_NOTIFICATIONS x x x

AR_ADJUSTMENTS_ALL x x x

AR_BATCHES_ALL x x x
AR_CALL_ACTIONS x x x

AR_CASH_BASIS_DISTS_ALL x x x

AR_CASH_RECEIPTS_ALL x x x

AR_CASH_RECEIPT_HISTORY_ALL x x x

AR_CORRESPONDENCES_ALL x x x

AR_CORR_PAY_SCHED_ALL x x x

AR_CUSTOMER_CALL_TOPICS x

AR_CUSTOMER_CALL_TOPICS_ALL x x x

AR_DISTRIBUTIONS_ALL x x x

AR_MISC_CASH_DISTRIBUTIONS_ALL x x x

AR_NOTES x x x

AR_PAYMENT_SCHEDULES_ALL x x x

AR_RATE_ADJUSTMENTS_ALL x x x

AR_TRANSMISSIONS_ALL x

AR_RECEIVABLE_APPLICATIONS_ALL x x x

AX_DOCUMENT_STATUSES x x x

Receivables Call New Archive and Purge Application Pack Manual 19

 Table name 11 11i 11.5.10 &
11.5.10 CU2

AX_EVENTS x x x

RA_BATCHES_ALL x x x

RA_CUSTOMER_TRX_ALL x x x

RA_CUSTOMER_TRX_LINES_ALL x x x

RA_CUST_TRX_LINE_GL_DIST_ALL x x x

RA_CUST_TRX_LINE_SALESREPS_ALL x x x

If Multiple Reporting Currency (MRC) is configured in Oracle

Applications, data is also archived from the following tables:
• AR_MC_ADJUSTMENTS
• AR_MC_BATCHES
• AR_MC_CASH_BASIS_DISTS_ALL
• AR_MC_CASH_RECEIPT_HIST
• AR_MC_CASH_RECEIPTS
• AR_MC_DISTRIBUTIONS_ALL
• AR_MC_MISC_CASH_DISTS
• AR_MC_PAYMENT_SCHEDULES
• AR_MC_RATE_ADJUSTMENTS
• AR_MC_RECEIVABLE_APPS
• RA_MC_TRX_LINE_GL_DIS
• RA_MC_CUSTOMER_TRX
• RA_MC_BATCHES

20 Tables, forms, and reports

Triggers
HP Live Archive enables the following triggers on the managed tables
before running the Oracle purge program. These triggers are disabled
immediately after successful completion of the Oracle purge program.
Live Archive ensures that each trigger name is unique. If you install
Application Packs that share tables, the actual trigger names might vary.
For a list of the exact trigger names created in your environment, contact
HP technical support.
• OBTPA_AR_ACTION_NOTIFICATION_T
• OBTPA_AR_ADJUSTMENTS_ALL_T
• OBTPA_AR_BATCHES_ALL_T
• OBTPA_AR_CALL_ACTIONS_T
• OBTPA_AR_CASH_BASIS_DISTS_AL_T
• OBTPA_AR_CASH_RECEIPT_HISTOR_T
• OBTPA_AR_CASH_RECEIPTS_ALL_T
• OBTPA_AR_CORR_PAY_SCHED_ALL_T
• OBTPA_AR_CORRESPONDENCES_ALL_T
• OBTPA_AR_CUSTOMER_CALL_TOPIC_T
• OBTPA_AR_DISTRIBUTIONS_ALL_T
• OBTPA_AR_MC_ADJUSTMENTS_T
• OBTPA_AR_MC_BATCHES_T
• OBTPA_AR_MC_CASH_BASIS_DISTS_T
• OBTPA_AR_MC_CASH_RECEIPT_HIS_T
• OBTPA_AR_MC_CASH_RECEIPTS_T
• OBTPA_AR_MC_DISTRIBUTIONS_AL_T
• OBTPA_AR_MC_MISC_CASH_DISTS_T
• OBTPA_AR_MC_PAYMENT_SCHEDULE_T
• OBTPA_AR_MC_RATE_ADJUSTMENTS_T
• OBTPA_AR_MC_RECEIVABLE_APPS_T
• OBTPA_AR_MISC_CASH_DISTRIBUT_T
• OBTPA_AR_NOTES_T
• OBTPA_AR_PAYMENT_SCHEDULES_A_T
• OBTPA_AR_RATE_ADJUSTMENTS_AL_T
• OBTPA_AR_RECEIVABLE_APPLICAT_T

Receivables Call New Archive and Purge Application Pack Manual 21

Affected forms and reports
The reports and forms listed in this section reference the tables managed
by this Application Pack. Users of the Oracle Receivables Application can
use these forms to view the archived data. HP recommends that you
perform thorough testing of these forms and reports to ensure they
perform as expected.
AR_ACTION_NOTIFICATIONS
• ARXCCA – Call Actions Report
AR_ADJUSTMENTS
• ARXAGE – Aging 4 Bucket
• ARXBPH – Billing and Payment History
• ARXCCS – Customer Credit Snapshot
• ARXCTA – Receivables Adjustments
• ARXDKI – Receivables Key Indicators
• ARXGER – Unposted Items Report
• ARXINREV – Open Items Revaluation Report
• ARXINVAD – Audit Report by Document Number
• ARXKIR – Receivables Key Indicators – Summary
• ARXSTR – US Sales Tax Report
• ARXSTVRR – Vat Register
• ARXVATEX – Vat Exception Report
• ARXVATRN – Output VAT Reconciliation Report
• ARXVDREV – Customer Balance Revaluation Report
• RAXADJ- Adjustment Register
• RAXCBR – Commitment Balance Report
• RAXINV - Transaction Print
• RAXNCAR – Other Applications Report
AR_BATCHES
• ARXAPIPM – Invoices Awaiting Automatic Receipt
• ARXAPRCB – Automatic Receipt Batch Management Report
• ARXAPRCL - Receipts Awaiting Bank Clearance Report
• ARXAPRMB – Remittance Batch Management Report
• ARXAPRRM – Receipts Awaiting Remittance Report
• ARXCAR – Applied Payments Register

22 Tables, forms, and reports

AR_CALL_ACTIONS
• ARXCCA – Call Actions Report
• ARXCCS – Customer Credit Snapshot
AR_CASH_RECEIPTS
• ARXCRR- Payment Register
• ARXAGE – Aging 4 Buckets
AR_CASH_RECEIPTS_HISTORY
• ARXCRR – Payment Register
• ARXAGE – Aging 4 Buckets
• ARXAPIPM – Invoices Awaiting Automatic Receipt
• ARXAPRCB - Automatic Receipt Batch Management Report
• ARXAPRMB – Remittance Batch Management Report
• ARXCAR – Applied Payments Register
• ARXCCS – Customer Credit Snapshot
• ARXREV – Reversed Payments Report
• ARXNROPN – Notes Receivable Report
• ARXNRREV – Reversed Notes Receivable Report
AR_CORRESPONDENCE_ALL
• ARDLP – Dunning Letter Print
• ARXCCS – Customer Credit Snapshot
• ARXDUNH – Dunning History Report
• ARXDUNP – Dunning Letters – Preliminary
AR_CORR_PAY_SCHED_ALL
• None
AR_CUSTOMER_CALL_TOPICS_ALL
• ARXBDP – Bad Debt Provision Report
• ARXCCA – Call Actions Report
• ARXCCH – Collector Call History
• ARXCCS – Customer Credit Snapshot
• ARXCFU – Collector’s Follow Up Report
• ARXCKI – Collection Key Indicators
• ARXCPP – Payment Promises Report
• ARXDCF – Collections Receipt Forecast

Receivables Call New Archive and Purge Application Pack Manual 23

 AR_DISTRIBUTIONS_ALL
• ARXGER – Unposted Items Report
• ARXRJR – Receipt Journal Report
AR_MISC_CASH_DISTRIBUTIONS_ALL
• ARXGER – Unposted Items Report
• ARXMCR – Miscellaneous Transactions Report
• ARXVATEX – Vat Exception Report
• ARXVATRN – Output VAT Reconciliation Report
AR_NOTES
• ARXCCA – Call Actions Report
• ARXCCH – Collector Call History
• ARXCFU - Collector’s Follow Up Report
• ARXCPP - Payment Promises Report
• ARXDCF - Collections Receipt Forecast
• ARXDIR – Disputed Invoice Report
• ARXFUH – Customer Follow Up History
AR_PAYMENT_SCHEDULES_ALL
• ARXAGE – Aging – 4 Bucket Report
AR_RATE_ADJUSTMENTS_ALL
• None
AR_RECEIVABLE_APPLICATIONS_ALL
• ARXAGC – Aging – By Amount Report
• ARXAGE – Aging – 4 Bucket Report
• ARXAPFRC – Format Automatic Receipts
• ARXAPIPM - Invoices Awaiting Automatic Receipt
• ARXBPH – Billing and Payment History
• ARXCAR – Applied Payments Register
• ARXCCS – Customer Credit Snapshot
• ARXCDD – Collections By Collector Report
• ARXCPH – Receipt History
• ARXCRR – Payment Register
RA_BATCHES_ALL
• RAXINVPR – Invoice Print Preview Report

24 Tables, forms, and reports

RA_CUSTOMER_TRX_ALL
• ARBARL – Revenue Recognition
• ARDLP – Dunning Letter Print
• ARXAGE – 4 Bucket Aging
• ARXAGL – 7 Bucket Aging by Collector
• ARXAGR – 7 Bucket by Salesperson
• ARXAPFRC – Format Automatic Receipts
• ARXAPIPM – Invoices Awaiting Automatic Receipts
• ARXBPH – Billing and Receipt History
• ARXCBH – Billing History
• ARXCCA – Call Actions Report
• ARXCCH – Collector Call History
• ARXCCS – Customer Credit Snapshot
• ARXCDE – Tax Received Report
• ARXCFU – Collector’s Follow Up Report
• ARXCPH – Receipt History
• ARXCTA – Adjustment Approval Report
• ARXDAR – Discount Adjustment Report
• ARXDCF – Collections Receipt Forecast
• ARXDPR – Discount Projections Report
• ARXDUNH – Dunning History
• ARXDUNP – Dunning Letter - Preliminary
• ARXFRV – Projected Gains and Losses
• ARXFUH – Customer Follow Up HIstory
• ARXGER – Unposted Items Report
• ARXICR – Inter Company Receipts Report
• ARXINREV – Open Items Revaluation Report
• ARXINVAD – Audit Report by Document Number
• ARXKIR – Receivables Key Indicators - Summary
• ARXPDI – Past Due Invoice Report
• ARXRECO – Recurring Invoice Execution Report
• ARXSCN – Supplier Customer Netting Report
• ARXSTDVR – Deferred VAT Report
• ARXSTR – U.S. Sales Tax Report
• ARXSTVRR – VAT Register

Receivables Call New Archive and Purge Application Pack Manual 25

 • ARXTDR – Transaction Detail Report
• ARXVATEX – VAT Exception Report
• ARXVATRN – VAT Reconciliation Report
• ARXVATRV – Customer w/Invoices at 0 VAT and no VAT Reg. Number
• ARXVDREV – Customer Balance Revaluation Report
• ARYVTSLD – European Sales Listing
• ARZCARPO – Automatic Receipts/Remittances Execution Report
• RAXADJ – Adjustment Register
• RAXAVR -
• RAXCBR – Commitment Balance Report
• RAXGLR – Sales Journal by GL Account Report
• RAXICI – Inter Company Invoices Report
• RAXIIR – Incomplete Invoices Report
• RAXIKI – Key Indicators Report - Detailed
• RAXINPS – Invoices Posted to Suspense
• RAXINR – Transaction Register
• RAXINV -
• RAXNCAR – Other Applications Report
• RAXSKI – Key Indicators Report - Summary
• RAXSOL – Print a Listing of Batch Sources
• RAXSKI – Key Indicators - Summary
• RAXNCAR – Other Applications Report
• RAXINV – Transaction Print
• RAXIKI – Key Indicators – Daily Summary
RA_CUSTOMER_TRX_LINES_ALL
• ARXCCA – Call Actions Report
• ARXCDE – Tax Received Report
• ARXSTR – US Sales Tax Report
• ARXSTVRR – VAT Register
• ARXTDR – Transaction Detail Report
• RAXAVR -
• RAXCBR – Commitment Balance Report
• RAXGLA – Sales Journal By Customer
• RAXICI – Transactions where the receivable balancing segment!=
revenue balancing segment
• RAXIKI – Key Indicators – Daily Summary

26 Tables, forms, and reports

RA_CUST_TRX_LINE_GL_DIST_ALL
• ARBARL - Revenue Recognition
• ARXAGC – 7 Bucket Aging by Amount
• ARXAGE – 4 Bucket Aging
• ARXAGS – 7 Bucket Aging
• ARXAGS2 -
• ARXDAR – Discount Adjustment Report
• ARXDPR - Discount Projections Report
• ARXFRV - Projected Gains and Losses
• ARXGER - Unposted Items Report
• ARXICR – Inter Company Receipts Report
• ARXINREV - Open Items Revaluation Report
• ARXINVAD - Audit Report by Document Number
• ARXKIR - Receivables Key Indicators - Summary
• ARXRECO - Recurring Invoice Execution Report
• ARXSTDVR - Deferred VAT Report
• ARXSTR - U.S. Sales Tax Report
• ARXSTVRR - VAT Register
• ARXTDR - Transaction Detail Report
• ARXVATEX - VAT Exception Report
• ARXVATRN - VAT Reconciliation Report
• ARXVATRV - Customer w/Invoices at 0 VAT and no VAT Reg. Number
• RAXADJ - Adjustment Register
• RAXAVR -
• RAXCBR - Commitment Balance Report
• RAXGLA – Sales Journal by Customer
• RAXGLR – Sales Journal by GL Account Report
• RAXICI - Inter Company Invoices Report
• RAXIIR – Incomplete Invoices Report
• RAXIKI - Key Indicators Report - Detailed
• RAXINPS – Invoices Posted to Suspense
• RAXINR – Transaction Register

Receivables Call New Archive and Purge Application Pack Manual 27

 • RAXINX – Invoice Exception Report
• RAXNCAR – Other Applications Report
• RAXSKI – Key Indicators Report - Summary
RA_CUST_TRX_LINE_SALESREPS
• ARXTDR – Transaction Detail Report

Oracle Receivables Call New Archive and Purge

Program SQL
Refer to the purge program file.
For additional details, contact HP technical support to get the detailed
SQL statements as trace files.

28 Tables, forms, and reports

Index

A G
adjustments 6 GL Posted date 6
APPL_TMP 15 Guarantees 2
APPS user 4
ar_archive_detail 17 H
ar_archive_header 17 help, obtaining iv
AR_ARCHIVE_PURGE_LOG 12 HP
ar_counts.sh 15 authorized reseller iv
AR_INTERIM_CASH_RECEIPT_LINES 9 storage web site iv
AR_INTERIM_CASH_RECEIPTS 9 Subscriber’s choice web site iv
AR_PAYMENTS_INTERFACE 9 HP Live Archive products, installation 3
ARARCALL 4
authorized reseller, HP iv I
AutoInvoice 8 ineligible 1
init.ora 15
B install test 3
batch 8 installing HP Live Archive products 3
Intrastat reports 10
C Invoice 2, 7
calls 6
cash basis accounting 1 L
Cash Receipt 7 Lockbox 9
chain 2 Lockbox Interim 9
chain of transactions 5 log 1, 2
Chargeback 7
Clean Archive tables 14 M
client extension 8 Metalink 2
commitments 6 Miscellaneous Receipts 2
configuration parameters 12 monitor status 12
Console 12 Multiple Reporting Currency (MRC) 20
conventions iii
Credit Memo 7 N
credits 6 New AR Application Pack 1
No Data Found 15
D
data loss 3 O
data retention policy 2 OBTPA_PURGE 4
Debit Memo 7 open issues 2
Deposits 2 ORA-1403 15
disable Oracle purge programs 3
drive_by_invoice query 15

Receivables Call New Archive and Purge Application Pack Manual 29

P
patches 2
Projects 8

Q
QuickCash 9

R
RA_INTERFACE_DISTRIBUTIONS 8
RA_INTERFACE_LINES 8
RA_INTERFACE_SALESCREDITS 8
receipt 7
receipts 6
relocation tables 2, 4
Repository 12
requirements 5
responsibilities 11
reversals 6
reversed unapplied receipt 6
rollback segments 2

S
sales credits 6
selection 1
Submit Lockbox Validation Processing 9
Subscriber’s choice, HP iv

T
tax reports 9
tax type 10
test install 3
transaction chain 8
triggers 4

U
US Sales Tax 10
utl_file_dir 15

V
validation 1
VAT 10

W
web sites
HP storage iv
HP Subscriber’s choice iv

30