4/13/2016

Document1489381.1

EBSPayablesPeriodCloseAnalyzer(DocID1489381.1)
InthisDocument
MainContent
Purpose
DownloadtheLatestVersion
RunningtheAnalyzerConfiguration/Setup/Execution

Parameters

RuntheAnalyzerviaSQL*Plus

RuntheAnalyzerasaConcurrentRequest

Analyzer&SampleOutput

KnownIssues&Solutions

Questions,Comments&Feedback
RelatedResources

BestPracticesforPayablesPeriodClose

EBSAnalyzerBundleMenuTool

References

APPLIESTO:
OraclePayablesVersion12.0.0andlater
Informationinthisdocumentappliestoanyplatform.

MAINCONTENT

DownloadtheEBSPayablesPeriodCloseAnalyzerLatestversion(200.8)

PURPOSE
AnalyzersaredesignedbySupporttoproactivelyassistyoutobetterdiagnoseandmaintainyourOracle
Applicationenvironments.WewelcomeandencourageyoutoshareyourfeedbackviathePayables
PeriodCloseAnalyzerfeedbackthreadintheMyOracleSupportPayablesCommunity.Yourfeedback
shapesthecontentofexistingAnalyzersanddrivescreationofnewAnalyzers.
Theanalyzerisaselfservicehealthcheckscriptthathelpsidentifytransactionswhichmaystopthe
periodclosewithinyourPayablesapplication.
Inaddition,youcanalsorunthedatavalidationreporttocheckfordataintegrityissuesinthatperiod.
Thiswillhelpyouinresolvingtheperiodcloseshowstoppersandkeepingyoursystemreadyforperiod
closewithoutmissinganydeadlines.
YoushouldalwaysrunthisscriptpriortologgingaServiceRequestwhenyouarenotabletoclosethe
periodorifyousimplywanttoproactivelyverifythedataintegrityofyourtransactionstokeepthe
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrlstate=hq9w4i5ml_232&id=1489381.1

1/7

4/13/2016

Document1489381.1

systemreadyforperiodclose.
Yourapplicationdataisnotalteredinanywaywhenyourunthisanalyzer.
ThisisanoninvasivescripttheAnalyzerdoesnotperformanyINSERTs,UPDATEsor
DELETEstoyourdataitjustreportsonit.
TheAnalyzeridentifiesknownissuesandprovidessolutionsandrecommendedactionstobe
performedforthespecificinstanceitwasrunonandcanberunatanytime.
Forproductioninstances,youshouldfirstapplyanyrecommendedactionsorsolutionstoarecent
clonetoensureanexpectedoutcome.

Audience
DBAsandSystemAdministratorsrunthescriptandreviewtheoutput
ProductSpecialistsandBusinessAnalystsreviewtheoutput
Otherinterestedparties/endusersreviewoutputtoresolveidentifiedopportunityimprovement
areas
ThisscriptisdesignedforOracleApplicationsRelease12andrequires
APPSAccess(SQL*Plus)
Filesystemaccess(appslogfiles)$APPLCSF/$APPLLOG
SYSADMINaccesspermissions

Benefits
Executeanalysisanytimetocomparetrendingfrompastoutputs
AnalyzersarealsousedasdatacollectiontoolsbySupportEngineers
IMPORTANT:Inconjunctionwiththeanalyzerdescribedinthisnote,R12.1customersshould
reviewthenotesindicatedbelowwhichdescribetheRecommendedPatchCollections(RPC)for
relatedproducts.Thevastmajorityofthedataintegrityissuesdetectedbythisanalyzercouldbe
proactivelyavoidedbyapplyingtheRPC'sfortheseproducts:
DocID1397581.1:R12.1:PayablesRecommendedPatchCollection(APRPC)
DocID1481235.1:R12.1:EBusinessTaxRecommendedPatchCollection(ZXRPC)
DocID1481221.1:R12.1:PaymentsRecommendedPatchCollection(IBYRPC)
DocID1481222.1:R12.1:SubLedgerAccounting(SLA)RecommendedPatchCollection(XLARPC)
BacktoTop
DOWNLOADTHELATESTVERSION

DownloadtheEBSPayablesPeriodCloseAnalyzerLatestversion
(200.8)

Analyzersareregularlyupdatedtoincludenewlyidentifiedissuesandsolutions,sowerecommend
alwaysusingthelatestversion.ToverifytheversionofapreviouslydownloadedAnalyzer:
Unzipthefileintoalocaldirectory,itcontainsthepackagedefinitionfile
ap_period_close_analyzer.sqlaswellasawrapperscript(ap_period_close_analyze.sql)
whichcanbeusedtosubmitthedetectionprocedures.
IfyouwanttoruntheAPDataValidationReportalsotocheckfordatacorruptionsandthe
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrlstate=hq9w4i5ml_232&id=1489381.1

2/7

4/13/2016

Document1489381.1

correspondingGDFsavailable,pleasedownload:
ap_gdf_detect_pkg.zip:Thisfilecontainsthepackagedefinition
fileap_gdf_detect_pkg.sql.
ExecutetheanalyzerandreviewtheExecutionDetailssectioninthegeneratedoutputHTMLfile.
Alternatively,youcanfindtheanalyzerversionintheexecutablepackageusingfollowingsql
statement:
Selectname,textfromdba_source

Wherenamein('AP_PCLOSE_ANALYZER_PKG')andtextlike'%$Id%'

Wanttobenotifiedviaemailwhenthisdocumentisupdated?CheckouttheEnablingHot
TopicssectionundertheJusttheFactstabofDocID793436.2(MyOracleSupportHowtoSeries:
HowtouseHotTopicsEmailnotificationtosubscribetoSupportProductNews,SRs,Bugs,etc.and
eventssothatyouNeverMissanImportantUpdate[VIDEO])
BacktoTop
RUNNINGTHEANALYZERCONFIGURATION/SETUP/EXECUTION

ThePayablesPeriodCloseAnalyzercanberunviaSQL*PlusorasaConcurrentRequest.
Parameters
LedgerID:(REQUIRED)TheledgerIDofthePayablesperiodwhichyouaretrying
toclose.
PeriodName:(REQUIRED)TheperiodnameofthePayablesperiodwhichyouare
tryingtoclose.Thisiscasesensitiveandmustbeanopenperiodfortheledger
specified.
OperatingUnit:(OPTIONAL)Anyoperatingunitorganizationid,inwhichPayables
hasbeenimplemented,canbeprovided.Transactionstobevalidatedwillbelimited
totheoperatingunit(s)specified.Multipleoperatingunitscanbeprovidedsimplyas
acommaseparatedlist.Whenlargevolumesofdataareinvolved,itisadvisableto
limittheamountofdatatobevalidatedusingthisparameter.Alloperatingunits
specifiedmustbeassociatedwiththeledgeridentifiedwiththep_ledger_id
APDataValidationReport:(OPTIONAL)Ayesornovaluetoindicateifyou
wouldliketoruntheAPDataValidationReportalsotocheckformorecorruptions
andknownGDFsavailablefortheparticularperiod,ledger,andoperatingunits
specified.
MaximumNumberofRows:(DEFAULTof10)Anumbervaluetoindicatethe
maximumnumberoftransactionstodisplayforanyparticulardatavalidation.Use
thisnumbertocontrolthepotentialsizeoftheoutputfileiftherearevalidations
whichreturnmanyinstances.
RuntheAnalyzerviaSQL*Plus
1.ExecutethescriptsasuserAPPStocreatethepackagedefinitions.
Thisisrequiredeachtimeyoudownloadanewversionofthescript.
sqlplusapps/<apps_password>
SQL>@ap_period_close_analyzer.sql
SQL>@ap_gdf_detect_pkg.sql

https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrlstate=hq9w4i5ml_232&id=1489381.1

3/7

4/13/2016

Document1489381.1

2.Runthewrapperscriptap_period_close_analyze.sql
Tovalidateallinvoices,payments,inaspecifiedperiodforspecifiedoperatingunits,
runap_pc_analyze.sqlasillustratedbelow.
Thisscriptwillpromptyoufortheperiodname,ledgerid,operatingunit(or
operatingunits),andoptiontocheckwhetheryouwanttorunthedatavalidation
reportalsowiththistocheckfordatacorruptions.
Periodshouldbeopenforwhichtheanalyzerisrun.Also,theledgeridforwhich
theperiodisclosedshouldbespecified.Toindicatemorethanoneoperatingunit,
separatevalueswithacomma.Ifoperatingunitisleftblanktheprocesswillrun
foralloperatingunits(thoughthisisgenerallynotrecommendedforperformance
reasons).
IfAPDataValidationReportissettoY,thentheprocesswillsubmitthemaster
GDFreportalso.(thoughthisisgenerallynotrecommendedforperformance
reasons).

Foradditionalflexibility,theprocesscanalsobecalledwithoutrunningthewrapper
scriptaswell.Thereportisrunbyexecutingtheprocedure
AP_CLOSE_DETECT_PKG.MAIN_PCwiththeappropriateparameters.Seebelowfor
adetailedlistingoftheprocedure'sparametersandtheirusage.Herearesome
executionexamples:
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrlstate=hq9w4i5ml_232&id=1489381.1

4/7

4/13/2016

Document1489381.1

SQL>setserveroutputonsize1000000
Inordertocheckalltransactionsstoppingperiodcloseforaparticularperiodyou
couldsimplyrun:
SQL>BEGIN

ap_pclose_analyzer_pkg.main_pc(

p_per_name=>'<period_name>',
p_ledger_id=><ledger_id>)

END

/
Tovalidatealltransactionsforoneofyouroperatingunits(org1)youcouldrun:
SQL>BEGIN

ap_pclose_analyzer_pkg.main_pc(

p_per_name=>'<period_name>',

p_ledger_id=><ledger_id>,

p_org_ids=>'<org_id>')

END

/
Torunthesamevalidationsbutincludingbothorg1andorg2youcouldrun:
SQL>BEGIN

ap_pclose_analyzer_pkg.main_pc(

p_per_name=>'<period_name>',

p_ledger_id=><ledger_id>,

p_org_ids=>'<org1_id>,<org2_id>')

END

/
ToruntheanalyzeralongwiththeAPDataValidationReporttocheckformore
corruptionsyoucouldrun:
SQL>BEGIN

ap_gdf_detect_pkg.main_pc(

p_per_name=>'<period_name>',

p_ledger_id=><ledger_id>,

p_master_gdf=>'Y')

END

RuntheAnalyzerasaConcurrentRequest
Runningthe'PayablesPeriodCloseAnalyzer'asaconcurrentrequestallows
functionaluserstoruntheanalyzerwithoutneedingtheAPPSuserpassword.
1.ExecutethescriptsasuserAPPStocreatethepackagedefinitions.
Thisisrequiredeachtimeyoudownloadanewversionofthescript.
sqlplusapps/<apps_password>

SQL>@ap_period_close_analyzer.sql

https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrlstate=hq9w4i5ml_232&id=1489381.1

5/7

4/13/2016

Document1489381.1

SQL>@ap_gdf_detect_pkg.sql
2.IfyouwouldliketoruntheAnalyzerasaconcurrentprogramsoitcanberun
periodicallyorasaconcurrentrequestfromconcurrentmanager,pleasereviewDocument
ID1489916.1.

BacktoTop
ANALYZER&SAMPLEOUTPUT
ThePayablesPeriodCloseAnalyzergeneratesanhtmlreportoutputthatmakesreviewing
theoutputeasyandeffective.Wheretheoutputisstoredisdependentonhowthereportwasrun.
AP_PCLOSE_Analyzer_<machine>_<sid>_<date>.html
AP_PCLOSE_Analyzer_<machine>_<sid>_<date>.log
IftheAnalyzerisrunasaconcurrentrequest:
NavigatetoView>RequestsandchoosetheViewOutputbutton.
Tosavetheoutput,selectFile>SavePageAsthenchoose'WebPage,HTMLonly'forthe
'Saveastype'.
Theoutputisalsoavailableonyourserverat$APPLCSF/$APPLOUT/o<REQUEST_ID>.outandcan
becopied&renamedto<meaningful_filename>.html

IftheAnalyzerisrunfromSQL*Plus:
ThelocationofyouroutputfilewillbedisplayedintheSQL*Pluswindowafterexecution.

ClickthebuttonbelowtoviewasampleoutputofthePayablesPeriodCloseAnalyzer:

BacktoTop
KnownIssues&Solutions
SeeDocID2116869.1forallknownproblemswithanalyzersingeneral.
BacktoTop
QUESTIONS,COMMENTS&FEEDBACK

Stillhavequestions,orsuggestions?

ClickthebuttonabovetoprovidefeedbackforthePayablesPeriodCloseAnalyzer,and
offersuggestions,improvements,orideasonhowtomakethisproactivescriptmore
https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrlstate=hq9w4i5ml_232&id=1489381.1

6/7

4/13/2016

Document1489381.1

useful.
TosearchforsolutionsorpostnewquestionsaboutPayablesingeneral,clickheretoaccessthe
PayablesCommunityonMyOracleSupportCommunity(MOSC).
BacktoTop
RELATEDRESOURCES

CheckoutthefulllistofOracleEBusinessSuite(EBS)ProactiveSupport
AnalyzersandTools
DocID1360390.1R12:MasterGDFDiagnostic(MGD)toValidateDataRelatedtoInvoices,
Payments,Accounting,SuppliersandEBTax[VIDEO]
DocID874903.1R12:WhatisaGenericDatafixPatch(GDF)andwhatGDFsareavailablefor
Payables?[VIDEO]
DocID1491064.1GetProactiveInstructionalWebcastSeries
BestPracticesforPayablesPeriodClose
Title
Resolve
Best
Practicesfor
EBusiness
Suite
Payables
PeriodClose

Description
Thisonehourwebcastwillshowyouhowtotakeadvantage
ofthreeprimaryrecommendations:MasterGenericData
fixes,recommendedPatchCollectionsandPeriodClose
Analyzerforcorruption/noncorruptionissues.Customers
whoareinvolvedinthePayablesPeriodCloseactivities
(TechnicalandFunctional)willbenefitmostfromthis
webcast.

Recording&
PDF

Recording|PDF

EBSAnalyzerBundleMenuTool
TheEBSAnalyzerBundleMenuTool(DocID1939637.1)allowsyoutoprovisionandmaintainallyour
Analyzers.TheAnalyzerBundleMenuToolisaPerlmenusystemthatenablesyoutoeasilyexecute,
updateandinstallAnalyzersasconcurrentprogramsandassignthemtorequestgroups.
ThetoolisupdatedmonthlytoincludenewlyreleasedandupdatedEBSAnalyzers.Foracompletelistof
EBSAnalyzerscurrentlyincludedintheEBSAnalyzerBundleMenuTool,seetheChangeLogfor
BundleZipsectionofEBusinessSuiteSupportAnalyzerBundleMenuTool(DocID1939637.1)
BacktoTop
Didn'tfindwhatyouarelookingfor?

https://support.oracle.com/epmos/faces/DocumentDisplay?_adf.ctrlstate=hq9w4i5ml_232&id=1489381.1

7/7