AD Utility PDF

Oracle E-Business Suite Maintenance Utilities
Rele a se 1 2.1
P ar t Nu m be r E 1 3 6 7 6-0 3 Co n te n Previo u Next
Maintenance
Thi s c h a p te r di sc u s se s t he AD u tilities de signe d to h elp yo u pe rfor m t he ro u ti ne
m ai n te n a n ce t a s k s t h a t will h elp e n s u re t h a t yo u r Or acle E-B u si ne s s S uite sys te m
Thi s c h a p te r cover s t he following to pic s:
• Abo u t Syste m Mai n te n a n ce
• AD Admi ni st r a tio n Overview
• R u n ni ng AD Admi nist r a tio n Inte r ac tively
• Ge ner a ti ng Applicatio n s Files
• Mai n t ai ni ng Applicatio n s Files
• Ma n agi ng D a t a b a se E n tities
• U si ng Mai n te n a n ce Mode
• U si ng AD Relin k
• Relin ki ng AD Exec u t a ble s
About System Maintenance

After yo u r sys te m is in s t alled, it will be n ece s s a ry to pe rfor m cert ai n m ai n te n a n ce
t a s k s to kee p it r u n ni ng s m oot hly. For exa m ple, yo u will ge ne r a te for m files, m ai n t ai n
s n a p s ho t infor m a tio n, relin k exec u t a ble s, co m pile or valid ate t he APPS sc he m a, a n d
so o n. So me t a s k s a re ro u ti ne a n d s ho uld be pe rfor me d o n a reg ul a r b a si s. Ot he r t a s k s
Yo u r u n m ai n te n a n ce t a s k s fro m t he co m m a n d line u si ng AD Admi ni st r a tio n. O nce
yo u s t a r t t hi s u tility, it p re se n t s t he t a s k s in m e n u for m, gro u pe d ge ne r ally by type of
a c tivity yo u will pe rfor m. For exa m ple, t he t a s k s a s sociate d wit h co m piling a n d
reloa di ng Applic atio n s d a t a b a se e n titie s a re gro u pe d o n t he s a m e m e n u .
In a d ditio n to t he AD Admi ni str a tio n m ai n te n a n ce t a s k s, t hi s c h a p te r de sc ribe s AD
Relin k, a co m m a n d line u tility u s e d to relin k AD exec u t a ble s.
Important: Yo u cannot relin k AD u tilities exec u t a ble s u si ng AD Admi ni st r a tio n.
AD Administration Overview
AD Admi nis tr a tio n m a n age s m o s t of t he m ai n te n a n ce t a s k s req uire d for yo u r Or acle
E-B u si ne s s S uite sys te m. C u r re n tly, t he se m ai n te n a n ce t a s k s a re gro u pe d by type s
Whe n yo u s t a r t AD Admi ni str a tio n fro m t he co m m a n d line, it p ro m p t s yo u for t he
b a sic sy s te m -s pecific infor m a tio n it n ee d s. For exa m ple, yo u n ee d to s u p ply a n a m e
for t he log file w here p roce s si ng ac tio n s a n d error m e s s age s will be recorde d.
Note: For m o re infor m a tio n, see Pro m p t s in C h a p te r 1.
O nce yo u re s po n d to t he se p ro m p t s, AD Admi ni str a tio n di s pl ays t he m ai n m e n u ,
w hic h se rve s a s t he gatew ay to vario u s s u b m e n u s w he re yo u select t he in divid u al
m ai n te n a n ce t a s k s. For exa m ple, o n t he Ge ne r a te Applic atio n s File s m e n u , yo u c a n
r u n t a s k s t h a t ge ner a te m e s s age files, for m s files, re port files, m e s s age files, or
p ro d u c t JAR files. The se s u b m e n u t a s k s m ay al so req uire yo u to re s po n d to p ro m p t s
to collect t a s k-s pecific infor m a tio n. For exa m ple, so m e t a s k s req uire yo u to e n ter t he
n u m b e r of worke r s yo u wa n t to e m ploy to p roce s s t he job s a s sociate d wit h t he t a s k.
Note: For m o re infor m a tio n, see Proce s si ng Ta s k s in P ar allel in C h a p te r 1.
Whe n yo u re s po n d to AD Admi ni st r a tio n p ro m p t s, yo u a re r u n ni ng t he u tility
inte r ac tively. Howeve r, like AutoP a tc h a n d AD Co n t rolle r, yo u c a n al so r u n AD
Admi ni str a tio n n o n -inter ac tively, s pecifying a p revio u sly cre a te d defa ult s file t h a t
co n t ai n s t he infor m a tio n n ece s s a ry to r u n a s pecific m ai n te n a n ce t a s k wit ho u t u s e r
inte rve n tio n.
Note: For m o re infor m a tio n, see Inter ac tive a n d Non-Inte r ac tive Proce s si ng in C h a p te r
1.
Prompts
In a d ditio n to t he b a sic p ro m p t s de sc ribe d in C h a p te r 1, AD Admi ni str a tio n m ay
req uire a d ditio n al infor m a tio n t h a t is s pecific to o ne of t he s u b m e n u t a s k s. If so, it
di s plays a d ditio n al p ro m p t s. For exa m ple, w he n r u n ni ng t he Ge ner a te Prod u c t JAR
files t a s k fro m t he Ge ne r a te Applic atio n s File s m e n u , AD Admi ni st r a tio n p ro m p t s yo u
a s follows:
Do you wish to force generation of all jar files? [No]:
The t a s k-s pecific p ro m p t s a re de sc ribe d m o re fully in t he di sc u s sio n of e ac h t a s k.
Preparing for Non-Interactive Processing

The di sc u s sio n of co m m a n d line p ro m p t s a s s u m e s yo u a re r u n ni ng AD
Admi ni str a tio n inter ac tively. Yo u re s po n d to t he s t a n d a r d p ro m p t s a n d t ho se req uire d
for s pecific t a s k s yo u c hoo se fro m t he AD m ai n m e n u a n d s u b m e n u s . AD
Admi ni str a tio n c a n al so r u n so m e t a s k s n o n -inter ac tively by u si ng t he infor m a tio n
yo u s tore in a defa ult s file, in s te a d of req uiri ng yo u to re s po n d to p ro m p t s.
Note: For m o re infor m a tio n, see Inter ac tive a n d Non-Inte r ac tive Proce s si ng in C h a p te r
1 . Also see Sc he d uli ng Non-In te r ac tive Mai n te n a n ce in Oracle E-Business Suite
Maintenance Procedures.
Specifying a Menu Option in the AD Administration Defaults File

The s a m e defa ult s file c a n be u s e d to r u n differe n t AD Admi nist r a tio n t a s k s a si ngle
file c a n co n t ai n all yo u r c hoice s for t he differe n t m e n u optio n s. In orde r to c hoo se
w hic h t a s k t he defa ult s file will r u n , yo u a d d m e n u_optio n= <me n u c hoice> to t he
u tility s t a r t co m m a n d. Thi s override s a n y m e n u - s pecific key s t ro ke infor m a tio n s to re d
in t he defa ult s file initially, a n d allow s yo u to u s e t he defa ult s file for a ny of t he AD
Admi ni str a tio n m e n u ite m s. It al so e n s u re s t h a t t he m e n u optio n yo u inte n de d for t he
defa ult s file is alw ays valid, eve n if t he m e n u ite m s a re re n u m b e re d or reloc ate d in
s u b s eq u e n t rele a se s.
Defa ult s File m e n u_optio n Val u e s
menu_option Value Corresponding AD Administration Menu Choice
GEN_MESSAGES Ge ne r a te m e s s age files
GEN_FORMS Ge ne r a te for m files
GEN_REPO RTS Ge ne r a te re port s files
GEN_ JARS Ge ne r a te p ro d u c t JAR files
RELINK Relin k Applic atio n s p rogr a m s
COPY_FILES Copy files to de s ti n a tio n s
CONVERT_CHARSET Co nvert c h a r ac ter s e t
SCAN_APPLTOP Sc a n t he APPL_TOP for exceptio n s
SCAN_CUSTOM_DIR Sc a n a CUSTOM directory for exceptio n s
LIST_SNAPSHOT List s n a p s ho t s
UPDATE_CURRENT_VIE Upd a te c u r re n t view s n a p s ho t
W
CREATE_SNAPSHOT Cre a te n a m e d s n a p s ho t
EXPORT_SNAPSHOT Export s n a p s ho t to file
IMPORT_SNAPSHOT Im port s n a p s ho t fro m file
DELETE_SNAPSHOT Delete n a m e d s n a p s ho t
CHECK_FILES C hec k for mi s si ng files
CMP_INVALID Co m pile APPS sc he m a
CMP_MENU Co m pile m e n u infor m a tio n
CMP_FLEXFIELDS Co m pile flexfield d a t a in AOL t a ble s
RELOAD_ JARS Reloa d JAR files to d a t a b a s e
VALIDATE_APPS Valid a te APPS sc he m a
CREATE_GRANTS Recre a te gr a n t s a n d sy no ny m s for APPS
sc he m a
MAINTAIN_MLS Mai n t ai n m u lti-ling u al t a ble s
CHECK_DUAL C hec k DUAL t a ble
ENABLE_MAINT_MODE E n a ble Mai n te n a n ce Mode
DISABLE_MAINT_MODE Dis a ble Mai n te n a n ce Mode
The AD Administration Interface

Yo u s t a r t AD Admi nis tr a tio n fro m t he co m m a n d line. Howeve r, all m ai n te n a n ce t a s k s
a re initiate d fro m t he AD Admi ni st r a tio n Mai n Me n u . This sec tio n de sc ribe s so me of
t he co m mo n feat u re s u s e d to r u n t hi s u tility.
Main Menu
After yo u s t a r t AD Admi nist r a tio n a n d re s po n d to t he p ro m p t s, t he AD Admi ni st r a tio n
Mai n Me n u a p pe a r s.
AD Administration Main Menu
Thi s m e n u di s pl ays t he s u b m e n u s w he re t he in divid u al m ai n te n a n ce t a s k s a re

gro u pe d. To c hoo se a s u b m e n u , type t he n u m be r of t he m e n u a t t he p ro m p t. To exit
AD Admi nis tr a tio n, p re s s [Ret u r n].
Available Options
De pe n di ng o n yo u r sy s te m co nfigu r a tio n, t he s u b m e n u s for AD Admi ni st r a tio n m ay
s how slightly differe n t optio n n a m e s a n d n u m be r s fro m t he o ne s di s pl ayed h e re.
Running AD Administration Interactively

Co m plete t he s te p s in t hi s sec tio n to di s play t he AD Admi nist r a tio n Mai n Me n u a n d
a cce s s t he s u b m e n u s a n d t he m ai n te n a n ce t a s k s.
1. Set t he e nviro n m e n t.
Yo u m u s t se t t he e nviro n m e n t in order to a p ply t he e nviro n m e n t vari a ble s t h a t
define yo u r sy s te m . Thi s t a s k is co m mo n to m a ny AD u tilities. See Setti ng t he
E nviro n m e n t in C h a p te r 1 for t he b a sic s te p s.
2. Fro m a ny directory, s t a r t AD Admi nis tr a tio n wit h t hi s co m m a n d:
$ adadmin
The u tility s t a r t s a n d di s pl ays t he first p ro m p t.

3. Re s po n d to p ro m p t s.
S u p ply t he infor m a tio n req u e s te d by t he AD Admi nist r a tio n p ro m p t s. The b a sic
AD co m m a n d line p ro m p t s a re de sc ribe d in C h a p te r 1 . Pro m p t s t h a t a re u niq u e
to optio n s a re de sc ribe d in t hi s c h a p te r in t he sec tio n t h a t de sc ribe s t he optio n.
Whe n yo u co m plete t he p ro m p t s, t he Mai n Me n u a p pe a r s.
4. C hoo se m ai n te n a n ce t a s k s.
O n t he Mai n Me n u , c hoo se a s u b m e n u . The s u b m e n u s a n d t he optio n s t hey
di s pl ay a re de sc ribe d fully begi n ni ng wit h Ge ner a te Applicatio n s Files in t he
n ext sectio n.
5. Exit AD Admi nist r a tio n.
Yo u c a n exit AD Admi ni str a tio n fro m t he Mai n Me n u by c hoo si ng optio n 6 (Exit
AD Admi ni st r a tio n) a t t he sc ree n p ro m p t. Yo u c a n al so c hoo se to exit t he u tility
a t a n y p ro m p t by typi ng a bo rt o n t he co m m a n d line. See Re st a r t File s in
C h a p te r 1 for infor m a tio n a bo u t re s t a r ti ng AD u tilities after u si ng t he a bo rt
co m m a n d.
Generating Applications Files

Yo u m ay n ee d to ge ne r a te Applicatio n s files fro m ti me to ti me d u ri ng yo u r Applic atio n s
life cycle. Yo u acce s s t he a s sociate d t a s k s fro m t he Ge ner a te Applicatio n s Files m e n u .
Generate Applications Files Menu
If sys te m u s e r s a re h avi ng diffic ulty acce s si ng m e s s age s, for m s, or re port s, yo u m ay be

a ble to re solve t he is s u e by ge ne r a ti ng t he a s sociate d files. O r, w he n yo u a p ply a p a tc h
t h a t a d d s or c h a nge s p ro d u c t fu nc tio n ality, yo u m ay wa n t to ge ner a te t he a s sociate d
files after yo u a p ply t he p a tc h, in s te a d of r u n ni ng t he ge ner a te d river d u ri ng t he
p a tc hi ng dow n ti me. The Ge ne r a te Files t a s k s m ay be pe rfor me d o n a n y se rve r, a s
req uire d.
Yo u do n o t h ave to s h u t dow n yo u r sy s te m to ge ner a te files. Howeve r, u s e r s t h a t
a cce s s t he files bei ng ge ner a te d (for exa m ple, for H u m a n Re so u rce s for m s) m u s t log
off.
Note: For m o re infor m a tio n, see Ge ne r a ti ng Prod u c t File s in Oracle E-Business Suite
Generate Message Files

Or acle E-B u si ne s s S uite u s e s files to di s pl ay m e s s age s. This t a s k ge ne r a te s bi n a ry
m e s s age files (exte n sio n . m s b) fro m Or acle Applic atio n O bject Libr a ry t a ble s.
Caution: R u n t hi s t a s k o nly w he n in s tr u c te d to do so in a p a tc h re a d m e file, or by
Or acle S u p port Se rvice s.
Generate Form and Report Files

The se a c tivitie s a re c a rried o u t in m u c h t he s a m e w ay.
• Generate forms files
Ge ner a te s exec u t a ble Or acle for m s files (exte n sio n .fmx) fro m t he bi n a ry for m s
definitio n files (exte n sio n .fm b). The definitio n files a re loc ate d u n d e r AU_TO P,
a n d t he exec u t a ble files a re s tore d u n de r e ac h p ro d u c t’s directory.
• Generate report files
Ge ner a te s t he bi n a ry Or acle Report s re port files (exte n sio n .rdf).
The p ro m p t s a n d be h avior work in si milar fas hio n, exce pt a s n o te d:
• Ask for t he n u m b e r of worke r s a n d ge ner a te selecte d object s for selecte d
p ro d u c t s in p a r allel
• Dis play t he c u r re n t c h a r ac ter se t (fro m NLS_LANG) a n d a s k if yo u wa n t to
ge ner a te for m or re port object s in t hi s c h a r ac te r se t
• Ask if yo u wa n t to rege ne r a te Or acle For m s PL / S QL libr a ry files, m e n u files, a n d
exec u t a ble files (for m s files o nly)
• Ask for t he p ro d u c t s a s sociate d wit h t he for m or re port object s
• Ask if yo u wa n t to ge ne r a te s pecific for m or re port object s for e ac h s electe d
p ro d u c t
• Dis play t he c u r re n t s e t of in s t alled la ng u age s a n d a s k if yo u w a n t to ge ner a te
for m or re port files in t he se la ng u age s
• Cre a te a list of all object s to ge ner a te
• Dis play t he list of object s to be ge ne r a te d (specific object s or all object s)
Generate Product JAR Files

Ge ne r a te J av a a rc hive (JAR) files w he n ever yo u u pgr a de t he Or acle Developer
tec h nology s t ac k, or w he n a dvise d by Or acle S u p po rt Service s. This t a s k sign s JAR
files (if o n a We b se rver) a n d al so doe s t he following:
• Ge ner a te s p ro d u c t JAR files in J AVA_TOP a n d copie s t he m to APPL_TOP
• Ge ner a te s ot he r J av a-relate d files u n de r APPL_TOP a n d J AVA_TOP
• Recre a te s J av a libr a rie s (app s bo rg.zip a n d a p p s bo rg2.zip) u n d e r APPL_TOP a n d
J AVA_TOP
Whe n yo u r u n t he t a s k, it p ro m p t s:
Do you wish to force generation of all jar files? [No]
If yo u c hoo se No, it ge ner a te s o nly JAR files t h a t a re mi s si ng or o u t-of-d a te. If yo u

c hoo se Yes, all JAR files a re ge ner a te d (more ti me-co n s u mi ng).
If AD Admi ni st r a tio n di s plays a list of w ar ni ngs or error s a n d object s t h a t did n o t
ge ne r a te s u cce s sf ully a n d a s k s if yo u wa n t to co n ti n u e a s if s u cce s sf ul, review t he log
file to de ter mi ne if t he p ro ble m s req uire a t te n tio n. If yo u c hoo se n o t to co n ti n u e a n d
re s t a r t yo u r se s sio n a t a later ti me, AD Admi ni str a tio n a t te m p t s to rege ne r a te o nly t he
files t h a t did n o t ge ne r a te s u cce s sf ully.
Maintaining Applications Files

Cert ai n m ai n te n a n ce t a s k s a re req uire d to kee p yo u r Applic atio n s files u p to d a te. For
exa m ple, yo u m ay n ee d to copy p ro d u c t files to a ce n t r al loc atio n or co nvert files in t he
APPL_TOP to a no t he r c h a r ac ter s e t. The se t a s k s a re gro u pe d o n t he Mai n t ai n
Applicatio n s Files m e n u .
Maintaining Applications Files Menu
Yo u c a n r u n a n y of t he se t a s k s by c hoo si ng it fro m t hi s m e n u .
Relink Applications Programs
Relin k s Or acle E-B u si ne s s S uite exec u t a ble p rogr a m s wit h t he Or acle se rver libr a rie s
so t h a t t hey fu nctio n wit h t he Or acle d a t a b a se. For e ac h p ro d u c t, yo u c a n c hoo se
w het he r to lin k all exec u t a ble s or s pecific o ne s o nly.
The defa ult is to relin k wit ho u t de b ug infor m a tio n. Yo u s ho uld u s e t he de b ug optio n
o nly w he n req u e s te d to do so by Or acle S u p po rt Service s.
Important: AD Admi ni st r a tio n c a n n o t be u s e d to lin k exec u t a ble s for t he AD p ro d u c t s
t he m selves. Yo u m u s t u s e AD Relin k for t hi s. See Relin ki ng AD Exec u t a ble s in Oracle
E-Business Suite Maintenance Procedures.
Copy Files to Destinations

Copies files fro m e ac h p ro d u c t a re a to ce n t r al loc atio n s w he re t hey c a n be e a sily
refere nce d by n o n -Applicatio n s p rogr a m s . This optio n u s e s revisio n-b a se d copy logic
to e n s u re t h a t t he de s ti n a tio n file ver sio n s a re t he s a m e a s, or hig he r t h a n , t he so u rce
file ver sio n s.
Or acle reco m m e n d s t h a t yo u do n o t u s e t he force optio n to overwrite existi ng files,
u nle s s so in s t r u c te d by Or acle S u p po rt Service s. Copying files wit h t hi s optio n
u p d a te s all JAR files, re s ulti ng in t he m all bei ng dow nlo a de d to e ac h clie n t ag ai n a n d
c a u si ng r u n ti me pe rfor m a n ce degr a d a tio n.
The file type s a n d t heir re s pective de s ti n a tio n s a re s how n in t he following t a ble:
Copy Files to De sti n a tio n s S u m m a ry
These ... are copied to: ... are copied to:
files ... (UNIX) (Windows)
J av a files $ J AVA_TOP % J AVA_TOP%
HTML files $OAH_TOP %OAH_TOP%
Media files $OAM_TOP %OAM_TOP%
The directorie s for t he varia ble s a re s pecified in t he a dova r s.e nv file (UNIX) or t he
a dova r s.c m d file (Win dow s).
Whe n t hi s optio n is u s e d to copy re port s files, t he defa ult de s ti n a tio n is u n d e r
AU_TO P.
Convert Character Set

Pre p a re s t he files in t he APPL_TOP for co nver sio n to a n o t he r c h a r ac te r se t, a n d t he n
pe rfor m s t he co nver sio n.
Note: For m o re infor m a tio n, see Glob alizatio n S u p port in Oracle E-Business Suite
Concepts.
Whe n yo u c hoo se t hi s optio n, AD Admi ni str a tio n p re se n t s a n o t he r s u b m e n u , w hic h
co n t ai n s optio n s for s c a n ni ng yo u r files in p re p a r a tio n for t he co nver sio n. The sc a n
se a rc he s for exceptio n s - files t h a t will h ave inco m plete (los sy) co nver sio n s - so t h a t
yo u c a n fix po te n ti al p ro ble m s before yo u a c t u ally co nvert t he c h a r ac ter se t. C hoo se
o ne of t he following sc a n optio n s.
Tip: Always verify t he co m p a tibility of t he d a t a b a se c h a r ac te r se t before co nverti ng t he
APPL_TOP c h a r ac ter se t.
The optio n s a re:
1. Sc a n t he APPL_TOP for exce ptio n s.
Sc a n s t he APPL_TOP a n d cre ate s t h ree files in t he a d mi n \ < SID> \ o u t directory.
Sc a n APPL_TOP for Exce ptio n s O u t p u t Files
File Contents
a d m a nife st_exc p. List s files t h a t will n o t be co nverte d bec a u s e of los sy
lst co nver sio n.
a d m a nife st.lst List s files t h a t c a n be co nverte d.
a d m a nife st_los sy List s files wit h los sy co nver sio n s, incl u di ng line by line
.lst de t ail.
Review t he files liste d in a d m a nifest_excp.lst. Fix files t h a t re port los sy
co nver sio n before yo u co nvert t he c h a r ac ter se t. Repe a t t hi s t a s k u n til t he re a re
n o e n t rie s in a d m a nife st_excp.lst. If yo u n ee d to see m o re de t ail, review
a d m a nife st_los s y.lst.
2. Sc a n a CUSTOM directory for exceptio n s.
Collect s t he s a m e infor m a tio n a s t he first t a s k, b u t sc a n s c u s to m Applic atio n s
directorie s r a t he r t h a n t he APPL_TOP director y.
3. Co nvert c h a r ac te r se t.
R u n t hi s t a s k o nly if a d m a nife st_exc p.lst h a s n o e n t rie s. It p ro m p t s yo u for t he
m a nife st file (ad m a nifest.lst) cre ate d w he n yo u r a n t he sc a n optio n(s).
The u tility b ac k s u p t he p ro d u c t so u rce files a n d t he APPL_TOP / a d mi n so u rce
files. It s ave s p ro d u c t files in t he <PROD>_TOP directorie s in t he for m a t <pro d>_
s_<c h a r_se t>.zip. It s ave s a d mi n so u rce files in t he APPL_TOP / a d mi n directory
in t he for m a t a d mi n_s_<c h a r_set>.zip
Maintain Snapshot Information

There a re two type s of s n a p s ho t s: APPL_TOP snapshots a n d global snapshots. An
APPL_TOP s n a p s ho t list s p a tc he s a n d versio n s of files in t he APPL_TO P. A glob al
s n a p s ho t list s p a tc he s a n d late s t ver sio n s of files in t he e n tire Applic atio n s sy s te m
(th a t is, a c ro s s all APPL_TOP s).
Bot h APPL_TOP s n a p s ho t s a n d glob al s n a p s ho t s m ay be eit he r current view snapshots
or named view snapshots. A c u r re n t view s n a p s ho t is cre a te d o nce a n d u p d a te d w he n
a p p ro pri ate to m ai n t ai n a co n si s te n t view. A p a r ti al view s n a p s ho t allow s yo u to
sy nc h ro nize o nly selecte d files fro m a c u r re n t view. A n a m e d view s n a p s ho t is a copy of
t he c u r re n t view s n a p s ho t a t a p a r tic ula r ti me (not n ece s s a rily t he late s t c u r re n t view
s n a p s ho t), a n d is n o t u p d a te d.
P atc h Wizar d u s e s t he infor m a tio n co n t ai ne d in t he glob al c u r re n t view s n a p s ho t to
de ter mi ne w hic h p a tc he s h ave alre a dy bee n a p plied. AutoP a tc h u s e s t he APPL_TOP
c u r re n t view s n a p s ho t to de ter mi ne if all p re req ui site p a tc he s h ave bee n a p plied to
t h a t APPL_TO P. S n a p s ho t infor m a tio n is s to re d in t he AD_SNAPSHOTS, AD_
SNAPSHOT_FILES, a n d AD_SNAPSHOT_BUGFIXES t a ble s.
D u ri ng a n ew in s t allatio n, Ra pid In s t all cre ate s a c u r re n t s n a p s ho t a s a b a seline.
E ac h ti me yo u r u n AutoP a tc h, it a u to m a tic ally cre a te s a n ew (up d a te d) s n a p s ho t so
t h a t t he infor m a tio n is c u r re n t a s of t he a p plicatio n of t he p a tc h.
S n a p s ho t infor m a tio n m ai n te n a n ce is pe rfor me d by c hoo si ng Mai n t ai n S n a p s ho t
Infor m a tio n fro m t he Mai n t ai n Applicatio n s Files m e n u , a n d t he n s electi ng t he
req uire d optio n.
Maintain Snapshot Information Main Menu
The se optio n s allow yo u to:

• List s n a p s ho t s s tore d in t he sy s te m
• Upd a te a c u r re n t view s n a p s ho t (full or p a r ti al APPL_TOP a n d glob al)
• Cre a te a n a m e d s n a p s ho t (yo u select a c u r re n t view s n a p s ho t to copy a n d n a m e)
• Export a s n a p s ho t to file (yo u select a s n a p s ho t to export to a text file)
• Im port a s n a p s ho t fro m a text file (yo u select a s n a p s ho t to im port fro m a text
file)
• Delete a n a m e d s n a p s ho t
Maintain Current View Snapshot Information

Whe n yo u m ai n t ai n a c u r re n t view s n a p s ho t, yo u c a n c hoo se to sy n c h ro nize selecte d
files (to m ai n t ai n a p a r ti al s n a p s ho t), in s te a d of sy n c h ro nizi ng all files for t he e n tire
APPL_TO P. U se t hi s optio n w he n yo u h ave copied o nly a few files to t he APPL_TO P.
1. Select t he Upd a te C u r re n t View S n a p s ho t optio n fro m t he Mai n t ai n S n a p s ho t
Infor m a tio n m e n u .
Maintain Current View Snapshot Information Menu
2. Fro m t he Mai n t ai n C u r re n t View S n a p s ho t Infor m a tio n m e n u , yo u c a n select

o ne of t he following optio n s:
• Update Complete APPL_TOP
Thi s is t he origin al fu nc tio n ality of t he Upd a te C u r re n t View S n a p s ho t
optio n. It sy nc h ro nize s all t he files in yo u r APPL_TO P.
• Update JAVA_TOP only
Sy nc h ro nize s o nly t he files in t he J AVA_TO P. At t he p ro m p t, e n te r t he
p a t h to t he J AVA_TOP s u b directory w he re t he files were copied. If t he files
were copied to m o re t h a n o ne directory, p re s s Enter. AD Admi ni str a tio n
sc a n s t he e n tire J AVA_TOP a n d u p d a te s t he infor m a tio n in bo t h t he
c u r re n t view a n d t he glob al view s n a p s ho t s.
• Update a <PRODUCT>_TOP
Sy nc h ro nize s o nly t he files in a s pecific <PRODUCT>_TO P. E n te r t he
p ro d u c t a b b reviatio n, t he n p rovide t he s u b directory infor m a tio n a t t he
p ro m p t.
E n te r t he p a t h to a si ngle s u b directory in t he <PRODUCT>_TO P. If t he
files were copied to m o re t h a n o ne directory in t he <PRODUCT>_TO P,
p re s s E n te r. AD Admi ni str a tio n sc a n s t he e n tire <PRODUCT>_TOP a n d
u p d a te s t he infor m a tio n in bot h t he c u r re n t a n d t he glob al view
s n a p s ho t s.
Check for Missing Files
Ve rifies t h a t all files n ee de d to r u n Or acle E-B u si ne s s S uite for t he c u r re n t
co nfigu r a tio n a re in t he c u r re n t APPL_TO P. C hoo se t hi s t a s k if yo u s u s pect t he re a re
files mi s si ng in yo u r APPL_TO P.
Managing Database Entities

D a t a b a se e n tities a re d a t a b a se object s or d a t a in t he d a t a b a se relate d to Or acle E-
B u si ne s s S uite. Ta s k s for m a n agi ng e n titie s a re gro u pe d into two optio n s o n t he AD
Admi ni str a tio n Mai n Me n u: o ne for co m piling or relo a di ng e n titie s a n d o ne for
verifying t heir integrity.
Compiling or Reloading Database Entities

To co m pile or relo a d d a t a b a se e n titie s, c hoo se t he Co m pile / Relo a d Applicatio n s
D a t a b a se E n titie s Me n u optio n fro m t he AD Admi ni st r a tio n Mai n Me n u .
Compile /Reload Applications Database Entities Menu
Yo u r u n t he t a s k s o n t hi s m e n u a n y ti me yo u n ee d to co m pile or relo a d d a t a b a se
object s; for exa m ple, after yo u u plo a d n ew m e n u e n trie s, or a p ply a p a tc h t h a t
c h a n ge s t he se t u p of flexfields. R u n t he se t a s k s o nly o n t he n o de w he re t he core AD
tec h nology directorie s a re loc ate d.
Compile APPS schema

S p aw n s p a r allel worker s to co m pile invalid d a t a b a se object s in t he APPS sc he m a.
Note: For m o re infor m a tio n, see Compiling Invalid Objects in Oracle E-Business Suite
Compile Menu Information
Co m piles m e n u d a t a s t r u c t u re s. C hoo se t hi s t a s k after yo u h ave u plo a de d m e n u
e n t rie s to t he FND_MENU_ENTRIES t a ble, or if Co m pile Sec u rity co nc u r re n t req u e s t s
s u b mi tte d fro m t he Me n u s for m (after c h a ngi ng m e n u e n t rie s) fail for a ny re a so n .
AD Admi nis tr a tio n a s k s if yo u wa n t to force co m pilatio n of all m e n u s . If yo u c hoo se t he
defa ult (No), o nly m e n u s wit h c h a nge s a re co m piled. If yo u e n ter Yes, all m e n u s a re
co m piled. Co m piling all m e n u s is ge ne r ally n o t req uire d.
Compile Flexfields
Co m piles flexfield d a t a s t r u c t u re s in Or acle Applicatio n O bject Libr a ry (FND) t a ble s.
C hoo se t hi s t a s k after yo u a p ply a p a tc h t h a t c h a n ge s t he s e t u p of flexfield s. P atc he s
u s u ally in dic a te w he n yo u s ho uld pe rfor m t hi s s te p
Flexfield s a u to m a tic ally co m pile d a t a w he n yo u u s e t he m for t he first ti me, so r u n ni ng
t hi s t a s k is ge ner ally n o t req uire d. Howeve r, co m piling flexfield s a t a s pecific ti me c a n
alleviate po te n ti al r u n ti me pe rfor m a n ce is s u e s. For exa m ple, yo u m ay c hoo se to
co m pile t he m w he n sy s te m u s age is k now n to be low, r a t h e r t h a n a u to m a tic ally o n
first u s e.
Reload JAR files to Database

Reloa d s all a p p ro p ri ate Or acle E-B u si ne s s S uite JAR files in to t he d a t a b a se. C hoo se
t hi s t a s k if all Or acle E-B u si ne s s S uite J av a cla s se s a re re moved fro m yo u r d a t a b a se;
for exa m ple, if t he d a t a b a s e J av a Virt u al Mac hi ne (JVM) is reloa de d bec a u s e of
d a t a b a s e corr u p tio n.
Maintaining Applications Database Entities

D u ri ng n o r m al sys te m u s e, t he in tegrity of yo u r d a t a b a se c a n be co m p ro mi se d, for
exa m ple t h ro ug h u s e r error or after yo u a p ply a n in a p p ro p ri ate p a tc h. It is a dvis a ble
to verify t he integrity of d a t a b a se e n titie s a s a reg ul ar m ai n te n a n ce p roced u re, or
w he never t he be h avior of yo u r sy s te m in dic ate s t h a t d a t a b a s e e n titie s m ay h ave bee n
corr u p te d.
To pe rfor m t he se m ai n te n a n ce t a s k s, select t he Mai n t ai n Applicatio n s D a t a b a se
E n titie s Me n u optio n fro m t he AD Admi ni st r a tio n Mai n Me n u .
Maintain Applications Database Entities Menu
So me t a s k s o n t hi s m e n u re port o n iss u e s, or pote n ti al iss u e s, wit h d a t a b a se e n tities,
a n d ot he r s a c t u ally re m e dy t he is s u e s.
Validate APPS schema

Ve rifies t he integrity of t he APPS sc he m a. It p ro d u ce s a re port n a m e d <APPS sc he m a
n a m e>.lst. t h a t list s is s u e s a n d pote n ti al iss u e s, gro u pe d by t he ac tio n req uire d:
• Iss u e s yo u m ust fix (not s pecific to t he APPS sc he m a)
• Iss u e s yo u m ust fix (specific to t he APPS sc he m a)
• Iss u e s yo u m ay w a n t to a d d re s s (specific to t he APPS sc he m a)
The re port is locate d in $APPL_TOP / a d mi n / < SID> / o u t (UNIX), w here <SID> is t he
val ue of t he ORACLE_SID or TWO_TASK varia ble, or in %APPL_ TOP
% \ a d mi n \ < SID> \ o u t (Win dow s), w he re <SID> is t he val ue of t he LOCAL vari a ble.
E ac h sectio n of t he file co n t ai n s in s t r u c tio n s for re solving t he is s u e s t h a t a re liste d.
Most is s u e s c a n be fixed by eit he r co m piling invalid d a t a b a se object s or recre a ti ng
gr a n t s a n d sy no ny m s.
Note: For m o re infor m a tio n, see Valid a ti ng t he APPS Sc he m a in Oracle E-Business Suite
Recreate Grants and Synonyms for APPS Schema

Thi s t a s k recre a te s gr a n t s a n d sy no ny m s for t he Or acle E-B u si ne s s S uite p u blic
sc he m a (APPLSYSPUB), recre a te s gr a n t s o n so m e p ac k age s fro m SYSTEM to APPS,
a n d s p aw n s p a r allel worke r s to recre a te gr a n t s a n d sy no ny m s lin ki ng seq u e n ce s a n d
t a ble s in t he b a se sc he m a s to t he APPS sc he m a.
Typic ally, yo u r u n t hi s t a s k after t he Valid a te APPS sc he m a t a s k h a s re porte d iss u e s
wit h mi s si ng gr a n t s a n d sy no ny m s.
Maintain Multi-Lingual Tables
R u n t hi s t a s k after yo u a d d a la ng u age. It p ro m p t s yo u for t he n u m be r of worker s,
t he n u p d a te s all m ultiling u al t a ble s.
Check DUAL Table

So me Or acle E-B u si ne s s S uite p ro d u c t s m u s t a cce s s t he DUAL t a ble. It m u s t exist in
t he SYS sc he m a a n d co n t ai n exactly o ne ro w. This t a s k s verifies t he existe nce of t hi s
t a ble a n d t he si ngle ro w.
Important: If t he DUAL t a ble doe s n o t exist, or if it doe s n o t co n t ai n o nly o ne ro w, t he
Or acle E-B u si ne s s S uite p ro d u c t s t h a t a cce s s it will fail to oper a te correctly.
Using Maintenance Mode

Mai n te n a n ce m o de co n t rols t he sy s te m dow n ti me pe riod by m a n agi ng u s e r logo n s.
Yo u toggle Mai n te n a n ce Mode fro m e n a bled to di s a bled fro m t he C h a nge Mai n te n a n ce
Mode m e n u .
Note: For m o re infor m a tio n, see Pre p a ri ng yo u r Syste m for P atc hi ng in Oracle E-
Business Suite Patching Procedures. See al so Mai n te n a n ce Mode in C h a p te r 9 of Oracle E-
Business Suite Concepts.
C hoo se C h a n ge Mai n te n a n ce Mode fro m t he AD Admi ni st r a tio n Mai n Me n u . The
m e n u a p pe a r s, di s pl ayi ng t he c u r re n t m ai n te n a n ce m o de s t a t u s a t t he to p of t he
sc ree n.
Change Maintenance Mode Menu
Select optio n 1 to e n a ble Mai n te n a n ce m o de, or optio n 2 to di s a ble it.

Mai n te n a n ce m o de m u s t be enabled before r u n ni ng AutoP atc h a n d disabled d u ri ng
n o r m al d ay-to-d ay oper a tio n.
Using AD Relink
Yo u u s e AD Relin k to relin k AD exec u t a ble s wit h t he Or acle se rver p ro d u c t libr a rie s
w he n req uire d, to e n s u re t hey will kee p fu nc tio ni ng p ro perly wit h t he Or acle d a t a b a se.
Yo u c a n relin k m ultiple AD exec u t a ble s si m ult a n eo u sly.
Important: AD exec u t a ble s cannot be relin ke d u si ng t he Relin k Applicatio n s
Exec u t a ble s t a s k o n t he AD Admi ni st r a tio n Mai n t ai n Applicatio n s Files s u b m e n u .
Log Files
As yo u r u n AD Relin k, it cre ate s a log file (adrelin k.log) w he re it record s error s a n d
m e s s age s. AD Relin k a p pe n d s infor m a tio n a bo u t t he late s t relin k ac tio n to t he e n d of
t he file. Thi s file is loc ate d in APPL_TOP / a d mi n / log. If a n error occ u r s w hile yo u a re
u si ng AD Relin k, or if yo u a re n o t s u re t h a t t he relin ki ng wa s s u cce s sf ul, review t hi s
file to s ee w h a t is s u e s s ho uld be fixed. It is al so a dvis a ble to review t he file eve n if n o
is s u e s a re s u s pec te d, to co nfir m t he oper a tio n wa s s u cce s sf ul.
Relin ki ng error s e nco u n te re d d u ri ng a n AD Admi ni str a tio n or a n AutoP a tc h se s sio n
a re recor de d in t he m ai n log files for t ho se u tilitie s. See Log Files in C h a p te r 1 .
Tip: To recover di s k s p ace, or si m ply a s good ho u s e kee pi ng p r ac tice, yo u c a n delete
t he a d relin k.log file if yo u do n o t n ee d t he infor m a tio n. A n ew log file is cre a te d e ac h
ti me AD Relin k r u n s.
Relinking AD Executables
Yo u u s e AD Relin k to relin k AD exec u t a ble s wit h t he Or acle se rver p ro d u c t libr a rie s to
kee p t he m fu nc tio ni ng p ro pe rly wit h t he Or acle d a t a b a se. While yo u lin k p ro d u c t
exec u t a ble s u si ng t he Relin k Applicatio n s Exec u t a ble s t a s k o n t he AD Admi ni st r a tio n
Mai n t ai n Applic atio n s File s s u b m e n u , yo u c a n n o t u s e it to reli n k a n AD exec u t a ble.
In s te a d, yo u m u s t relin k AD exec u t a ble s u si ng AD Relin k. Yo u c a n reli n k m u ltiple AD
exec u t a ble s si m ult a n eo u sly.
Log Files
As yo u r u n AD Relin k, it cre ate s a log file (adrelin k.log) w he re it record s error s a n d
m e s s age s. AD Relin k a p pe n d s infor m a tio n a bo u t t he late s t relin k ac tio n to t he e n d of
t he file. Thi s file is loc ate d in APPL_TOP / a d mi n / log. If a n error occ u r s w hile yo u a re
u si ng AD Relin k, or if yo u a re n o t s u re t h a t t he relin ki ng wa s s u cce s sf ul, review t hi s
file to s ee w h a t is s u e s s ho uld be fixed.
Relin ki ng error s e nco u n te re d d u ri ng a n AD Admi ni str a tio n or a n AutoP a tc h se s sio n
a re recor de d in t he m ai n log files for t ho se u tilitie s. See Log Files in C h a p te r 1 .
To recover di s k s p ace, yo u c a n delete t he a d relin k.log file if yo u do n o t n ee d t he
infor m a tio n. A n ew log file is cre ate d e ac h ti me AD Relin k r u n s.
Command Line Arguments
Yo u c a n m o dify or refine t he oper a tio n of AD Relin k wit h t he co m m a n d line a rg u m e n t s
in t he following t a ble.
AD Relin k Co m m a n d Line Argu m e n t s
force Description
P u r po s In dic a te s w hic h exec u t a ble p rogr a m s to relin k
Val u e s • n , (relin k o nly if t he libr a rie s or object files a re m o re rece n t t h a t t he
c u r re n t exec u t a ble p rogr a m)
• y (relin k regar dle s s of t he s t a t u s of t he libr a rie s or object files)
Defa ult n o n e (m u s t e n te r eit he r y or n)

Exa m pl a d reli n k force= n
AD Relin k Co m m a n d Line Argu m e n t s
backup_mode Description
P u r po se In dic a te s w he t he r yo u w a n t to b ac k u p exec u t a ble s
Val u e s • n o ne (do n o t b ac k u p a n y exec u t a ble s)
• all (bac k u p all exec u t a ble s)
• file (bac k u p files a ccordi ng to in s t r u c tio n s in

a dli n k b k.txt)
Defa ult b ac k u p_ mo de=file

Exa m ple a d reli n k force= n b ac k u p_ mo de= all
Note: The se co m m a n d line a rg u m e n t s a re inte n de d for u s e wit h t he AD Relin k u tility
o nly.
Files t h a t a re critic al to r u n ni ng Or acle E-B u si ne s s S uite a re liste d in t he a dli n k b k.txt
file, w hic h is locate d in APPL_TOP / a d mi n . Usi ng t he b ac k u p_ mo de=file a rg u m e n t
direct s AD Relin k to b ac k u p o nly t he se files.
The AD Relink Interface
Yo u r u n AD Relin k fro m t he co m m a n d line. It doe s n o t u s e m e n u s or in p u t sc ree n s.
Running AD Relink
R u n AD Relin k a s follows.
1. Set t he e nviro n m e n t.
Yo u m u s t se t t he e nviro n m e n t to in dic a te t he loc atio n of t he co nfigu r a tio n
p a r a m e te r s t h a t define yo u r sy s te m . Thi s t a s k is co m mo n to m a ny AD u tilities.
See Setti ng t he E nviro n m e n t in C h a p te r 1 for t he b a sic s te p s.
2. Relin k files.
R u n AD Relin k wit h t he a p p ro pri ate co m m a n d for yo u r oper a ti ng sys te m:
UNIX
S adrelink.sh force=n "ad <executable name>"
Windows
C:\> sh adrelink.sh force=n "ad <executable name>"
Note: See Relin ki ng AD Exec u t a ble s in Oracle E-Business Suite Maintenance Procedures
for a co m plete de sc riptio n of r u n ni ng t hi s u tility wit h t he vario u s co m m a n d line
a rg u m e n t s.

Rele a se 1 2.1
P ar t Nu m be r E 1 3 6 7 6-0 3 Co n te n t s Previo u s Next
Getting Started
Thi s c h a p te r co n t ai n s b a sic infor m a tio n a bo u t Or acle E-B u si ne s s S uite m ai n te n a n ce
u tilitie s, bo t h co m m a n d line a n d We b-b a se d.
• Or acle E-B u si ne s s S uite Mai n te n a n ce Utilitie s
• Co m m a n d Line Utilities
• R u n ni ng AD Utilitie s
• U si ng P ar allel Proce s si ng
• OAM We b-Ba se d Utilities

Yo u u s e Or acle E-B u si ne s s S uite sy s te m m ai n te n a n ce u tilitie s to pe rfor m a variety of
oper a tio n s fro m in s t alling a n d u pgr a di ng Or acle E-B u si ne s s S uite sy s te m s, to
u p d a ti ng co nfigu r a tio n p a r a m e ter s, to m ai n t ai ni ng a n d p a tc hi ng yo u r d a t a b a se a n d
file sy s te m, to p ro d u ci ng sy s te m re port s.
In t hi s boo k, t he se u tilities h ave bee n c a tegorized by t he way yo u acce s s a n d u s e t he m .
Thi s m ay be fro m t he co m m a n d line, or via a We b-b a se d in te rface.
Tip: As of Rele a se 1 2, all infor m a tio n a bo u t p a tc hi ng a n d AutoP atc h oper a tio n s wa s
m oved to a se p a r a te boo k, Oracle E-Business Suite Patching Procedures .
Command Line Utilities

The tools ge ne r ally referre d to a s Applic atio n s DBA (AD) u tilitie s a re s t a r te d a n d r u n
fro m t he co m m a n d line. They initiate p roce s se s t h a t pe rfor m a variety of sys te m
m ai n te n a n ce t a s k s, s u c h a s a p plyi ng a n d m e rgi ng p a tc he s. As t hey r u n , t he u tilities
p ro m p t yo u for sy s te m -s pecific p a r a m e te r s n ece s s a ry to pe rfor m t he m ai n te n a n ce
t a s k. In a d ditio n, m a ny of t he u tilities p ro d u ce re port s t h a t co n t ai n infor m a tio n s u c h
a s job ti mi ng a n d file versio n s.
The AD u tilities h ave si milar interface s, oper a tio n, in p u t, a n d re port for m a t s. Ma ny
al so s h a re t he a bility to a cce pt a rg u m e n t s, flags, a n d optio n s, w hic h yo u c a n u s e to
refine t he ac tio n s t hey pe rfor m. Yo u a d d t he a rg u m e n t o n t he co m m a n d line w he n yo u
s t a r t t he u tility. For exa m ple, to s pecify t he n u m be r of worker s t h a t AutoP a tc h s ho uld
r u n in p a r allel w he n a p plyi ng a p a tc h, yo u e n te r t he n u m be r of worker p roce s se s o n
t he co m m a n d line w he n yo u s t a r t AutoP atc h. A list of co m mo nly u s e d co m m a n d line
a rg u m e n t s a n d flags, a n d a b rief de sc riptio n of how to u s e t he m, begi n s later in t hi s
c h a p te r.
Exce pt w he re n o te d, t he AD u tilities in t he following t a ble a re de sc ribe d in t hi s book.
AD Co m m a n d Line Utilities
Executable or
AD Utility Name Description
Script
AD Admi nis tr a tio n a d a d mi n Perfor m s m ai n te n a n ce t a s k s for Or acle E-
B u si ne s s S uite.
AD C hec k Dige st a dc h k dig C hec k s t he in tegrity of Or acle E-B u si ne s s S uite
p a tc he s dow nlo a de d fro m My Or acle S u p po rt.
AD Co nfigu r a tio n a d u tco nf.sql Report s s t a n d a r d infor m a tio n a bo u t t he
in s t alled co nfigu r a tio n of Or acle E-B u si ne s s
S uite.
AD Co n t roller a dc trl Ma n age s p a r allel worke r s in AD Admi ni str a tio n
a n d AutoP a tc h.
AD File a di de n t Report s t he ver sio n a n d tr a n sl a tio n level of a n
Ide n tificatio n Or acle E-B u si ne s s S uite file.
AD File C h a r ac te r a d n c nv Co nvert s a file fro m o ne c h a r ac te r se t to
Se t Co nverter a n o t he r.
AD Merge P atc h* a d m rgpc h Merge s m ultiple p a tc he s into a si ngle m e rge d
p a tc h.
AD Relin k a d reli n k. s h Relin k s Or acle E-B u si ne s s S uite exec u t a ble
p rogr a m s wit h t he Or acle se rver p ro d u c t
libr a rie s.
AD S plicer a d s plice Add s off-cycle p ro d u c t s.
AD J o b Ti mi ng Report s a s u m m a ry of t he ti mi ng for job s r u n by
Report p a r allel worke r s.
AutoP atc h* a d p a tc h Applies p a tc he s a n d ot he r sys te m u p d a te s.
P atc h Applicatio n a d m si.pl Ge ne r a te s c u s to mized in s t allatio n in s t r u c tio n s
Assist a n t* for a p a tc h.
R a pid In s t all** r a pidwiz Provide s a wizar d for e n teri ng p a r a m e te r s t h a t
a re s pecific to a n ew in s t allatio n or a n u pgr a de
of a n Or acle E-B u si ne s s S uite sys te m .
*See Oracle E-Business Suite Patching Procedures for co m plete infor m a tio n a bo u t
p a tc he s a n d p a tc h u tilitie s.
**The b a sic oper a tio n of Ra pid In s t all is de sc ribe d h e re. See Oracle E-Business Suite
Installation Guide: Using Rapid Install for co m plete in s t r u c tio n s o n u si ng it to in s t all or
u pgr a de a n Or acle E-B u si ne s s S uite sy s te m .
Web-Based Utilities
Or acle Applicatio n s Ma n ager (OAM) p rovide s a We b-b a se d interface w here sys te m
a d mi ni s tr a tor s c a n m o nitor sys te m s t a t u s, a d mi ni ster se rvice s, exa mi ne sy s te m
co nfigu r a tio n, m a n age Or acle Wor kflow, view a p plied p a tc he s, a n d m e a s u re sys te m
u s age. It p rovide s a co ncise overview of t he s t a te of yo u r Or acle E-B u si ne s s S uite
sy s te m, a n d se rve s a s a gatew ay to u tilitie s for t a s k s s u c h a s m a n agi ng sy s te m
co nfigu r a tio n, reviewing p a tc h hi s tory, de te r mi ni ng w hic h p a tc he s will b ri ng yo u r
sy s te m u p to d a te, registeri ng a d ditio n al p ro d u c t s a n d la ng u age s, a n d ot he r
m ai n te n a n ce a c tivitie s.
The We b-b a se d m ai n te n a n ce u tilitie s a re liste d in t he following t a ble. Their oper a tio n
is de sc ribe d fully in Oracle E-Business Suite Patching Procedures or Oracle E-Business Suite
System Administrator’s Guide - Configuration .
Or acle Applic atio n s Ma n ager Utilities
OAM Utility
Description
Name
Applied U se s key p a tc h infor m a tio n in t he p a tc h hi s tory d a t a b a se. Yo u c a n
P atc he s** se a rc h t he d a t a b a se to cre ate re port s in sever al for m a t s.
AutoCo nfig* U se to view c u r re n t co n text files, edit p a r a m e ter s co n t ai ne d in t he
co n text files, view p revio u s co n text files, a n d co m p a re c u r re n t
co n text files ag ai n s t p revio u s o ne s.
File History** E n a ble s t he viewing of files t h a t h ave bee n u p d a te d by a p a tc h.
Lice n se Register s a d ditio n al Or acle E-B u si ne s s S uite p ro d u c t s, co u n t ry-
Ma n ager* s pecific fu nc tio n alitie s, or la ng u age s. Yo u c a n al so u s e Lice n se
Ma n ager to c h a n ge t he b a se la ng u age for yo u r sys te m.
P atc h Wizar d** Deter mi ne s p a tc he s t h a t h ave n o t bee n a p plied, b u t t h a t s ho uld be
a p plied to kee p t he sy s te m c u r re n t. Dow nloa d s a n d m e rge s p a tc he s
fro m My Or acle S u p port.
Register U se d to recor d a ny files in w hic h yo u h ave m a de c u s to mizatio n s.
Flagged Files** Replace s t he n ee d to u s e a p plc u s t.txt, w hic h co n t ai ne d t he recor d
for all c u s to mized files in p revio u s rele a se s.
Softw are Provide s a n overview of all p a tc hi ng-relate d infor m a tio n for yo u r
Upd a te s** sy s te m .
Ti mi ng Help s yo u m o nitor job s t h a t a re r u n ni ng or view s t a ti s tic s of
Report s** co m plete d AutoP a tc h a n d AD Admi ni str a tio n m ai n te n a n ce se s sio n s.
* See Oracle E-Business Suite System Administrator’s Guide.
** See Oracle E-Business Suite Patching Procedures.
Online Help
Bot h t he AD u tilities a n d t he OAM u tilities p rovide a h elp fu nc tio n.
Command Line Help
For t he AD co m m a n d line u tilitie s, yo u c a n req u e s t a list of a rg u m e n t s by e n te ri ng t he
u tility n a m e wit h h elp=y a p pe n de d. For exa m ple, to acce s s h elp for AD
Admi ni str a tio n, e n te r t he co m m a n d:
adad min help=y
The a rg u m e n t s a n d optio n s t h a t yo u c a n u s e to refine t he oper a tio n of a u tility a re

liste d, alo ng wit h a b rief de sc riptio n of how t hey work. Below is a n exa m ple of t he
co m m a n d line h elp for AD Admi ni str a tio n:
usage: adadmin [help=y]
adadmin
[printdebug=y|n][localworkers=<localworkers>]
[flags=hidepw|trace]
adadmin Non-Interactive mode

[defaultsfile=<$APPL_TOP/admin/SID/defaultsfile>]
[logfile=<logfile>][interactive=y|n]
[workers=workers>][menu_option=ASK_NA M E >][restart=y|n]
w here
Key to options:localworker s = The n u m be r of worker s to r u n o n t he local m a c hi ne. U se d
in Distrib u te d AD.
flags = Ge neric flags p a s se d to AD u tilitie s. The av ailable val ue s for AD Admi n a re
hi de pw a n d tr ace.
defa ult sfile = The defa ult s file filen a m e, locate d u n d e r $APPL_TOP / a d mi n / SID /
directory.
m e n u_optio n = S kip s t he AD Admi n m e n u a n d exec u te s t he t a s k s u p plied o n t he
co m m a n d line. Valid val ue s a re liste d below.
RELINK Relink Applications programs
GE N_ MESSAGES Generate message files
GE N_FOR MS Generate form files
GE N_REPORTS Generate reports files
GE N_JARS Generate product JAR files
VALIDATE_APPS Validate APPS schema
C MP_INVALID Co mpile APPS schema
C MP_ ME N U Co mpile menu information
CREATE_GRA NTS Recreate grants and synonyms for APPS schema
C MP_FLEXFIELDS Co mpile flexfield data in AOL tables
M AINTAIN_ MLS M aintain m ulti-lingual tables
C HECK_DUAL Check D UAL table
RELOAD_JARS Reload JAR files to database
C OPY_FILES Copy files to destinations
C HECK_FILES Check for missing files
LIST_SNAPS H OTS List snapshots
UPDATE_CURRE NT_VIE W Update current view snapshot
CREATE_SNAPSH OT Create named snapshot
EXPORT_SNAPS H OT Export snapshot to file
IMPORT_SNAPS H OT Import snapshot from file
DELETE_SNAPS H OT Delete na med snapshot(s)
C O NVERT_CHARSET Convert character set
SCA N_APPLTOP Scan the APPLTOP for exceptions
SCA N_CUSTO M_DIR Scan a C USTO M directory for exceptions
E NABLE_ MAINT_ M O DE Enable M aintenance M ode
DISABLE_ MAINT_ M O DE Disable M aintenance M ode
Obtaining Help in OAM

OAM Help is av aila ble by clicki ng t he Help lin k in t he to p righ t-h a n d sec tio n of a ny
Or acle Applicatio n s Ma n ager sc ree n.
OAM Site Map and Help Link
For exa m ple, fro m t he OAM Site Map, OAM di s pl ays p age-s pecific h elp de sc ribi ng t he
feat u re s of t he Site Map p age.
OAM Site Map Help Page
In divid u al h elp to pic s m ay incl u de to pic al e s s ays, p roced u re s, a n d p age de sc riptio n s.
The h elp a s sociate d wit h t he u tilities a n d feat u re s di sc u s se d in t hi s book p rovide s
n avigatio n p a t h s, field definitio n s, a n d ge ne r al infor m a tio n a bo u t u si ng t he p age.

The AD m ai n te n a n ce u tilities were developed to pe rfor m s pecific Applic atio n s
m ai n te n a n ce a n d re porti ng t a s k s fro m t he co m m a n d line. For exa m ple, yo u u s e
AutoP atc h to a p ply all type s of p a tc he s to yo u r sy s te m, a n d yo u u s e AD
Admi ni str a tio n to pe rfor m ro u ti ne m ai n te n a n ce t a s k s.
Howeve r, eve n t ho ug h t he u tilitie s e ac h h ave a s peci alized fu nc tio n, t hey a re de signe d
to co m ple me n t e ac h ot he r, so m a n y e m ploy si milar oper a tio n s. Thi s sec tio n
s u m m a rize s t he oper a tio n s t h a t AD u tilitie s h ave in co m mo n. S u b seq u e n t c h a p te r s
de sc ribe e ac h u tility’s feat u re s in de t ail.
Note: See Oracle E-Business Suite Maintenance Procedures for s pecific t a s k s pe rfor m e d
u si ng t he AD u tilities, a n d Oracle E-Business Suite Patching Procedures for infor m a tio n
a bo u t AutoP a tc h a n d AD Merge P atc h.
Common AD Operations
Ma ny AD u tilitie s e m ploy si milar feat u re s a n d oper a tio n s a s t hey pe rfor m p roce s si ng
t a s k s. For exa m ple, m o s t rely o n p ro m p t s to gat he r val ue s for sy s te m -s pecific
p roce s se s, a n d all a u to m a tic ally cre a te log files to recor d p roce s si ng ac tio n s. Thi s
sectio n de sc ribe s so m e of t he se co m mo n oper a tio n s.
Note: See Oracle E-Business Suite Patching Procedures for infor m a tio n a bo u t AD
oper a tio n s t h a t a p ply to AutoP a tc h.
Prompts
Ma ny AD u tilitie s p ro m p t for infor m a tio n n ece s s a ry for co m pleti ng a t a s k. Pro m p t s
typic ally incl u de a de sc riptio n of t he infor m a tio n n ee de d, a n d m ay incl u de a defa ult
a n swer (in s q u a re b r ac ket s). Yo u c a n ju s t p re s s t he [Ret u r n] key to a cce pt t he defa ult.
For exa m ple:
The O RACLE username specified below for Application Object Library
uniquely identifies your existing product group: APPLSYS
Enter the ORACLE password of Application Object Library [APPS] :
Press [Return] to accept the default value, or type a new value

after the colon and press [Return]. Read the prompts carefully
to make sure you supply the correct information.
Interactive and Non-Interactive Processing

The AD u tilities pe rfor m p roce s si ng t a s k s inter ac tively by defa ult. Th a t m e a n s t he
u tility p ro m p t s for sys te m -s pecific infor m a tio n a t t he poi n t w here it n ee d s it, m a ki ng it
n ece s s a ry for yo u to be p re se n t d u ri ng t he e n tire oper a tio n in orde r to re s po n d to t he
p ro m p t s.
AD Admi nis tr a tio n, AutoP a tc h, a n d AD Co n t roller c a n r u n so m e file sys te m a n d
d a t a b a s e t a s k s n o n -inte r ac tively: yo u s to re t he req uire d infor m a tio n in a defa ult s file,
a n d t he u tility re a d s t he infor m a tio n fro m t hi s file in s te a d of p ro m p ti ng yo u for t he
in p u t. Non-inter ac tive p roce s si ng is u s ef ul for sc he d uli ng ro u ti ne t a s k s t h a t req uire
little or n o u s e r inte rve n tio n.
Note: For m o re infor m a tio n, see Perfor mi ng Mai n te n a n ce Ta s k s Non-Inter ac tively in
Oracle E-Business Suite Maintenance Procedures. See al so Mo nitori ng a n d Co n t rolling
P ar allel Proce s se s in t hi s c h a p te r.
Special Parameter for Using AutoPatch and AD Administration Non-Interactively

Whe n r u n ni ng AutoP a tc h, AD Admi ni str a tio n, or AD S plicer in n o n -inter ac tive m o de,
t he "stdi n=y" optio n c a n optio n ally be u s e d to p ro m p t for p a s swor d s in t he s t a n d a r d
in p u t. The defa ult is for p a s sword s to be s u p plied wit ho u t p ro m p ti ng.
Log Files
All AD u tilitie s record t heir p roce s si ng ac tio n s a n d a n y error s t h a t t hey e nco u n te r in
log files. Ma ny u tilities p ro m p t yo u for t he n a m e of t he log file t h a t will recor d t he
p roce s si ng se s sio n, wit h a di s play s u c h a s t hi s:
<utility na me> records your <utility na me> session in a text file you specify.
Enter your < <utility name> log file name or press [Return] to accept the
default na me shown in brackets.
Filename [<utility na me>.log] :
The defa ult file n a m e is .log. For exa m ple, for AD Admi ni st r a tio n, t he
defa ult log file is a d a d mi n.log. For AutoP atc h, it is a d p a tc h.log.
AD Admi nis tr a tio n (an d AutoP a tc h) place t heir log files in t he following loc atio n s:
UNIX:
$APPL_TOP / a d mi n / < SID> / log
Windows:
%APPL_TOP% \ a d mi n \ < SID> \ log
So me u tilitie s m ay n o t p ro m p t yo u for a log file n a m e: in s te a d, t hey will write t he log
file in t he directory fro m w hic h t he u tility wa s r u n .
Restart Files
Rest a r t files co n t ai n infor m a tio n a bo u t w h a t p roce s si ng h a s alre a dy bee n co m plete d.
They a re loc ate d in $APPL_TOP / a d mi n / < SID> / r e s t a r t (UNIX) or in %APPL_ TOP
% \ a d mi n \ < SID> \ r e s t a r t (Win dow s).
If a u tility s to p s d u ri ng p roce s si ng d u e to a n erro r, or yo u u s e AD Co n t roller (in t he
c a se of p a r allel p roce s si ng) to s h u t dow n worke r s w hile t hey a re pe rfor mi ng p roce s si ng
t a s k s, yo u c a n re s t a r t t he u tility. If yo u do, it look s for re s t a r t files to de ter mi ne if t he re
w a s a p revio u s se s sio n. If t he files exist, t he u tility p ro m p t s yo u to co n ti n u e w here t he
p roce s si ng left off, or to s t a r t a n ew p roce s s. If yo u c hoo se to co n ti n u e, it re a d s t he
re s t a r t files to see w here t he p roce s s left off, a n d co n ti n u e s t he p roce s s fro m t h a t
poi n t.
Caution: Do n o t m o dify or delete a n y m a n ager or worker re s t a r t files u nle s s s pecifically
directe d to do so by Or acle S u p port Services.
By defa ult, AD u tilities delete t heir re s t a r t files w he n p roce s si ng is co m plete, b u t leave
b ac k u p ver sio n s wit h t he exte n sio n s .b a k, .bk 2, or .b k 3.
Warning: Rest a r t files recor d p a s sword s for yo u r Or acle E-B u si ne s s S uite p ro d u c t s.
Yo u s ho uld re s t rict a cce s s to all re s t a r t files (locate d in
$APPL_TOP / a d mi n / < SID> / r e s t a r t). If yo u a re r u n ni ng a u tility wit h
optio n s= no hide p w, t he log files m ay al so co n t ai n p a s swor d s o n line s p refixed wit h
HIDEPW.
Configuration and Environment Files
Most AD u tilitie s req uire a cce s s to sys te m p a r a m e te r s s tore d in vario u s co nfigu r a tio n
a n d e nviro n m e n t files w he n p roce s si ng m ai n te n a n ce t a s k s. For exa m ple, it m ay be
n ece s s a ry to k now t he loc atio n of a n Or acle Applic atio n Se rver ORACLE_HOME or t he
D a t a b a se (RDBMS) ORACLE_HOME.
Co nfigu r a tio n a n d e nviro n m e n t files a re ge ne r a te d by AutoCo nfig d u ri ng a n
in s t allatio n or u pgr a de. Yo u typic ally do n o t h ave to m a n u ally u p d a te or m ai n t ai n t he
infor m a tio n in t he se files. They a re u p d a te d w he n yo u r u n AutoCo nfig.
Note: For m o re infor m a tio n, see AutoCo nfig in Oracle E-Business Suite Concepts. See al so
My Or acle S u p po rt Knowledge Doc u m e n t 3 8 7 8 5 9. 1, Using AutoConfig to Manage
System Configurations in Release 12.
The following t a ble list s co nfigu r a tio n a n d e nviro n m e n t files co m mo nly u s e d by t he AD
co m m a n d line u tilities, a n d in so me c a se s, by t he OAM We b-b a se d u tilities.
Note: <CONTEXT_NAME> defa ult s to <SID>_< ho st n a m e>.
AutoCo nfig-Ma n age d AD Utility Files
File name Location Description
a dco nfig.txt $APPL_TOP / Co n t ai n s e nviro n m e n t infor m a tio n u s e d by all AD
a d mi n u tilities.
Warning: Do n o t u p d a te t hi s file m a n u ally.
<CONTEXT_NAME $INST_TOP / U se d to co nfigu re t he e nviro n m e n t w he n

>.e nv (UNIX) or a / 1 0 . 1. 3 pe rfor mi ng m ai n te n a n ce oper a tio n s o n t he
(UNIX) Or acleAS 1 0.1.3 ORACLE_HOME.
<CONTEXT_NAME
>.c m d (Win dow s)
<CONTEXT_NAME RDBMS U se d to co nfigu re t he e nviro n m e n t w he n
>.e nv (UNIX) ORACLE_HO pe rfor mi ng m ai n te n a n ce oper a tio n s o n t he
<CONTEXT_NAME ME d a t a b a se.
>.c m d (Win dow s)
APPS<CONTEXT_N APPL_TOP Na me d APPSORA in e arlier rele a se s, t hi s file c alls
AME>.e nv (UNIX) t he e nviro n m e n t files n ee de d to se t u p t he
APPS<CONTEXT_N APPL_TOP a n d t he Applic atio n s ORACLE_HOME.
AME>.c m d
(Win dow s)
<CONTEXT_NAME APPL_TOP Called by APPS<CONTEXT_NAME>.e nv (UNIX) or
>.e nv (UNIX) APPS<CONTEXT_NAME>.c m d (Win dow s) file to
<CONTEXT_NAME se t u p t he APPL_TO P. This file c alls eit he r
>.c m d (Win dow s) a dovar s.e nv (UNIX) or a dovar s.c m d (Win dow s).
<CONTEXT_NAME $INST_TOP / Called by APPS<CONTEXT_NAME>.e nv (UNIX) or
>.e nv (UNIX) or a / 1 0 . 1. 2 APPS<CONTEXT_NAME>.c m d (Win dow s) to se t
<CONTEXT_NAME u p t he Or acleAS 1 0. 1.2 ORACLE_HOME.
>.c m d (Win dow s)
a dova r s.e nv (UNIX) APPL_TOP / a Called by t he <CONTEXT_NAME>.e nv (UNIX) or
a dova r s.c m d d mi n <CONTEXT_NAME>.c m d (Win dow s) file loc ate d in
(Win dow s) t he APPL_TO P. U se d to se t e nviro n m e n t vari a ble s
for J av a a n d HTML.
The following co nfigu r a tio n a n d e nviro n m e n t files a re al so u s e d by m o s t AD u tilities,
b u t a re n o t cre a te d by AutoCo nfig.
Warning: Do n o t u p d a te a n y of t he se files m a n u ally.
Non-AutoCo nfig AD Utility Files
a p plor a.txt APPL_TOP Co n t ai n s infor m a tio n a bo u t req uire d init.or a p a r a m e te r s
/ a d mi n for r u n ti me.
a p plor a u . txt APPL_TOP Co n t ai n s infor m a tio n a bo u t req uire d init.or a p a r a m e te r s
/ a d mi n for in s t all a n d u pgr a de.
a p plprod.txt APPL_TOP The AD u tilities p ro d u c t de sc riptio n file, u s e d to ide n tify all
/ a d mi n p ro d u c t s a n d p ro d u c t de pe n de ncie s.
a p plter r. txt APPL_TOP The AD u tilities territory de sc riptio n file. It co n t ai n s
/ a d mi n infor m a tio n o n all s u p porte d te rritorie s a n d loc alizatio n s.
fn de n v.e nv FND_TOP Se t s a d ditio n al e nviro n m e n t vari a ble s u s e d by Or acle
Applicatio n Object Libr a r y. The defa ult val ue s s ho uld be
a p plic a ble for all c u s to m e r s.
Feature Version Numbers

In order to u s e so m e AD Admi ni st r a tio n a n d AutoP atc h feat u re s, t he ver sio n n u m b e r
of t he feat u re m u s t be t he s a m e in bo t h t he file sy s te m a n d t he d a t a b a se. There m ay be
ti me s w he n t he se feat u re ver sio n s do n o t m a tc h. For exa m ple, if a p a tc h di d n o t r u n
s u cce s sf ully to co m pletio n, it m ay h ave u p d a te d t he file sys te m, b u t n o t t he d a t a b a se.
In t hi s c a se, t he file sys te m ver sio n a n d t he d a t a b a s e versio n co uld be differe n t.
Whe n yo u s t a r t AD Admi ni str a tio n or AutoP a tc h, a n infor m a tio n m a t rix sc rolls o n t he
sc ree n. It in dic ate s t he s t a t u s (Active=<Ye s or No>) a n d ver sio n n u m b e r s of t he
following feat u re s: CHECKFILE, PREREQ, CONCURRENT_SESSIONS, PATCH_
HIST_IN_DB, PATCH_TIMING, a n d SCHEMA_SWA P.
The m a t rix is for infor m a tio n o nly. No ac tio n is req uire d u nle s s t he feat u re ver sio n s do
n o t m a tc h. If t hey do n o t, yo u c a n u s e t he OAM Applied P atc he s u tility to de ter mi ne
w hic h p a tc he s were a p plied s u cce s sf ully a n d verify t he ver sio n level.
Note: For m o re infor m a tio n, see Applied P atc he s Infor m a tio n in Oracle E-Business Suite
Patching Procedures.
The AD Interface
So me AD u tilitie s a re de signe d to pe rfor m a si ngle fu nc tio n. For exa m ple, yo u r u n AD
Relin k o nly to relin k exec u t a ble s p rogr a m s wit h t he s e rver p ro d u c t libr a rie s. The se
u tilitie s do n o t u s e m e n u s or in p u t s c ree n s. All u s e r inter ac tio n is fro m t he co m m a n d
line in t he for m of p ro m p t s.
Howeve r, ot he r u tilities h ave m ultiple fu nc tio n s, w hic h a re p re se n te d o n m e n u s or
in p u t sc ree n s. For exa m ple, w he n yo u r u n AD Admi ni st r a tio n, t he first sc ree n yo u see
is t he m ai n m e n u .
Fro m t hi s sc ree n, c hoo se o ne of t he s u b m e n u s , a n d t he n fro m t he re, c hoo se t he

p roce s s yo u w a n t to r u n .

Yo u c a n direct t he way t he AD u tilitie s oper a te by a d di ng m o difier s to t he u tility’s s t a r t
co m m a n d. The se m o difiers m ay be in t he for m of a rg u m e n t s, flags, or optio n s. They all
refine t he ac tio n s pe rfor me d by a u tility.
Co m m a n d line a rg u m e n t s, flags, a n d optio n s a re in t he "toke n=val ue" for m a t, w here
toke n is t he n a m e of t he m o difie r. Yo u s ho uld e n ter bot h t he a rg u m e n t a n d t he val ue
in lowerc a se type (the u tility a u to m a tic ally co nvert s t he "toke n" portio n to lowerc a se,
b u t it c a n n o t co nvert t he "val ue").
For exa m ple:
$ adad min LOGFILE=TEST.LOG
The to ke n ("LOGFILE") will be co nverte d to lowerc a se, b u t t he val ue (TEST.LOG) is n o t

recognized by t he u tility. The correct w ay to e n te r t hi s co m m a n d is:
$ adad min logfile=test.log
Yo u c a n e n te r m o re t h a n o ne to ke n=val ue a rg u m e n t o n a si ngle co m m a n d line by

se p a r a ti ng t he m wit h o ne bl a n k s p ace a s in t he following AutoP atc h co m m a n d.
$ adad min printdebug=y flags=hidepw
In so me c a se s, yo u c a n incl u de m o re t h a n o ne val ue for a to ke n . In t hi s c a se, se p a r a te
t he val ue s wit h co m m a s . For exa m ple:
$ adad min flags=nohidepw,trace
Co m m a -se p a r a te d list s m u s t n o t co n t ai n bl a n k s p ace s. For exa m ple, t he following

co m m a n d is n o t valid a n d will give a n error:
$ adad min flags=nohidepw, trace
So me co m m a n d line a rg u m e n t s a re u s e d by sever al u tilitie s a n d a re liste d in t he

following t a ble. Ot he r a rg u m e n t s a re u s e d o nly by a s pecific u tility. For exa m ple,
AutoP atc h m a ke s exte n sive u s e of co m m a n d line a rg u m e n t s a n d optio n s t h a t a re
u niq u e to t h a t u tility. They a re liste d a n d di sc u s se d in Oracle E-Business Suite Patching
Procedures.
AD Utility Co m m a n d Line Argu m e n t s
abandon Description
U se d by AD Admi nis tr a tio n, AutoP a tc h.
P u r po se Tells AD u tilities to a b a n do n a n existi ng n o n -inter ac tive s e s sio n. Ca n be
u s e d o nly w he n inter ac tive= n is al so s pecified.
Val u e s y or n
Defa ult n , m e a ni ng t h a t t he la s t u tility r u n n o n -inter ac tively did n o t s u cce s sf ully
co m plete t he p roce s si ng.
Exa m ple a d a d mi n inter ac tive=n a b a n do n=y
defaultsfile Description
U se d by AD Admi ni st r a tio n, AutoP atc h, AD Co n trolle r.
P u r po se S pecifies t he defa ult s file w hic h s to re s a n swe r s to inter ac tive AD u tility
q u e s tio n s. Nor m ally u s e d n o n -inter ac tively.
Val u e s A fully-q u alified filen a m e. M u s t be u n d e r t he $APPL_ TOP / a d mi n / < SID>
directory.
Defa ult None, m e a ni ng t h a t n o defa ult s file is u s e d.
Exa m ple a dc t rl defa ult sfile= / d 1 / a p p s / p ro d a p pl / a d mi n / p ro d 1 / p ro d_ def.txt
help Description
U se d by All AD u tilities.
P u r po se S u m m a rize s av aila ble co m m a n d line
optio n s.
Val u e s y or n
Defa ult n
Exa m ple a d a d mi n h elp=y
interactive Description
U se d by AD Admi nis tr a tio n, AutoP a tc h, AD Co n t rolle r.
P u r po se Tells AD u tilities w het he r to r u n eit he r inter ac tively or n o n -
inte r ac tively.
Val u e s y or n
Defa ult y, m e a ni ng t h a t t he u tility r u n s in te r ac tively.
Exa m ple a d a d mi n inter ac tive=n
localworkers Description
U se d by AD Admi ni st r a tio n, AutoP atc h.
P u r po se S pecifies t he n u m be r of worker s to r u n o n t he p ri m a ry n o de in a
Distrib u te d AD e nviro n m e n t.
Val u e s 1 to t he m a xi m u m s u p po rte d by yo u r d a t a b a se, b u t n o t m o re t h a n 9 9 9,
incl u sive
Defa ult Defa ult s to t he val ue of t he worker s a rg u m e n t, w hic h m e a n s all worke r s
r u n o n t he p ri m a ry n o de.
Exa m ple a d a d mi n worker s=8 localworker s= 3
logfile Description
U se d by All AD Utilitie s.
P u r po se Tells AD u tilities w h a t log file to u s e. Nor m ally u s e d w he n r u n ni ng a u tility
n o n -inter ac tively.
Val u e s A file n a m e (not a fully-q u alified p a t h n a m e)
Defa ult None, m e a ni ng t h a t t he u tility will p ro m p t for t he log file n a m e.
Exa m ple a dc trl logfile=te s t.log
menu_opti
Description
on
U se d by AD Admi ni st r a tio n, AD Co n t rolle r.
P u r po se Whe n r u n ni ng o ne of t he se u tilities n o n -inter ac tively, u s e d to co n n ect t he
ac tio n s in a defa ult s file wit h a s pecific m e n u ite m.
Val u e s See list of m e n u optio n s in t he de sc riptio n of t he se u tilities. M u s t be u s e d
wit h in te r ac tive=n a n d defa ult sfile=<n a m e of defa ult s file>.
Defa ult N /A
Exa m ple a dc t rl inter ac tive= n defa ult sfile=$APPL_ TOP / a d mi n / p ro d / c t rldefs.txt
m e n u_optio n=SHOW_STATUS
parallel_inde
Description
x_threshold
P u r po se S pecifies t he n u m b e r block s in a t a ble. If a t a ble co n t ai n s fewer block s
t h a n t he t h re s hold se t ti ng, in dexe s a re cre a te d wit h p a r allel worke r s
a n d se ri al DML. If t he t a ble co n t ai n s m o re block s t h a n t he t h re s hold
se tti ng, in dexe s a re cre ate d wit h o ne worker a n d p a r allel DML.
Val u e s 0 to 2 1 4 7 4 8 3 6 4 7; if se t to 0, in dexe s a re cre a te d wit h p a r allel worker s
a n d se ri al DML
Defa ult 2 0 0 0 0; m e a ni ng a t h re s hold of 2 0, 0 0 0 block s
Exa m ple a d a d mi n p a r allel_in dex_t h re s hold=1 5 0 0 0
printdebug Description
P u r po se Tells AD p rogr a m s to di s pl ay extr a de b uggi ng infor m a tio n. In so me
c a se s, t he a m o u n t of extr a de b uggi ng infor m a tio n is s u b s t a n ti al.
Val u e s y or n
Defa ult n
Exa m ple a d a d mi n p ri n t de b ug=y
restart Description
P u r po se Tells AD u tilitie s r u n ni ng n o n -inter ac tively to re s t a r t a n existi ng se s sio n.
O nly valid w he n inter ac tive= n is al so s pecified.
Val u e s y or n
Defa ult n , m e a ni ng t h a t t he u tility r u n ni ng n o n -inter ac tively will expect to r u n a
co m pletely n ew se s sio n.
Exa m ple a d a d mi n inter ac tive= n re s t a r t=y
wait_on_failed_j
Description
ob
P u r po se Direct s t he u tilities to wait for u s e r in p u t in a n o n -in te r ac tive
se s sio n w he n a job fails.
Val u e s y or n
Defa ult n
Exa m ple a d a d mi n w ait_o n_failed_job=ye s
workers Description
P u r po se S pecifies t he n u m b e r of worke r s to r u n . Nor m ally u s e d w he n r u n ni ng t he
u tility n o n -in te r ac tively.
Val u e s 1 to t he m a xi m u m s u p porte d by yo u r d a t a b a se, b u t n o t m o re t h a n 9 9 9
Defa ult No, m e a ni ng t h a t t he p rogr a m p ro m p t s for t he n u m b e r of worke r s to r u n
Exa m ple a d a d mi n worke r s=8
AD Flags Argument
The flags= a rg u m e n t is u s e d by all AD u tilities. It p a s se s o ne of sever al ge ne ric flags to
t he u tility. E n te r o ne flag or a co m m a-se p a r a te d list of flags. The defa ult is None.
flags= Argu m e n t O ptio n s
hidepw Description
Defa ult hi de pw
P u r po se Direct s t he u tilities to eit he r hi de or s how p a s swor d s in AD Utility log
files.
Co m m e n t s By defa ult, line s in a n AD u tility log file co n t ai ni ng p a s sword s a re
m o dified to hi de t he p a s sword s.
Whe n n o hi de pw is s pecified, e ac h line co n t ai ni ng hi d de n p a s sword s is
followed by a corre s po n di ng line p refixed wit h HIDEPW:, s howi ng t he
origin al line wit h p a s swor d s.
Exa m ple a d a d mi n flags= no hide pw
logging Description
Defa ult logging
P u r po se Tells t he AD u tility w he t he r to cre a te in dexe s u si ng logging or n ologging.
Co m m e n t s U si ng flags= nologging w he n cre a ti ng in dexe s m ay incre a se pe rfor m a n ce.
Howeve r, flags= nologging m a ke s d a t a b a se m e di a recovery inco m plete
a n d doe s n o t work wit h s t a n d by d a t a b a se s.
Logging is t he defa ult in AutoP a tc h to s u p po rt d a t a b a se m e di a recovery
a n d s t a n d by d a t a b a s e s. We do n o t reco m m e n d u si ng flags= nologging for
p ro d u c tio n sy s te m s u nle s s yo u m a ke a co m plete b ac k u p bot h before a n d
after r u n ni ng AutoP a tc h.
flags= nologging affect s in dexe s cre ate d t h ro ug h ODF o nly, n o t S QL
sc ript s. The XDF u tility alw ays cre a te s in dexe s wit h logging.
Exa m ple a d p a tc h flags=logging
trace Description
Defa ult n o t r ace
P u r po se Tells t he AD u tility w het he r to log all d a t a b a se oper a tio n s to a tr ace file.
Co m m e n t s D a t a b a se tr ace files cre ate d w hile r u n ni ng a n AD u tility m ay ai d
de b ugging. The flags=tr ace optio n cre ate s m ultiple t r ace files for t he AD
u tility a n d t he AD worke r s. A n ew tr ace file is cre a te d e ac h ti me t he AD
u tility or a worker reco n n ec t s to t he d a t a b a s e.
Note t h a t flags=tr ace o nly t r ace s d a t a b a se oper a tio n s inter n al to t he AD
u tility itself. D a t a b a se oper a tio n s in SQL sc ript s or exter n al p rogr a m s
r u n by t he AD u tility a re n o t recor de d by flags=tr ace.
Exa m ple a d a d mi n flags=tr ace
Note: Ma ny AD u tilitie s acce pt a d ditio n al a rg u m e n t s to t ho se liste d. Howeve r, t he se
s ho uld be u s e d o nly u n de r t he explicit directio n of Or acle S u p po rt Se rvice s.
Running AD Utilities
To r u n AD u tilities, se t t he e nviro n m e n t to define t he sy s te m co nfigu r a tio n
p a r a m e ter s. For exa m ple, a u tility m ay req uire t he directory p a t h to t he Applic atio n s
ORACLE_HOME. This p a r a m e te r, a n d ot he r s, m a ke u p yo u r sys te m e nviro n m e n t.
Important: Before se t ti ng t he e nviro n m e n t, Win dow s u s e r s m u s t al so co nfigu re
Win dow s s e rvice s.
O nce yo u h ave poi n te d t he u tility to t he correct e nviro n m e n t, yo u s t a r t it by e n teri ng
t he u tility n a m e.
Note: See Co nfigu r a tio n a n d E nviro n m e n t Files in t hi s c h a p te r.
Setting the Environment
To se t t he Or acle E-B u si ne s s S uite e nviro n m e n t, co m plete t he following s te p s. See t he
Oracle Installation and Upgrade Notes for a n y a d ditio n al pla tfor m -s pecific s te p s.
1. Log in a s a p pl mgr (Applic atio n s file sys te m ow ner).
2. R u n t he e nviro n m e n t (UNIX) or co m m a n d (Win dow s) file for t he c u r re n t APPL_
TOP a n d d a t a b a s e.
UNIX:
The e nviro n m e n t file is typic ally APPSCONTEXT_NAME>.e nv, a n d is locate d
u n de r APPL_TO P. Fro m a Bo u r n e, Kor n, or B a s h s h ell, e n ter t he following
co m m a n d:
$ .APPS<C O NTEXT_NA M E >.env
Windows:
U si ng eit he r Win dow s Explorer or t he R u n optio n fro m t he S t a r t m e n u , e n te r t he
co m m a n d:
% APPL_TOP %\envshell.cmd
This cre a te s a co m m a n d win dow wit h t he req uire d e nviro n m e n t se tti ngs for
Or acle E-B u si ne s s S uite. All s u b se q u e n t co m m a n d s s ho uld be r u n in t hi s
win do w.
3. If yo u h ave m a d e a ny c h a n ge s to t he e nviro n m e n t, c hec k t h a t it is correctly se t
by e n teri ng t he following co m m a n d s:
UNIX:
$ echo $T W O_TASK
$ echo $ORACLE_HO M E
$ echo $PATH
Windows:
C:\> echo % L O CAL %
C:\> echo % O RACLE_HO M E %
C:\> echo %PATH %
C:\> echo % APPL_CO NFIG %
For UNIX, t he ORACLE_HOME m u s t be se t to t he p ro per d a t a b a se directory,

a n d TWO_TASK or LOCAL m u s t ide n tify t he correct d a t a b a se. For Win dow s,
APPL_ CONFIG m u s t be se t to <CONTEXT_NAME>.
4. E n s u re t h a t t he re is s ufficie n t te m po r a ry di s k s p ace.
Yo u s ho uld h ave a t lea s t 5 0 MB in t he te m po r a ry directorie s de note d by
$APPLTMP a n d $APPLPTMP (UNIX), or %APPLTMP% a n d %APPLPTMP%
(Win dow s). Yo u s ho uld al so h ave s p ace in t he oper a ti ng sy s te m’s defa ult
te m por a ry directory, w hic h is u s u ally / t m p or / u s r / t m p (UNIX) or C: \ t e m p
(Win dow s).
5. If yo u a re r u n ni ng a n AD u tility to relin k or u p d a te Or acle E-B u si ne s s S uite
p ro d u c t files or m o dify Or acle E-B u si ne s s S uite d a t a b a se object s, s h u t dow n t he
co nc u r re n t m a n age r, We b se rver liste ne r s, for m s s e rver liste ne r s if t he files a re
o n a n o de t h a t co n t ai n s t he a s sociate d se rver s. For exa m ple, if t he files a re o n
t he n o de t h a t co n t ai n s t he co nc u r re n t p roce s si ng se rve r, s h u t dow n t he
co nc u r re n t m a n age r s.
Note: For m o re infor m a tio n, s ee Additio n al Infor m a tio n: See Admi ni ster
Co nc u r re n t Ma n ager s in Oracle E-Business Suite System Administrator’s Guide -
Configuration.
6. E n a ble Mai n te n a n ce m o de if t he m ai n te n a n ce t a s k req uire s sys te m dow n ti me.
Note: For m o re infor m a tio n, s ee U si ng Mai n te n a n ce Mode in C h a p te r 4.
Configuring Windows Services
If yo u a re r u n ni ng AD u tilitie s o n a Win dow s pl atfor m, yo u m u s t first s h u t dow n all
for m s se rvice s, We b liste ne r s e rvice s, a n d co nc u r re n t m a n ager se rvice s. In a d ditio n,
yo u m u s t verify t h a t t he d a t a b a s e a n d d a t a b a se liste ne r s a re r u n ni ng.
To view a n d c h a n ge t he s t a t u s of a s e rvice, follow t he se s te p s:
1. Select S t a r t > Se tti ngs > Co n t rol Pa n el, a n d do u ble-click o n Services.
2. Highligh t t he a p p ro p ri ate s e rvice n a m e a n d click S top or S t a r t a s a p p ro pri ate.
The following t a ble list s t he se rvice s a n d s t a t u s req uire d w he n r u n ni ng a n AD
u tility:
Win dow s Se rvice s a n d AD Utility S t a t u s Req uire me n t s
Service Type Service Name Status
Co nc u r re n t Ma n ager Or acleCo ncMgr<CONTEXTNAME> S to p pe d
Services
D a t a b a se Service s Or acleService<SID> S t a r te d
D a t a b a se Liste ne r Or acle<SID>_<DB_VERS>RDBMSTNSListe S t a r te d
n e r<SID>
Starting a Utility
To s t a r t a n AD u tility, e n te r t he u tility’s exec u t a ble n a m e o n t he co m m a n d line. For
exa m ple, to s t a r t AD Admi ni st r a tio n, yo u wo uld e n ter t he co m m a n d:
$ adad min
Note: For m o re infor m a tio n, see Co m m a n d Line Utilitie s in t hi s c h a p te r for a list of AD

exec u t a ble s.
Exiting or Stopping a Utility
Whe n m e n u - d rive n u tilities co m plete a p roce s si ng t a s k, t hey ret u r n yo u to t he m ai n
m e n u , w he re yo u eit he r c hoo se a no t he r p roce s s or Exit. AD Admi ni str a tio n is a n
exa m ple. Ot he r u tilities do n o t u s e a m e n u for m a t. In t hi s c a se, t he u tility exits
a u to m a tic ally w he n p roce s si ng is co m plete. AutoP a tc h, AD Merge P atc h, a n d File
C h a r ac ter Set Co nverte r File Character Set Converter a re exa m ple s.
Before it begi n s p roce s si ng t a s k s, yo u c a n s to p a u tility by e n te ri ng a bo rt a t a n y
p ro m p t. Yo u c a n u s e t hi s co m m a n d o nly for u tilities t h a t di s play p ro m p t s, a n d o nly
w he n a p ro m p t is di s played o n t he s c ree n.
In so me c a se s, a u tility m ay begi n t he p roce s si ng ac tio n s, b u t q uit s before t he ac tio n s
a re co m plete (bec a u se of a n error). O r, d u ri ng a p a r allel p roce s si ng s e s sio n, yo u m ay
decide to s to p t he p roce s si ng ac tio n s by s h u t ti ng dow n t he worker s.
Note: For m o re infor m a tio n, see Tro u ble s hooti ng in Oracle E-Business Suite Maintenance
Procedures for a d ditio n al de t ails a bo u t s h u t ti ng dow n a n d re s t a r ti ng worker s.
Restarting a Utility
Yo u c a n re s t a r t a u tility by e n te ri ng t he exec u t a ble n a m e o n t he co m m a n d line. Whe n
yo u re s t a r t, t he u tility p ro m p t s yo u to e n te r a n ew log file, or to s pecify t he log file fro m
t he interr u p te d se s sio n. Whe n yo u re u se t he log file fro m a p revio u s se s sio n, t he u tility
a d d s t he m e s s age “Start of s e s sio n” to t he e n d of t he file a n d a p pe n d s
m e s s age s fro m t he co n ti n u e d se s sio n a s it ge ne r a te s t he m .
The u tility p ro m p t s yo u to do o ne of t he following:
• Continue Session (the default)
The u tility c hec k s t he p rogre s s of t he p revio u s se s sio n in t he re s t a r t files, a n d
begin s p roce s si ng a t t he poi n t w here yo u r la s t s e s sio n s to p pe d.
• Start New Session
The u tility a s k s yo u to co nfir m yo u r c hoice if yo u c hoo se n o t to co n ti n u e t he
p revio u s se s sio n. It s t a r t s t he p roce s s fro m t he begi n ni ng.
If t he p roce s s t h a t s to p pe d w a s r u n ni ng in p a r allel, a FND_INSTALL_PROCES S ES
t a ble m ay exist. If it doe s, t he u tility a s k s if yo u w a n t to d ro p t he t a ble. This m e s s age
se rve s a s a w ar ni ng to m a ke yo u aw a re of t he existi ng AD se s sio n. Deter mi ne if a ny
ot he r u tility is r u n ni ng in a n o t he r se s sio n or o n a n o t he r n o de. If yo u a re s u re t h a t t he
AD u tility t h a t is c u r re n tly r u n ni ng is n o t n ee de d, yo u c a n d ro p t he FND_INSTALL_
PROCES S E S t a ble a n d co n ti n u e wit h t he n ewer AD se s sio n t h a t yo u s t a r te d.
Note: For m o re infor m a tio n, see Rest a r t Files in t hi s c h a p te r.
Using Parallel Processing

Processing Tasks in Parallel
P ar allel p roce s si ng is typic ally u s e d by AD Admi ni st r a tio n a n d AutoP a tc h to:
• Co m pile invalid object s.
• R u n d a t a b a s e d river t a s k s, s u c h a s S QL sc ript s.
• Ge ner a te vario u s ki n d s of files, s u c h a s for m s, re port, a n d m e s s age files.
Wor ke r s co m plete p roce s si ng t a s k s a s signe d to t he m by t he m a n age r. The u tilities
t he m selves de te r mi ne t he list of t a s k s to be pe rfor me d a n d p rioritize t he m for
exec u tio n. They al so p ro m p t for t he n u m b e r of worke r s to pe rfor m t he t a s k s. For
exa m ple, w he n AutoP a tc h is a p plyi ng a d a t a b a se d rive r, it cre ate s a list of d a t a b a s e
t a s k s a n d p ro m p t s yo u to s pecify t he n u m b e r of worke r s t h a t s ho uld r u n co nc u r re n tly
to exec u te t he se t a s k s.
The worke r p roce s se s a re in s t a n ce s of t he a dwor ke r p rogr a m . This p rogr a m c a n o nly
be c alled by t he m a n age r p roce s se s, a n d c a n n o t be r u n s t a n d -alo ne.
Managers
The m a n ager a s sign s e ac h worke r a u niq u e ID a n d in se rt s a row for e ac h worke r in t he
FND_INSTALL_PROCES S E S t a ble. It cre ate s t hi s t a ble to se rve a s a s t agi ng a re a for
job infor m a tio n, a n d a s a way to co m m u nic a te wit h t he worke r. Co m m u nic a tio n is
a cco m plis he d u si ng two col u m n s: CONTROL_CODE a n d STATUS.
The m a n ager u p d a te s t he t a ble wit h a s u b se t of t he list of job s, o ne job pe r worke r. For
exa m ple, if t he re a re five worker s, t he n t he t a ble h old s five job s (even t ho ug h t he re
m ay be 1 0 0 or m o re job s involved in t he co m plete a c tio n). The m a n age r s t a r t s t he
worke r s a n d u s e s t he CONTROL_CODE a n d STATUS col u m n s to a s sign t a s k s. It polls
t he se two col u m n s co n ti n uo u sly, looki ng for u p d a te s fro m t he worker s. As a worker
finis he s its a s sign m e n t, t he m a n ager u p d a te s e ac h row wit h t he n ext t a s k in t he list,
a n d leave s a n o t he r m e s s age for t he worke r.
O nce all job s a re co m plete, t he m a n ager tells t he worker s to s h u t dow n, a n d t he n
d ro p s t he FND_INSTALL_PROCESS ES t a ble (after it is s u re all worker s h ave ac t u ally
s h u t dow n).
Workers
E ac h worker u p d a te s t he S TATUS col u m n , giving t he m a n ager a re port o n its
p rogre s s. As t he jobs a re co m plete d, t he m a n age r u p d a te s t he t a ble wit h t he n ext job
in t he q u e u e, a n d u p d a te s t he CONTROL_CODE a n d STATUS col u m n s telling t he
worke r to s t a r t p roce s si ng. If t he re is a failu re, t he worke r re port s a failed s t a t u s .
For cert ai n t a s k s, so m e worker p roce s se s s p aw n ot he r c hild p roce s se s t h a t do t he
a c t u al work. The s p aw n e d c hild p roce s s ret u r n s a s t a t u s code to t he worke r t h a t
s p aw n e d it. The worker inter p ret s t he code to de te r mi ne if t he job h a s bee n co m plete d
s u cce s sf ully. Exa m ple s of c hild p roce s se s a re S QL*Plu s a n d FNDLOAD.
Deferred Jobs
The first ti me a job fails, t he m a n age r a u to m a tic ally defer s t he job a n d a s sign s a n ew
o ne to t he worke r. If t he deferre d job fails t he seco n d ti me it is r u n , t he m a n age r defer s
it ag ai n o nly if t he tot al r u n ti me of t he job is les s t h a n te n mi n u te s. If t he deferre d job
fails a t hir d ti me (or if t he job’s tot al r u n ti me is n o t les s t h a n te n mi n u te s t he seco n d
ti me it is r u n) t he job s t ay s a t failed s t a t u s a n d t he worke r wait s. At t hi s poi n t, yo u
m u s t a d d re s s t he c a u s e of t he failu re, a n d t he n re s t a r t t he job.
Note: For m o re infor m a tio n, see R u n ni ng AD Co n t roller Inte r ac tively in t hi s c h a p te r.
See al so Tro u ble s hooti ng in Oracle E-Business Suite Maintenance Procedures .
The deferre d job feat u re u s e s t he AD_DEF ERRED_ J OBS t a ble. This t a ble is cre ate d
w he n t he FND_INSTALL_PROCES S E S t a ble is cre a te d, a n d is d ro p pe d w he n t he
FND_INSTALL_PROCES S E S t a ble is d ro p pe d.
Determining Number of Workers

The AD u tilities p rovide a defa ult n u m be r of worker s of twice t he n u m b e r of CPU s o n
t he d a t a b a se se rve r. Or acle reco m m e n d s yo u c hoo se a n u m b e r of worke r s be twee n 2-4
ti me s t he n u m b e r of CPU s. For exa m ple, if t he re a re fou r CPU s o n t he d a t a b a s e s e rve r,
yo u s ho uld c hoo se so m e t hi ng in t he r a nge of 8-1 6 worke r s.
The AD u tilities c alc ul ate a m a xi m u m n u m be r of worker s t h a t yo u r d a t a b a se c a n
s u p po rt (up to 9 9 9). Yo u c a n no t e n te r a n u m b e r of worke r s gre ater t h a n t he d a t a b a se
c a n s u p port.
Worker Log Files

In a d ditio n to t he infor m a tio n recor de d in t he .log file, u tilities t h a t
p roce s s job s in p a r allel write de t ails a bo u t error s to worker log files. The
a dwork< n u m be r>.log files (adwork 0 0 1.log, a dwork 0 0 2.log...) re side in t he $APPL_
TOP / a d mi n / < SID> / log directory, w here <SID> is t he val ue of t he ORACLE_SID or
TWO_TASK varia ble (UNIX), or in %APPL_TOP% \ a d mi n \ < SID> \ log, w he re <SID> is
t he val ue of ORACLE_SID or LOCAL (Win dow s).
Co nc u r re n t req u e s t s r u n by AutoP atc h a n d AD Admi ni st r a tio n cre a te t heir ow n log
files.
Note: For m o re infor m a tio n, see Log a n d O u t p u t File n a m e s in Oracle E-Business Suite
Worker Restart Files
Rest a r t files a re u s e d to co n ti n u e p roce s si ng a t t he poi n t w here it s to p pe d. E ac h
worke r m ay al so h ave a re s t a r t file c alled a dworkxxx.rf9. The se files a re s to re d in
$APPL_TOP / a d mi n / < SID> / r e s t a r t (UNIX) or in %APPL_TOP% \ a d mi n \ < SID> \ r e s t a r t
(Win dow s). The worker cre a te s t he re s t a r t file w he n t he m a n age r a s sign s it a job, a n d
delete s t he re s t a r t file w he n it finis he s t he job.
Caution: Do n o t m o dify or delete a n y m a n ager or worker re s t a r t files u nle s s explicitly
told to do so by Or acle S u p port Services.
The Tro u ble s hooti ng c h a p te r in Oracle E-Business Suite Maintenance Procedures
di sc u s se s vario u s error sit u a tio n s w he n r u n ni ng a u tility a n d how to re solve t he m .
Parallel Support for Data Manipulation Language (DML)

To re d u ce dow n ti me w he n cre a ti ng in dexe s, t he p a r allel_in dex_t h re s hold a rg u m e n t
for AD u tilities is se t to a defa ult val ue of 2 0, 0 0 0. This m e a n s t h a t if a t a ble co n t ai n s
les s t h a n 2 0, 0 0 0 block s, t he AD u tilities cre a te in dexe s wit h p a r allel worke r s a n d
se ri al DML (ju s t a s in e arlier rele a se s). If a t a ble co n t ai n s 2 0, 0 0 0 block s or m o re,
in dexe s a re n ow cre a te d wit h o nly o ne worker a n d p a r allel DML. Yo u c a n a dj u s t t hi s
t h re s hold val ue by s pecifying t he p a r allel_in dex_t h re s hold a rg u m e n t o n t he AD u tility
co m m a n d line.
Monitoring and Controlling Parallel Processes

AD se s sio n s t h a t u s e p a r allel p roce s si ng m ay r u n to co m pletio n wit ho u t u s e r
inte rve n tio n. Howeve r, it is ofte n u s ef ul to de ter mi ne how m a n y job s h ave bee n
co m plete d or w het he r p roce s si ng h a s s to p pe d for so m e re a so n . AD Co n t roller is a
u tility t h a t yo u c a n u s e to de te r mi ne t he s t a t u s of AD Admi ni st r a tio n or AutoP atc h
worke r s a n d to co n trol t heir ac tio n s. Yo u c a n r u n AD Co n t roller inter ac tively or n o n -
inte r ac tively. It m u s t be r u n in its ow n win do w, n o t in t he s a m e win dow a s AD
Admi ni str a tio n or AutoP a tc h.
Note: For m o re infor m a tio n, see Inter ac tive a n d Non-Inter ac tive Proce s si ng in t hi s
c h a p te r.
Yo u c hoo se optio n s t h a t di s play worker s t a t u s, re s t a r t worke r s, or is s u e co m m a n d s to
t he m a n ager fro m t he AD Co n t roller m ai n m e n u .
Running AD Controller Interactively

Follow t he se s te p s to acce s s AD Co n t rolle r.
1. Log in a s a p pl mgr a n d se t t he e nviro n m e n t a s de sc ribe d in Setti ng t he
E nviro n m e n t in t hi s c h a p te r.
2. S t a r t AD Co n t roller wit h t he a dc t rl co m m a n d. This will p ro m p t yo u to:
• Co nfir m t he val ue of APPL_TO P.
• S pecify a n AD Co n troller log file (the defa ult is a dc trl.log). The AD
Co n t roller log file is writte n in t he c u r re n t worki ng directory.
• S u p ply t he Or acle Applicatio n O bject Libr a ry u s e r n a m e a n d p a s sword.
3. C hoo se a n optio n fro m t he m ai n m e n u .
O nce yo u re s po n d to t he p ro m p t s, t he m ai n m e n u a p pe a r s.
AD Controller Menu
Type a n u m be r to s elect a n optio n. Pre s s [Ret u r n] a t a ny ti me to re t u r n to t he AD

Co n t roller m ai n m e n u .
Note: See Tro u ble s hooti ng in Oracle E-Business Suite Maintenance Procedures for
in s t r u c tio n s o n u si ng e ac h m e n u optio n.
Running AD Controller Non-Interactively

Yo u c a n r u n AD Co n t roller wit ho u t u s e r in te rve n tio n by cre ati ng a defa ult s file, w hic h
c a p t u re s infor m a tio n yo u s u p ply a t t he inter ac tive p ro m p t s in a file t h a t yo u c a n late r
u s e to r u n AD Co n t roller wit ho u t u s e r interve n tio n. Cre a ti ng a defa ult s file a n d
r u n ni ng AD Co n troller n o n -inte r ac tively work s in m u c h t he s a m e w ay a s it doe s for AD
Admi ni str a tio n.
Note: For m o re infor m a tio n, see Sc he d uli ng Non-In te r ac tive Mai n te n a n ce in Oracle E-
Business Suite Maintenance Procedures.
Like AD Admi nist r a tio n, t he s a m e defa ult s file c a n be u s e d to r u n differe n t AD
Co n t roller co m m a n d s: a si ngle file c a n co n t ai n all yo u r c hoice s for t he differe n t m e n u
optio n s. In orde r to c hoo se w hic h t a s k t he defa ult s file will r u n , yo u a d d m e n u_
optio n= <me n u c hoice> to t he u tility s t a r t co m m a n d. Thi s override s a n y m e n u - s pecific
key s t ro ke infor m a tio n s to re d in t he defa ult s file initially, a n d allows yo u to u s e t he
defa ult s file for a ny of t he AD Co n t roller m e n u ite m s. It al so e n s u re s t h a t t he m e n u
optio n yo u inte n de d for t he defa ult s file is alw ays valid, eve n it t he m e n u ite m s a re
re n u m be re d or reloc ate d in s u b se q u e n t rele a se s.
The av ailable optio n s a re liste d in t he following t a ble.
AD Co n t roller Me n u O ptio n s
Menu Option Effect
ACKNOWLEDGE_QUIT Tell m a n ager t h a t a worke r ac k nowledge s
q uit
INFORM_FAILURE Tell m a n ager t h a t a worke r failed its job
RESTART_ JOB Tell worker to re s t a r t a failed job
SHOW_STATUS S how worker s t a t u s
SHUTDOWN_WORKER Tell worker to q uit
S TART_WORKER Re st a r t a worke r o n t he c u r re n t m a c hi ne
Note: The m e n u optio n s for r u n ni ng AD Admi ni st r a tio n a re liste d in Pre p a ri ng for Non-
Inter ac tive Proce s si ng in C h a p te r 4 .
The following is a n exa m ple of r u n ni ng AD Co n t roller n o n -inter ac tively to s how worker
s t a t u s:
$ adctrl interactive=n defaults_file=$APPL_TOP/admin/prod/ctrldefs.txt \
logfile=adctr.log menu_option=S H O W_STATUS
U si ng a ny m e n u optio n o n t he co m m a n d line, exce pt for SHOW_STATUS, req uire s

t h a t yo u al so u s e t he worker_ r a nge=<r a nge> optio n. See t he AD Co n troller co m m a n d
line h elp for de t ails.
Distributing Processing Tasks Across Nodes

AD u s e s its existi ng m a n age r-worker job sy s te m e m ployed in p a r allel p roce s si ng to
incl u de Dist rib u te d AD. This p a r allel p roce s si ng feat u re allows worker s in t he s a m e
AD se s sio n to be s t a r te d o n m u ltiple a p plicatio n tier s e rver s to u tilize all av aila ble
re so u rce s. Bec a u s e t he AD worker s cre a te a n d u p d a te file sy s te m object s, a s well a s
d a t a b a s e object s, Distrib u te d AD m u s t be u s e d o nly o n sy s te m s t h a t a re u si ng a
s h a re d a p plic atio n tier file sys te m to e n s u re t he files a re cre ate d in a si ngle,
ce n tr alized locatio n.
While r u n ni ng eit he r AD Admi ni str a tio n or AutoP a tc h o n t he p ri m a ry n o de, yo u s t a r t
a n AD Co n t roller se s sio n fro m a ny of t he n o de s in t he s h a re d a p plicatio n tier file
sy s te m e nviro n m e n t to pe rfor m a ny s t a n d a r d AD Co n t roller oper a tio n, u si ng bo t h
loc al a n d n o n -loc al worker s.
Note: For m o re infor m a tio n, see Distrib u ti ng Proce s si ng Ta s k s in Oracle E-Business
Suite Maintenance Procedures.
OAM Web-Based Utilities

Or acle Applicatio n s Ma n ager (OAM) is a We b-b a se d m a n age me n t tool t h a t allows yo u
to u s e a n d a cce s s m a n y m ai n te n a n ce u tilities t h a t were for me rly av aila ble o nly o n t he
co m m a n d line, a n d m a ke s it po s sible to q uic kly retrieve a n d di s pl ay sy s te m -s pecific
infor m a tio n in a GUI for m a t. E ac h u tility in OAM is a cce s se d fro m a m ai n p age, w hic h
co n t ai n s lin k s to m u ltiple layer s of de t ails t h a t q uic kly p u t yo u in to u c h wit h all
a s pect s of yo u r sys te m d a t a. For exa m ple, u si ng t he P atc h Wizar d u tility, yo u c a n
a cce s s a dow nlo a de d list of reco m m e n de d p a tc he s a n d view t he effect o n yo u r file
sy s te m of a p plying a n y or all of t he p a tc he s.
In a d ditio n to re porti ng re s ult s b a se d o n s pecific se a rc h criteri a, m a n y OAM u tilities
c a n be u s e d to e n te r a n d s ave c h a nge s to yo u r sy s te m co nfigu r a tio n. For exa m ple,
u si ng Lice n se Ma n age r, yo u c a n registe r p ro d u c t s t h a t were n o t a c tive in yo u r initial
in s t allatio n. O r, wit h AutoCo nfig, yo u c a n view c u r re n t co nfigu r a tio n p a r a m e ter s a n d
m o dify t he existi ng val ue s.
Note: For m o re infor m a tio n, see C h a p te r 7 of Oracle E-Business Suite Concepts.
Common OAM Operations

The OAM We b-b a se d u tilitie s a re de signe d wit h t he s a m e look a n d feel, m a ki ng
exte n sive u s e of co m mo n oper a tio n s s u c h a s u nifor m n avigatio n tools a n d d rill-dow n
m e n u s . For exa m ple, all p age s p re se n t a Help lin k t h a t ope n s a p age-s pecific OAM
h elp sc ree n.
In a d ditio n, OAM u tilities e m ploy a powerf ul se a rc h feat u re, w hic h di s plays t he se a rc h
re s ult s directly o n t he p age w here yo u initiate d t he se a rc h. There is n o n ee d to review
log files or look in a file directory for t he re port. For exa m ple, u si ng t he Applied P atc he s
u tility, yo u c a n pe rfor m a si m ple se a rc h for all t he p a tc he s t h a t h ave bee n a p plied to
yo u r sys te m . OAM di s plays t he re s ult s o n t he Si m ple Se a rc h p age.
The Applications Navigator and the OAM Dashboard and Site Map
Yo u c a n a cce s s OAM fu nc tio n ality in sever al w ays. Yo u begi n fro m t he Navigato r,
w hic h is t he first p age yo u e nco u n te r w he n yo u log in fro m t he OAM Welco me p age.
After yo u c hoo se fro m t he list of re s po n si bilities t h a t define yo u r role for u si ng Or acle
E-B u si ne s s S uite, t he Navigator p re se n t s a list of optio n s u n d e r s ever al h e a di ngs,
b a se d o n yo u r Applic atio n s u s e r role. For exa m ple, t he Sys te m Admi nist r a tio n role
p rovide s a p a t h to t he sever al gro u p s of optio n s, incl u di ng t he Or acle Applic atio n s
Ma n ager a n d relate d u tilities.
The is t he m ai n OAM p age. It p rovide s a "sn a p s ho t" of yo u r sy s te m ac tivity a n d a d ro p-
dow n list to p rovide q uick acce s s to so me of t he m o s t co m mo nly u s e d OAM u tilitie s
a n d t he OAM Site Map. In a d ditio n, it co n t ai n s a lin k to t he OAM Site Map, w hic h
di s plays lin k s to all t he OAM u tilitie s, segregate d o n in divid u al t a b s by fu nc tio n ality.
Page Navigation
Yo u n avigate t h ro ug h OAM p age s o n t he D a s h bo a r d a n d Site Map by clicki ng o n a t a b
t h a t di s pl ays a feat u re s u b se t. O n in divid u al p age s, yo u h ave n avigatio n optio n s, a n d,
w here a p p ro p ri ate, t he re a re d ro p-dow n list s t h a t p rovide lin k s to relate d feat u re s. O n
p age s wit h le ngt hy list s of ite m s, OAM di s plays a s u b se t of t he ite m s for e a sy acce s s.
OAM Interface
The Or acle Applic atio n s Ma n ager D a s h bo a r d p re se n t s a q uic k overview of t he ge ne r al
s t a t u s of yo u r sy s te m . The Site Map p rovide s a cce s s to all t he u tilitie s a n d feat u re s
wit hi n t he OAM fra m ework.
Reviewing System Status
Whe n yo u a cce s s t he OAM D a s h bo a r d, yo u c a n see a ge ner al s u m m a ry of yo u r sys te m
a c tivity.
OAM Dashboard
The OAM D a s h bo a r d se rve s a s a n HTML co n sole, w here sy s te m a d mi ni str a to r s c a n
c hec k t he s t a t u s of t he d a t a b a se, co nc u r re n t m a n ager s a n d ot he r s e rvice s, co nc u r re n t
req u e s t s, a n d Or acle Wor kflow p roce s se s, a s well a s view co nfigu r a tio n infor m a tio n,
s u c h a s initializatio n p a r a m e te r s a n d p rofile optio n s.
The D a s h bo a r d is u s e d in vario u s w ays, m a n y of w hic h a re beyo n d t he sco pe of t hi s
book. The Oracle E-Business Suite System Administrator’s Guide co n t ai n s m o re co m plete
infor m a tio n.
Accessing Maintenance Utilities

Whe n yo u a cce s s t he D a s h bo a r d, yo u c a n u s e t he Navigate To: d ro p-dow n list for
q uick lin k s. Ope n t he list, m a ke a s electio n, a n d click Go.
Navigating in OAM
O r, for a m o re co m plete list of all t he u tilitie s a n d feat u re s incl u de d in OAM, click t he

Site Map lin k.
OAM Site Map
The Site Map p age di s plays t a b s for Admi nist r a tio n, Mo nitori ng, Mai n te n a n ce, a n d
Diagno s tic s a n d Rep ai r. O n in divid u al t a b s, t he re a re lin k s to u tilitie s or fu nc tio n s
u n d e r ge ner al gro u p s. For exa m ple, o n t hi s p age t he re a re h e a di ngs for Sys te m
Co nfigu r a tio n, Applic atio n Se rvice s, Workflow, a n d so o n. U n der t he Mai n te n a n ce t a b,
t he re a re h e a di ngs for P atc hi ng Utilities a n d Critic al Activitie s.
To ope n t he m ai n p age for a u tility, fin d it u n d e r o ne of t he h e a di ngs a n d click t he lin k.
For exa m ple, to view infor m a tio n a bo u t p a tc he s t h a t h ave alre a dy bee n a p plied to yo u r
sy s te m, click Applied P atc he s u n d e r t he P atc hi ng a n d Utilities h e a di ng o n t he
Mai n te n a n ce t a b.
OAM Patching Features
Click a n y of t he ot he r t a b s to acce s s ot he r fu nc tio n s. In t hi s guide, all in s t r u c tio n s for
a cce s si ng OAM We b-b a se d u tilitie s s t a r t fro m t he Site Map.
Accessing OAM
Yo u c a n a cce s s t he OAM Welco me p age after logging into Or acle E-B u si ne s s S uite via
t he following URL:
http:.//<server:port>/OA_HT ML/AppsLogin
Oracle E-Business Suite Welcome Screen

E n te r yo u r u s e r n a m e a n d p a s swor d, a n d click Login. The sy s te m re direct s yo u to t he
Navigator p age, w hic h di s pl ays a n avigatio n p a n e t h a t list s u s e r re s po n sibilitie s. Click
Syste m Admi ni str a tio n.
Oracle E-Business Suite Main Navigation Page
In t he Sys te m Admi ni str a tio n sec tio n, click Or acle Applic atio n s Ma n ager to acce s s t he
D a s h bo a r d. Alter n a tively, yo u c a n sc roll dow n to t he Or acle Applicatio n s Ma n ager
sectio n, w he re t he u tilities a re liste d a s se p a r a te lin k s, a n d c hoo se a u tility (or t he
D a s h bo a r d) fro m t h a t sec tio n.
All t he infor m a tio n in t he Or acle E-B u si ne s s S uite m ai n te n a n ce doc u m e n t a tio n
a s s u m e s t h a t yo u will s t a r t fro m t he D a s h bo a r d > Site Map. The in divid u al u tility
sc ree n s di sc u s se d all relate to p a tc hi ng yo u r Applicatio n s sy s te m . Their fu nc tio n ality
is de sc ribe d fully in Oracle E-Business Suite Patching Procedures.

Rele a se 1 2.1
P ar t Nu m be r E 1 3 6 7 6-0 3 Co n te n t s Previo u s Next
Getting Started
Thi s c h a p te r co n t ai n s b a sic infor m a tio n a bo u t Or acle E-B u si ne s s S uite m ai n te n a n ce
u tilitie s, bo t h co m m a n d line a n d We b-b a se d.
• Or acle E-B u si ne s s S uite Mai n te n a n ce Utilitie s
• Co m m a n d Line Utilities
• R u n ni ng AD Utilitie s
• U si ng P ar allel Proce s si ng
• OAM We b-Ba se d Utilities

Yo u u s e Or acle E-B u si ne s s S uite sy s te m m ai n te n a n ce u tilitie s to pe rfor m a variety of
oper a tio n s fro m in s t alling a n d u pgr a di ng Or acle E-B u si ne s s S uite sy s te m s, to
u p d a ti ng co nfigu r a tio n p a r a m e ter s, to m ai n t ai ni ng a n d p a tc hi ng yo u r d a t a b a se a n d
file sy s te m, to p ro d u ci ng sy s te m re port s.
In t hi s boo k, t he se u tilities h ave bee n c a tegorized by t he way yo u acce s s a n d u s e t he m .
Thi s m ay be fro m t he co m m a n d line, or via a We b-b a se d in te rface.
Tip: As of Rele a se 1 2, all infor m a tio n a bo u t p a tc hi ng a n d AutoP atc h oper a tio n s wa s
m oved to a se p a r a te boo k, Oracle E-Business Suite Patching Procedures .

The tools ge ne r ally referre d to a s Applic atio n s DBA (AD) u tilitie s a re s t a r te d a n d r u n
fro m t he co m m a n d line. They initiate p roce s se s t h a t pe rfor m a variety of sys te m
m ai n te n a n ce t a s k s, s u c h a s a p plyi ng a n d m e rgi ng p a tc he s. As t hey r u n , t he u tilities
p ro m p t yo u for sy s te m -s pecific p a r a m e te r s n ece s s a ry to pe rfor m t he m ai n te n a n ce
t a s k. In a d ditio n, m a ny of t he u tilities p ro d u ce re port s t h a t co n t ai n infor m a tio n s u c h
a s job ti mi ng a n d file versio n s.
The AD u tilities h ave si milar interface s, oper a tio n, in p u t, a n d re port for m a t s. Ma ny
al so s h a re t he a bility to a cce pt a rg u m e n t s, flags, a n d optio n s, w hic h yo u c a n u s e to
refine t he ac tio n s t hey pe rfor m. Yo u a d d t he a rg u m e n t o n t he co m m a n d line w he n yo u
s t a r t t he u tility. For exa m ple, to s pecify t he n u m be r of worker s t h a t AutoP a tc h s ho uld
r u n in p a r allel w he n a p plyi ng a p a tc h, yo u e n te r t he n u m be r of worker p roce s se s o n
t he co m m a n d line w he n yo u s t a r t AutoP atc h. A list of co m mo nly u s e d co m m a n d line
a rg u m e n t s a n d flags, a n d a b rief de sc riptio n of how to u s e t he m, begi n s later in t hi s
c h a p te r.
Exce pt w he re n o te d, t he AD u tilities in t he following t a ble a re de sc ribe d in t hi s book.
AD Co m m a n d Line Utilities
Executable or
AD Utility Name Description
Script
AD Admi nis tr a tio n a d a d mi n Perfor m s m ai n te n a n ce t a s k s for Or acle E-
B u si ne s s S uite.
AD C hec k Dige st a dc h k dig C hec k s t he in tegrity of Or acle E-B u si ne s s S uite
p a tc he s dow nlo a de d fro m My Or acle S u p po rt.
AD Co nfigu r a tio n a d u tco nf.sql Report s s t a n d a r d infor m a tio n a bo u t t he
in s t alled co nfigu r a tio n of Or acle E-B u si ne s s
S uite.
AD Co n t roller a dc trl Ma n age s p a r allel worke r s in AD Admi ni str a tio n
a n d AutoP a tc h.
AD File a di de n t Report s t he ver sio n a n d tr a n sl a tio n level of a n
Ide n tificatio n Or acle E-B u si ne s s S uite file.
AD File C h a r ac te r a d n c nv Co nvert s a file fro m o ne c h a r ac te r se t to
Se t Co nverter a n o t he r.
AD Merge P atc h* a d m rgpc h Merge s m ultiple p a tc he s into a si ngle m e rge d
p a tc h.
AD Relin k a d reli n k. s h Relin k s Or acle E-B u si ne s s S uite exec u t a ble
p rogr a m s wit h t he Or acle se rver p ro d u c t
libr a rie s.
AD S plicer a d s plice Add s off-cycle p ro d u c t s.
AD J o b Ti mi ng Report s a s u m m a ry of t he ti mi ng for job s r u n by
Report p a r allel worke r s.
AutoP atc h* a d p a tc h Applies p a tc he s a n d ot he r sys te m u p d a te s.
P atc h Applicatio n a d m si.pl Ge ne r a te s c u s to mized in s t allatio n in s t r u c tio n s
Assist a n t* for a p a tc h.
R a pid In s t all** r a pidwiz Provide s a wizar d for e n teri ng p a r a m e te r s t h a t
a re s pecific to a n ew in s t allatio n or a n u pgr a de
of a n Or acle E-B u si ne s s S uite sys te m .
*See Oracle E-Business Suite Patching Procedures for co m plete infor m a tio n a bo u t
p a tc he s a n d p a tc h u tilitie s.
**The b a sic oper a tio n of Ra pid In s t all is de sc ribe d h e re. See Oracle E-Business Suite
Installation Guide: Using Rapid Install for co m plete in s t r u c tio n s o n u si ng it to in s t all or
u pgr a de a n Or acle E-B u si ne s s S uite sy s te m .
Web-Based Utilities
Or acle Applicatio n s Ma n ager (OAM) p rovide s a We b-b a se d interface w here sys te m
a d mi ni s tr a tor s c a n m o nitor sys te m s t a t u s, a d mi ni ster se rvice s, exa mi ne sy s te m
co nfigu r a tio n, m a n age Or acle Wor kflow, view a p plied p a tc he s, a n d m e a s u re sys te m
u s age. It p rovide s a co ncise overview of t he s t a te of yo u r Or acle E-B u si ne s s S uite
sy s te m, a n d se rve s a s a gatew ay to u tilitie s for t a s k s s u c h a s m a n agi ng sy s te m
co nfigu r a tio n, reviewing p a tc h hi s tory, de te r mi ni ng w hic h p a tc he s will b ri ng yo u r
sy s te m u p to d a te, registeri ng a d ditio n al p ro d u c t s a n d la ng u age s, a n d ot he r
m ai n te n a n ce a c tivitie s.
The We b-b a se d m ai n te n a n ce u tilitie s a re liste d in t he following t a ble. Their oper a tio n
is de sc ribe d fully in Oracle E-Business Suite Patching Procedures or Oracle E-Business Suite
Or acle Applic atio n s Ma n ager Utilities
OAM Utility Description
Name
Applied U se s key p a tc h infor m a tio n in t he p a tc h hi s tory d a t a b a se. Yo u c a n
P atc he s** se a rc h t he d a t a b a se to cre ate re port s in sever al for m a t s.
AutoCo nfig* U se to view c u r re n t co n text files, edit p a r a m e ter s co n t ai ne d in t he
co n text files, view p revio u s co n text files, a n d co m p a re c u r re n t
co n text files ag ai n s t p revio u s o ne s.
File History** E n a ble s t he viewing of files t h a t h ave bee n u p d a te d by a p a tc h.
Lice n se Register s a d ditio n al Or acle E-B u si ne s s S uite p ro d u c t s, co u n t ry-
Ma n ager* s pecific fu nc tio n alitie s, or la ng u age s. Yo u c a n al so u s e Lice n se
Ma n ager to c h a n ge t he b a se la ng u age for yo u r sys te m.
P atc h Wizar d** Deter mi ne s p a tc he s t h a t h ave n o t bee n a p plied, b u t t h a t s ho uld be
a p plied to kee p t he sy s te m c u r re n t. Dow nloa d s a n d m e rge s p a tc he s
fro m My Or acle S u p port.
Register U se d to recor d a ny files in w hic h yo u h ave m a de c u s to mizatio n s.
Flagged Files** Replace s t he n ee d to u s e a p plc u s t.txt, w hic h co n t ai ne d t he recor d
for all c u s to mized files in p revio u s rele a se s.
Softw are Provide s a n overview of all p a tc hi ng-relate d infor m a tio n for yo u r
Upd a te s** sy s te m .
Ti mi ng Help s yo u m o nitor job s t h a t a re r u n ni ng or view s t a ti s tic s of
Report s** co m plete d AutoP a tc h a n d AD Admi ni str a tio n m ai n te n a n ce se s sio n s.
* See Oracle E-Business Suite System Administrator’s Guide.
** See Oracle E-Business Suite Patching Procedures.
Online Help
Bot h t he AD u tilities a n d t he OAM u tilities p rovide a h elp fu nc tio n.
Command Line Help

For t he AD co m m a n d line u tilitie s, yo u c a n req u e s t a list of a rg u m e n t s by e n te ri ng t he
u tility n a m e wit h h elp=y a p pe n de d. For exa m ple, to acce s s h elp for AD
Admi ni str a tio n, e n te r t he co m m a n d:
adad min help=y
The a rg u m e n t s a n d optio n s t h a t yo u c a n u s e to refine t he oper a tio n of a u tility a re

liste d, alo ng wit h a b rief de sc riptio n of how t hey work. Below is a n exa m ple of t he
co m m a n d line h elp for AD Admi ni str a tio n:
usage: adadmin [help=y]
adadmin
[printdebug=y|n][localworkers=<localworkers>]
[flags=hidepw|trace]
adadmin Non-Interactive mode

[defaultsfile=<$APPL_TOP/admin/SID/defaultsfile>]
[logfile=<logfile>][interactive=y|n]
[workers=workers>][menu_option=ASK_NA M E >][restart=y|n]
w here
Key to options:localworker s = The n u m be r of worker s to r u n o n t he local m a c hi ne. U se d
in Distrib u te d AD.
flags = Ge neric flags p a s se d to AD u tilitie s. The av ailable val ue s for AD Admi n a re
hi de pw a n d tr ace.
defa ult sfile = The defa ult s file filen a m e, locate d u n d e r $APPL_TOP / a d mi n / SID /
directory.
m e n u_optio n = S kip s t he AD Admi n m e n u a n d exec u te s t he t a s k s u p plied o n t he
co m m a n d line. Valid val ue s a re liste d below.
RELINK Relink Applications programs
GE N_ MESSAGES Generate message files
GE N_FOR MS Generate form files
GE N_REPORTS Generate reports files
GE N_JARS Generate product JAR files
VALIDATE_APPS Validate APPS schema
C MP_INVALID Co mpile APPS schema
C MP_ ME N U Co mpile menu information
CREATE_GRA NTS Recreate grants and synonyms for APPS schema
C MP_FLEXFIELDS Co mpile flexfield data in AOL tables
M AINTAIN_ MLS M aintain m ulti-lingual tables
C HECK_DUAL Check D UAL table
RELOAD_JARS Reload JAR files to database
C OPY_FILES Copy files to destinations
C HECK_FILES Check for missing files
LIST_SNAPS H OTS List snapshots
UPDATE_CURRE NT_VIE W Update current view snapshot
CREATE_SNAPSH OT Create named snapshot
EXPORT_SNAPS H OT Export snapshot to file
IMPORT_SNAPS H OT Import snapshot from file
DELETE_SNAPS H OT Delete na med snapshot(s)
C O NVERT_CHARSET Convert character set
SCA N_APPLTOP Scan the APPLTOP for exceptions
SCA N_CUSTO M_DIR Scan a C USTO M directory for exceptions
E NABLE_ MAINT_ M O DE Enable M aintenance M ode
DISABLE_ MAINT_ M O DE Disable M aintenance M ode
Obtaining Help in OAM

OAM Help is av aila ble by clicki ng t he Help lin k in t he to p righ t-h a n d sec tio n of a ny
Or acle Applicatio n s Ma n ager sc ree n.
OAM Site Map and Help Link
For exa m ple, fro m t he OAM Site Map, OAM di s pl ays p age-s pecific h elp de sc ribi ng t he
feat u re s of t he Site Map p age.
OAM Site Map Help Page
In divid u al h elp to pic s m ay incl u de to pic al e s s ays, p roced u re s, a n d p age de sc riptio n s.
The h elp a s sociate d wit h t he u tilities a n d feat u re s di sc u s se d in t hi s book p rovide s
n avigatio n p a t h s, field definitio n s, a n d ge ne r al infor m a tio n a bo u t u si ng t he p age.

The AD m ai n te n a n ce u tilities were developed to pe rfor m s pecific Applic atio n s
m ai n te n a n ce a n d re porti ng t a s k s fro m t he co m m a n d line. For exa m ple, yo u u s e
AutoP atc h to a p ply all type s of p a tc he s to yo u r sy s te m, a n d yo u u s e AD
Admi ni str a tio n to pe rfor m ro u ti ne m ai n te n a n ce t a s k s.
Howeve r, eve n t ho ug h t he u tilitie s e ac h h ave a s peci alized fu nc tio n, t hey a re de signe d
to co m ple me n t e ac h ot he r, so m a n y e m ploy si milar oper a tio n s. Thi s sec tio n
s u m m a rize s t he oper a tio n s t h a t AD u tilitie s h ave in co m mo n. S u b seq u e n t c h a p te r s
de sc ribe e ac h u tility’s feat u re s in de t ail.
Note: See Oracle E-Business Suite Maintenance Procedures for s pecific t a s k s pe rfor m e d
u si ng t he AD u tilities, a n d Oracle E-Business Suite Patching Procedures for infor m a tio n
a bo u t AutoP a tc h a n d AD Merge P atc h.
Common AD Operations
Ma ny AD u tilitie s e m ploy si milar feat u re s a n d oper a tio n s a s t hey pe rfor m p roce s si ng
t a s k s. For exa m ple, m o s t rely o n p ro m p t s to gat he r val ue s for sy s te m -s pecific
p roce s se s, a n d all a u to m a tic ally cre a te log files to recor d p roce s si ng ac tio n s. Thi s
sectio n de sc ribe s so m e of t he se co m mo n oper a tio n s.
Note: See Oracle E-Business Suite Patching Procedures for infor m a tio n a bo u t AD
oper a tio n s t h a t a p ply to AutoP a tc h.
Prompts
Ma ny AD u tilitie s p ro m p t for infor m a tio n n ece s s a ry for co m pleti ng a t a s k. Pro m p t s
typic ally incl u de a de sc riptio n of t he infor m a tio n n ee de d, a n d m ay incl u de a defa ult
a n swer (in s q u a re b r ac ket s). Yo u c a n ju s t p re s s t he [Ret u r n] key to a cce pt t he defa ult.
For exa m ple:
The O RACLE username specified below for Application Object Library
uniquely identifies your existing product group: APPLSYS
Enter the ORACLE password of Application Object Library [APPS] :
Press [Return] to accept the default value, or type a new value

after the colon and press [Return]. Read the prompts carefully
to make sure you supply the correct information.
Interactive and Non-Interactive Processing

The AD u tilities pe rfor m p roce s si ng t a s k s inter ac tively by defa ult. Th a t m e a n s t he
u tility p ro m p t s for sys te m -s pecific infor m a tio n a t t he poi n t w here it n ee d s it, m a ki ng it
n ece s s a ry for yo u to be p re se n t d u ri ng t he e n tire oper a tio n in orde r to re s po n d to t he
p ro m p t s.
AD Admi nis tr a tio n, AutoP a tc h, a n d AD Co n t roller c a n r u n so m e file sys te m a n d
d a t a b a s e t a s k s n o n -inte r ac tively: yo u s to re t he req uire d infor m a tio n in a defa ult s file,
a n d t he u tility re a d s t he infor m a tio n fro m t hi s file in s te a d of p ro m p ti ng yo u for t he
in p u t. Non-inter ac tive p roce s si ng is u s ef ul for sc he d uli ng ro u ti ne t a s k s t h a t req uire
little or n o u s e r inte rve n tio n.
Note: For m o re infor m a tio n, see Perfor mi ng Mai n te n a n ce Ta s k s Non-Inter ac tively in
Oracle E-Business Suite Maintenance Procedures. See al so Mo nitori ng a n d Co n t rolling
P ar allel Proce s se s in t hi s c h a p te r.
Special Parameter for Using AutoPatch and AD Administration Non-Interactively

Whe n r u n ni ng AutoP a tc h, AD Admi ni str a tio n, or AD S plicer in n o n -inter ac tive m o de,
t he "stdi n=y" optio n c a n optio n ally be u s e d to p ro m p t for p a s swor d s in t he s t a n d a r d
in p u t. The defa ult is for p a s sword s to be s u p plied wit ho u t p ro m p ti ng.
Log Files
All AD u tilitie s record t heir p roce s si ng ac tio n s a n d a n y error s t h a t t hey e nco u n te r in
log files. Ma ny u tilities p ro m p t yo u for t he n a m e of t he log file t h a t will recor d t he
p roce s si ng se s sio n, wit h a di s play s u c h a s t hi s:
<utility na me> records your <utility na me> session in a text file you specify.
Enter your < <utility name> log file name or press [Return] to accept the
default na me shown in brackets.
Filename [<utility na me>.log] :
The defa ult file n a m e is .log. For exa m ple, for AD Admi ni st r a tio n, t he
defa ult log file is a d a d mi n.log. For AutoP atc h, it is a d p a tc h.log.
AD Admi nis tr a tio n (an d AutoP a tc h) place t heir log files in t he following loc atio n s:
UNIX:
$APPL_TOP / a d mi n / < SID> / log
Windows:
%APPL_TOP% \ a d mi n \ < SID> \ log
So me u tilitie s m ay n o t p ro m p t yo u for a log file n a m e: in s te a d, t hey will write t he log
file in t he directory fro m w hic h t he u tility wa s r u n .
Restart Files
Rest a r t files co n t ai n infor m a tio n a bo u t w h a t p roce s si ng h a s alre a dy bee n co m plete d.
They a re loc ate d in $APPL_TOP / a d mi n / < SID> / r e s t a r t (UNIX) or in %APPL_ TOP
% \ a d mi n \ < SID> \ r e s t a r t (Win dow s).
If a u tility s to p s d u ri ng p roce s si ng d u e to a n erro r, or yo u u s e AD Co n t roller (in t he
c a se of p a r allel p roce s si ng) to s h u t dow n worke r s w hile t hey a re pe rfor mi ng p roce s si ng
t a s k s, yo u c a n re s t a r t t he u tility. If yo u do, it look s for re s t a r t files to de ter mi ne if t he re
w a s a p revio u s se s sio n. If t he files exist, t he u tility p ro m p t s yo u to co n ti n u e w here t he
p roce s si ng left off, or to s t a r t a n ew p roce s s. If yo u c hoo se to co n ti n u e, it re a d s t he
re s t a r t files to see w here t he p roce s s left off, a n d co n ti n u e s t he p roce s s fro m t h a t
poi n t.
Caution: Do n o t m o dify or delete a n y m a n ager or worker re s t a r t files u nle s s s pecifically
directe d to do so by Or acle S u p port Services.
By defa ult, AD u tilities delete t heir re s t a r t files w he n p roce s si ng is co m plete, b u t leave
b ac k u p ver sio n s wit h t he exte n sio n s .b a k, .bk 2, or .b k 3.
Warning: Rest a r t files recor d p a s sword s for yo u r Or acle E-B u si ne s s S uite p ro d u c t s.
Yo u s ho uld re s t rict a cce s s to all re s t a r t files (locate d in
$APPL_TOP / a d mi n / < SID> / r e s t a r t). If yo u a re r u n ni ng a u tility wit h
optio n s= no hide p w, t he log files m ay al so co n t ai n p a s swor d s o n line s p refixed wit h
HIDEPW.
Configuration and Environment Files
Most AD u tilitie s req uire a cce s s to sys te m p a r a m e te r s s tore d in vario u s co nfigu r a tio n
a n d e nviro n m e n t files w he n p roce s si ng m ai n te n a n ce t a s k s. For exa m ple, it m ay be
n ece s s a ry to k now t he loc atio n of a n Or acle Applic atio n Se rver ORACLE_HOME or t he
D a t a b a se (RDBMS) ORACLE_HOME.
Co nfigu r a tio n a n d e nviro n m e n t files a re ge ne r a te d by AutoCo nfig d u ri ng a n
in s t allatio n or u pgr a de. Yo u typic ally do n o t h ave to m a n u ally u p d a te or m ai n t ai n t he
infor m a tio n in t he se files. They a re u p d a te d w he n yo u r u n AutoCo nfig.
Note: For m o re infor m a tio n, see AutoCo nfig in Oracle E-Business Suite Concepts. See al so
My Or acle S u p po rt Knowledge Doc u m e n t 3 8 7 8 5 9. 1, Using AutoConfig to Manage
System Configurations in Release 12.
The following t a ble list s co nfigu r a tio n a n d e nviro n m e n t files co m mo nly u s e d by t he AD
co m m a n d line u tilities, a n d in so me c a se s, by t he OAM We b-b a se d u tilities.
Note: <CONTEXT_NAME> defa ult s to <SID>_< ho st n a m e>.
AutoCo nfig-Ma n age d AD Utility Files
a dco nfig.txt $APPL_TOP / Co n t ai n s e nviro n m e n t infor m a tio n u s e d by all AD
a d mi n u tilities.
Warning: Do n o t u p d a te t hi s file m a n u ally.
<CONTEXT_NAME $INST_TOP / U se d to co nfigu re t he e nviro n m e n t w he n

>.e nv (UNIX) or a / 1 0 . 1. 3 pe rfor mi ng m ai n te n a n ce oper a tio n s o n t he
(UNIX) Or acleAS 1 0.1.3 ORACLE_HOME.
<CONTEXT_NAME
>.c m d (Win dow s)
<CONTEXT_NAME RDBMS U se d to co nfigu re t he e nviro n m e n t w he n
>.e nv (UNIX) ORACLE_HO pe rfor mi ng m ai n te n a n ce oper a tio n s o n t he
<CONTEXT_NAME ME d a t a b a se.
>.c m d (Win dow s)
APPS<CONTEXT_N APPL_TOP Na me d APPSORA in e arlier rele a se s, t hi s file c alls
AME>.e nv (UNIX) t he e nviro n m e n t files n ee de d to se t u p t he
APPS<CONTEXT_N APPL_TOP a n d t he Applic atio n s ORACLE_HOME.
AME>.c m d
(Win dow s)
<CONTEXT_NAME APPL_TOP Called by APPS<CONTEXT_NAME>.e nv (UNIX) or
>.e nv (UNIX) APPS<CONTEXT_NAME>.c m d (Win dow s) file to
<CONTEXT_NAME se t u p t he APPL_TO P. This file c alls eit he r
>.c m d (Win dow s) a dovar s.e nv (UNIX) or a dovar s.c m d (Win dow s).
<CONTEXT_NAME $INST_TOP / Called by APPS<CONTEXT_NAME>.e nv (UNIX) or
>.e nv (UNIX) or a / 1 0 . 1. 2 APPS<CONTEXT_NAME>.c m d (Win dow s) to se t
<CONTEXT_NAME u p t he Or acleAS 1 0. 1.2 ORACLE_HOME.
>.c m d (Win dow s)
a dova r s.e nv (UNIX) APPL_TOP / a Called by t he <CONTEXT_NAME>.e nv (UNIX) or
a dova r s.c m d d mi n <CONTEXT_NAME>.c m d (Win dow s) file loc ate d in
(Win dow s) t he APPL_TO P. U se d to se t e nviro n m e n t vari a ble s
for J av a a n d HTML.
The following co nfigu r a tio n a n d e nviro n m e n t files a re al so u s e d by m o s t AD u tilities,
b u t a re n o t cre a te d by AutoCo nfig.
Warning: Do n o t u p d a te a n y of t he se files m a n u ally.
Non-AutoCo nfig AD Utility Files
a p plor a.txt APPL_TOP Co n t ai n s infor m a tio n a bo u t req uire d init.or a p a r a m e te r s
/ a d mi n for r u n ti me.
a p plor a u . txt APPL_TOP Co n t ai n s infor m a tio n a bo u t req uire d init.or a p a r a m e te r s
/ a d mi n for in s t all a n d u pgr a de.
a p plprod.txt APPL_TOP The AD u tilities p ro d u c t de sc riptio n file, u s e d to ide n tify all
/ a d mi n p ro d u c t s a n d p ro d u c t de pe n de ncie s.
a p plter r. txt APPL_TOP The AD u tilities territory de sc riptio n file. It co n t ai n s
/ a d mi n infor m a tio n o n all s u p porte d te rritorie s a n d loc alizatio n s.
fn de n v.e nv FND_TOP Se t s a d ditio n al e nviro n m e n t vari a ble s u s e d by Or acle
Applicatio n Object Libr a r y. The defa ult val ue s s ho uld be
a p plic a ble for all c u s to m e r s.
Feature Version Numbers

In order to u s e so m e AD Admi ni st r a tio n a n d AutoP atc h feat u re s, t he ver sio n n u m b e r
of t he feat u re m u s t be t he s a m e in bo t h t he file sy s te m a n d t he d a t a b a se. There m ay be
ti me s w he n t he se feat u re ver sio n s do n o t m a tc h. For exa m ple, if a p a tc h di d n o t r u n
s u cce s sf ully to co m pletio n, it m ay h ave u p d a te d t he file sys te m, b u t n o t t he d a t a b a se.
In t hi s c a se, t he file sys te m ver sio n a n d t he d a t a b a s e versio n co uld be differe n t.
Whe n yo u s t a r t AD Admi ni str a tio n or AutoP a tc h, a n infor m a tio n m a t rix sc rolls o n t he
sc ree n. It in dic ate s t he s t a t u s (Active=<Ye s or No>) a n d ver sio n n u m b e r s of t he
following feat u re s: CHECKFILE, PREREQ, CONCURRENT_SESSIONS, PATCH_
HIST_IN_DB, PATCH_TIMING, a n d SCHEMA_SWA P.
The m a t rix is for infor m a tio n o nly. No ac tio n is req uire d u nle s s t he feat u re ver sio n s do
n o t m a tc h. If t hey do n o t, yo u c a n u s e t he OAM Applied P atc he s u tility to de ter mi ne
w hic h p a tc he s were a p plied s u cce s sf ully a n d verify t he ver sio n level.
Note: For m o re infor m a tio n, see Applied P atc he s Infor m a tio n in Oracle E-Business Suite
Patching Procedures.
The AD Interface
So me AD u tilitie s a re de signe d to pe rfor m a si ngle fu nc tio n. For exa m ple, yo u r u n AD
Relin k o nly to relin k exec u t a ble s p rogr a m s wit h t he s e rver p ro d u c t libr a rie s. The se
u tilitie s do n o t u s e m e n u s or in p u t s c ree n s. All u s e r inter ac tio n is fro m t he co m m a n d
line in t he for m of p ro m p t s.
Howeve r, ot he r u tilities h ave m ultiple fu nc tio n s, w hic h a re p re se n te d o n m e n u s or
in p u t sc ree n s. For exa m ple, w he n yo u r u n AD Admi ni st r a tio n, t he first sc ree n yo u see
is t he m ai n m e n u .
Fro m t hi s sc ree n, c hoo se o ne of t he s u b m e n u s , a n d t he n fro m t he re, c hoo se t he

p roce s s yo u w a n t to r u n .

Yo u c a n direct t he way t he AD u tilitie s oper a te by a d di ng m o difier s to t he u tility’s s t a r t
co m m a n d. The se m o difiers m ay be in t he for m of a rg u m e n t s, flags, or optio n s. They all
refine t he ac tio n s pe rfor me d by a u tility.
Co m m a n d line a rg u m e n t s, flags, a n d optio n s a re in t he "toke n=val ue" for m a t, w here
toke n is t he n a m e of t he m o difie r. Yo u s ho uld e n ter bot h t he a rg u m e n t a n d t he val ue
in lowerc a se type (the u tility a u to m a tic ally co nvert s t he "toke n" portio n to lowerc a se,
b u t it c a n n o t co nvert t he "val ue").
For exa m ple:
$ adad min LOGFILE=TEST.LOG
The to ke n ("LOGFILE") will be co nverte d to lowerc a se, b u t t he val ue (TEST.LOG) is n o t

recognized by t he u tility. The correct w ay to e n te r t hi s co m m a n d is:
$ adad min logfile=test.log
Yo u c a n e n te r m o re t h a n o ne to ke n=val ue a rg u m e n t o n a si ngle co m m a n d line by

se p a r a ti ng t he m wit h o ne bl a n k s p ace a s in t he following AutoP atc h co m m a n d.
$ adad min printdebug=y flags=hidepw
In so me c a se s, yo u c a n incl u de m o re t h a n o ne val ue for a to ke n . In t hi s c a se, se p a r a te
t he val ue s wit h co m m a s . For exa m ple:
$ adad min flags=nohidepw,trace
Co m m a -se p a r a te d list s m u s t n o t co n t ai n bl a n k s p ace s. For exa m ple, t he following

co m m a n d is n o t valid a n d will give a n error:
$ adad min flags=nohidepw, trace
So me co m m a n d line a rg u m e n t s a re u s e d by sever al u tilitie s a n d a re liste d in t he

following t a ble. Ot he r a rg u m e n t s a re u s e d o nly by a s pecific u tility. For exa m ple,
AutoP atc h m a ke s exte n sive u s e of co m m a n d line a rg u m e n t s a n d optio n s t h a t a re
u niq u e to t h a t u tility. They a re liste d a n d di sc u s se d in Oracle E-Business Suite Patching
Procedures.
abandon Description
P u r po se Tells AD u tilities to a b a n do n a n existi ng n o n -inter ac tive s e s sio n. Ca n be
u s e d o nly w he n inter ac tive= n is al so s pecified.
Val u e s y or n
Defa ult n , m e a ni ng t h a t t he la s t u tility r u n n o n -inter ac tively did n o t s u cce s sf ully
co m plete t he p roce s si ng.
Exa m ple a d a d mi n inter ac tive=n a b a n do n=y
defaultsfile Description
P u r po se S pecifies t he defa ult s file w hic h s to re s a n swe r s to inter ac tive AD u tility
q u e s tio n s. Nor m ally u s e d n o n -inter ac tively.
Val u e s A fully-q u alified filen a m e. M u s t be u n d e r t he $APPL_ TOP / a d mi n / < SID>
directory.
Defa ult None, m e a ni ng t h a t n o defa ult s file is u s e d.
Exa m ple a dc t rl defa ult sfile= / d 1 / a p p s / p ro d a p pl / a d mi n / p ro d 1 / p ro d_ def.txt
help Description
U se d by All AD u tilities.
P u r po se S u m m a rize s av aila ble co m m a n d line
optio n s.
Val u e s y or n
Defa ult n
Exa m ple a d a d mi n h elp=y
interactive Description
U se d by AD Admi nis tr a tio n, AutoP a tc h, AD Co n t rolle r.
P u r po se Tells AD u tilities w het he r to r u n eit he r inter ac tively or n o n -
inte r ac tively.
Val u e s y or n
Defa ult y, m e a ni ng t h a t t he u tility r u n s in te r ac tively.
Exa m ple a d a d mi n inter ac tive=n
localworkers Description
P u r po se S pecifies t he n u m be r of worker s to r u n o n t he p ri m a ry n o de in a
Distrib u te d AD e nviro n m e n t.
Val u e s 1 to t he m a xi m u m s u p po rte d by yo u r d a t a b a se, b u t n o t m o re t h a n 9 9 9,
incl u sive
Defa ult Defa ult s to t he val ue of t he worker s a rg u m e n t, w hic h m e a n s all worke r s
r u n o n t he p ri m a ry n o de.
Exa m ple a d a d mi n worker s=8 localworker s= 3
logfile Description
P u r po se Tells AD u tilities w h a t log file to u s e. Nor m ally u s e d w he n r u n ni ng a u tility
n o n -inter ac tively.
Val u e s A file n a m e (not a fully-q u alified p a t h n a m e)
Defa ult None, m e a ni ng t h a t t he u tility will p ro m p t for t he log file n a m e.
Exa m ple a dc trl logfile=te s t.log
menu_opti
Description
on
U se d by AD Admi ni st r a tio n, AD Co n t rolle r.
P u r po se Whe n r u n ni ng o ne of t he se u tilities n o n -inter ac tively, u s e d to co n n ect t he
ac tio n s in a defa ult s file wit h a s pecific m e n u ite m.
Val u e s See list of m e n u optio n s in t he de sc riptio n of t he se u tilities. M u s t be u s e d
wit h in te r ac tive=n a n d defa ult sfile=<n a m e of defa ult s file>.
Defa ult N /A
Exa m ple a dc t rl inter ac tive= n defa ult sfile=$APPL_ TOP / a d mi n / p ro d / c t rldefs.txt
m e n u_optio n=SHOW_STATUS
parallel_inde
Description
x_threshold
P u r po se S pecifies t he n u m b e r block s in a t a ble. If a t a ble co n t ai n s fewer block s
t h a n t he t h re s hold se t ti ng, in dexe s a re cre a te d wit h p a r allel worke r s
a n d se ri al DML. If t he t a ble co n t ai n s m o re block s t h a n t he t h re s hold
se tti ng, in dexe s a re cre ate d wit h o ne worker a n d p a r allel DML.
Val u e s 0 to 2 1 4 7 4 8 3 6 4 7; if se t to 0, in dexe s a re cre a te d wit h p a r allel worker s
a n d se ri al DML
Defa ult 2 0 0 0 0; m e a ni ng a t h re s hold of 2 0, 0 0 0 block s
Exa m ple a d a d mi n p a r allel_in dex_t h re s hold=1 5 0 0 0
printdebug Description
P u r po se Tells AD p rogr a m s to di s pl ay extr a de b uggi ng infor m a tio n. In so me
c a se s, t he a m o u n t of extr a de b uggi ng infor m a tio n is s u b s t a n ti al.
Val u e s y or n
Defa ult n
Exa m ple a d a d mi n p ri n t de b ug=y
restart Description
P u r po se Tells AD u tilitie s r u n ni ng n o n -inter ac tively to re s t a r t a n existi ng se s sio n.
O nly valid w he n inter ac tive= n is al so s pecified.
Val u e s y or n
Defa ult n , m e a ni ng t h a t t he u tility r u n ni ng n o n -inter ac tively will expect to r u n a
co m pletely n ew se s sio n.
Exa m ple a d a d mi n inter ac tive= n re s t a r t=y
wait_on_failed_j
Description
ob
P u r po se Direct s t he u tilities to wait for u s e r in p u t in a n o n -in te r ac tive
se s sio n w he n a job fails.
Val u e s y or n
Defa ult n
Exa m ple a d a d mi n w ait_o n_failed_job=ye s
workers Description
P u r po se S pecifies t he n u m b e r of worke r s to r u n . Nor m ally u s e d w he n r u n ni ng t he
u tility n o n -in te r ac tively.
Val u e s 1 to t he m a xi m u m s u p porte d by yo u r d a t a b a se, b u t n o t m o re t h a n 9 9 9
Defa ult No, m e a ni ng t h a t t he p rogr a m p ro m p t s for t he n u m b e r of worke r s to r u n
Exa m ple a d a d mi n worke r s=8
AD Flags Argument
The flags= a rg u m e n t is u s e d by all AD u tilities. It p a s se s o ne of sever al ge ne ric flags to
t he u tility. E n te r o ne flag or a co m m a-se p a r a te d list of flags. The defa ult is None.
hidepw Description
Defa ult hi de pw
P u r po se Direct s t he u tilities to eit he r hi de or s how p a s swor d s in AD Utility log
files.
Co m m e n t s By defa ult, line s in a n AD u tility log file co n t ai ni ng p a s sword s a re
m o dified to hi de t he p a s sword s.
Whe n n o hi de pw is s pecified, e ac h line co n t ai ni ng hi d de n p a s sword s is
followed by a corre s po n di ng line p refixed wit h HIDEPW:, s howi ng t he
origin al line wit h p a s swor d s.
Exa m ple a d a d mi n flags= no hide pw
logging Description
Defa ult logging
P u r po se Tells t he AD u tility w he t he r to cre a te in dexe s u si ng logging or n ologging.
Co m m e n t s U si ng flags= nologging w he n cre a ti ng in dexe s m ay incre a se pe rfor m a n ce.
Howeve r, flags= nologging m a ke s d a t a b a se m e di a recovery inco m plete
a n d doe s n o t work wit h s t a n d by d a t a b a se s.
Logging is t he defa ult in AutoP a tc h to s u p po rt d a t a b a se m e di a recovery
a n d s t a n d by d a t a b a s e s. We do n o t reco m m e n d u si ng flags= nologging for
p ro d u c tio n sy s te m s u nle s s yo u m a ke a co m plete b ac k u p bot h before a n d
after r u n ni ng AutoP a tc h.
flags= nologging affect s in dexe s cre ate d t h ro ug h ODF o nly, n o t S QL
sc ript s. The XDF u tility alw ays cre a te s in dexe s wit h logging.
Exa m ple a d p a tc h flags=logging
trace Description
Defa ult n o t r ace
P u r po se Tells t he AD u tility w het he r to log all d a t a b a se oper a tio n s to a tr ace file.
Co m m e n t s D a t a b a se tr ace files cre ate d w hile r u n ni ng a n AD u tility m ay ai d
de b ugging. The flags=tr ace optio n cre ate s m ultiple t r ace files for t he AD
u tility a n d t he AD worke r s. A n ew tr ace file is cre a te d e ac h ti me t he AD
u tility or a worker reco n n ec t s to t he d a t a b a s e.
Note t h a t flags=tr ace o nly t r ace s d a t a b a se oper a tio n s inter n al to t he AD
u tility itself. D a t a b a se oper a tio n s in SQL sc ript s or exter n al p rogr a m s
r u n by t he AD u tility a re n o t recor de d by flags=tr ace.
Exa m ple a d a d mi n flags=tr ace
Note: Ma ny AD u tilitie s acce pt a d ditio n al a rg u m e n t s to t ho se liste d. Howeve r, t he se
s ho uld be u s e d o nly u n de r t he explicit directio n of Or acle S u p po rt Se rvice s.
Running AD Utilities
To r u n AD u tilities, se t t he e nviro n m e n t to define t he sy s te m co nfigu r a tio n
p a r a m e ter s. For exa m ple, a u tility m ay req uire t he directory p a t h to t he Applic atio n s
ORACLE_HOME. This p a r a m e te r, a n d ot he r s, m a ke u p yo u r sys te m e nviro n m e n t.
Important: Before se t ti ng t he e nviro n m e n t, Win dow s u s e r s m u s t al so co nfigu re
Win dow s s e rvice s.
O nce yo u h ave poi n te d t he u tility to t he correct e nviro n m e n t, yo u s t a r t it by e n teri ng
t he u tility n a m e.
Note: See Co nfigu r a tio n a n d E nviro n m e n t Files in t hi s c h a p te r.
Setting the Environment
To se t t he Or acle E-B u si ne s s S uite e nviro n m e n t, co m plete t he following s te p s. See t he
Oracle Installation and Upgrade Notes for a n y a d ditio n al pla tfor m -s pecific s te p s.
1. Log in a s a p pl mgr (Applic atio n s file sys te m ow ner).
2. R u n t he e nviro n m e n t (UNIX) or co m m a n d (Win dow s) file for t he c u r re n t APPL_
TOP a n d d a t a b a s e.
UNIX:
The e nviro n m e n t file is typic ally APPSCONTEXT_NAME>.e nv, a n d is locate d
u n de r APPL_TO P. Fro m a Bo u r n e, Kor n, or B a s h s h ell, e n ter t he following
co m m a n d:
$ .APPS<C O NTEXT_NA M E >.env
Windows:
U si ng eit he r Win dow s Explorer or t he R u n optio n fro m t he S t a r t m e n u , e n te r t he
co m m a n d:
% APPL_TOP %\envshell.cmd
This cre a te s a co m m a n d win dow wit h t he req uire d e nviro n m e n t se tti ngs for
Or acle E-B u si ne s s S uite. All s u b se q u e n t co m m a n d s s ho uld be r u n in t hi s
win do w.
3. If yo u h ave m a d e a ny c h a n ge s to t he e nviro n m e n t, c hec k t h a t it is correctly se t
by e n teri ng t he following co m m a n d s:
UNIX:
$ echo $T W O_TASK
$ echo $ORACLE_HO M E
$ echo $PATH
Windows:
C:\> echo % L O CAL %
C:\> echo % O RACLE_HO M E %
C:\> echo %PATH %
C:\> echo % APPL_CO NFIG %
For UNIX, t he ORACLE_HOME m u s t be se t to t he p ro per d a t a b a se directory,

a n d TWO_TASK or LOCAL m u s t ide n tify t he correct d a t a b a se. For Win dow s,
APPL_ CONFIG m u s t be se t to <CONTEXT_NAME>.
4. E n s u re t h a t t he re is s ufficie n t te m po r a ry di s k s p ace.
Yo u s ho uld h ave a t lea s t 5 0 MB in t he te m po r a ry directorie s de note d by
$APPLTMP a n d $APPLPTMP (UNIX), or %APPLTMP% a n d %APPLPTMP%
(Win dow s). Yo u s ho uld al so h ave s p ace in t he oper a ti ng sy s te m’s defa ult
te m por a ry directory, w hic h is u s u ally / t m p or / u s r / t m p (UNIX) or C: \ t e m p
(Win dow s).
5. If yo u a re r u n ni ng a n AD u tility to relin k or u p d a te Or acle E-B u si ne s s S uite
p ro d u c t files or m o dify Or acle E-B u si ne s s S uite d a t a b a se object s, s h u t dow n t he
co nc u r re n t m a n age r, We b se rver liste ne r s, for m s s e rver liste ne r s if t he files a re
o n a n o de t h a t co n t ai n s t he a s sociate d se rver s. For exa m ple, if t he files a re o n
t he n o de t h a t co n t ai n s t he co nc u r re n t p roce s si ng se rve r, s h u t dow n t he
co nc u r re n t m a n age r s.
Note: For m o re infor m a tio n, s ee Additio n al Infor m a tio n: See Admi ni ster
Co nc u r re n t Ma n ager s in Oracle E-Business Suite System Administrator’s Guide -
Configuration.
6. E n a ble Mai n te n a n ce m o de if t he m ai n te n a n ce t a s k req uire s sys te m dow n ti me.
Note: For m o re infor m a tio n, s ee U si ng Mai n te n a n ce Mode in C h a p te r 4.
Configuring Windows Services
If yo u a re r u n ni ng AD u tilitie s o n a Win dow s pl atfor m, yo u m u s t first s h u t dow n all
for m s se rvice s, We b liste ne r s e rvice s, a n d co nc u r re n t m a n ager se rvice s. In a d ditio n,
yo u m u s t verify t h a t t he d a t a b a s e a n d d a t a b a se liste ne r s a re r u n ni ng.
To view a n d c h a n ge t he s t a t u s of a s e rvice, follow t he se s te p s:
1. Select S t a r t > Se tti ngs > Co n t rol Pa n el, a n d do u ble-click o n Services.
2. Highligh t t he a p p ro p ri ate s e rvice n a m e a n d click S top or S t a r t a s a p p ro pri ate.
The following t a ble list s t he se rvice s a n d s t a t u s req uire d w he n r u n ni ng a n AD
u tility:
Win dow s Se rvice s a n d AD Utility S t a t u s Req uire me n t s
Service Type Service Name Status
Co nc u r re n t Ma n ager Or acleCo ncMgr<CONTEXTNAME> S to p pe d
Services
D a t a b a se Service s Or acleService<SID> S t a r te d
D a t a b a se Liste ne r Or acle<SID>_<DB_VERS>RDBMSTNSListe S t a r te d
n e r<SID>
Starting a Utility
To s t a r t a n AD u tility, e n te r t he u tility’s exec u t a ble n a m e o n t he co m m a n d line. For
exa m ple, to s t a r t AD Admi ni st r a tio n, yo u wo uld e n ter t he co m m a n d:
$ adad min
Note: For m o re infor m a tio n, see Co m m a n d Line Utilitie s in t hi s c h a p te r for a list of AD

exec u t a ble s.
Exiting or Stopping a Utility
Whe n m e n u - d rive n u tilities co m plete a p roce s si ng t a s k, t hey ret u r n yo u to t he m ai n
m e n u , w he re yo u eit he r c hoo se a no t he r p roce s s or Exit. AD Admi ni str a tio n is a n
exa m ple. Ot he r u tilities do n o t u s e a m e n u for m a t. In t hi s c a se, t he u tility exits
a u to m a tic ally w he n p roce s si ng is co m plete. AutoP a tc h, AD Merge P atc h, a n d File
C h a r ac ter Set Co nverte r File Character Set Converter a re exa m ple s.
Before it begi n s p roce s si ng t a s k s, yo u c a n s to p a u tility by e n te ri ng a bo rt a t a n y
p ro m p t. Yo u c a n u s e t hi s co m m a n d o nly for u tilities t h a t di s play p ro m p t s, a n d o nly
w he n a p ro m p t is di s played o n t he s c ree n.
In so me c a se s, a u tility m ay begi n t he p roce s si ng ac tio n s, b u t q uit s before t he ac tio n s
a re co m plete (bec a u se of a n error). O r, d u ri ng a p a r allel p roce s si ng s e s sio n, yo u m ay
decide to s to p t he p roce s si ng ac tio n s by s h u t ti ng dow n t he worker s.
Note: For m o re infor m a tio n, see Tro u ble s hooti ng in Oracle E-Business Suite Maintenance
Procedures for a d ditio n al de t ails a bo u t s h u t ti ng dow n a n d re s t a r ti ng worker s.
Restarting a Utility
Yo u c a n re s t a r t a u tility by e n te ri ng t he exec u t a ble n a m e o n t he co m m a n d line. Whe n
yo u re s t a r t, t he u tility p ro m p t s yo u to e n te r a n ew log file, or to s pecify t he log file fro m
t he interr u p te d se s sio n. Whe n yo u re u se t he log file fro m a p revio u s se s sio n, t he u tility
a d d s t he m e s s age “Start of s e s sio n” to t he e n d of t he file a n d a p pe n d s
m e s s age s fro m t he co n ti n u e d se s sio n a s it ge ne r a te s t he m .
The u tility p ro m p t s yo u to do o ne of t he following:
• Continue Session (the default)
The u tility c hec k s t he p rogre s s of t he p revio u s se s sio n in t he re s t a r t files, a n d
begin s p roce s si ng a t t he poi n t w here yo u r la s t s e s sio n s to p pe d.
• Start New Session
The u tility a s k s yo u to co nfir m yo u r c hoice if yo u c hoo se n o t to co n ti n u e t he
p revio u s se s sio n. It s t a r t s t he p roce s s fro m t he begi n ni ng.
If t he p roce s s t h a t s to p pe d w a s r u n ni ng in p a r allel, a FND_INSTALL_PROCES S ES
t a ble m ay exist. If it doe s, t he u tility a s k s if yo u w a n t to d ro p t he t a ble. This m e s s age
se rve s a s a w ar ni ng to m a ke yo u aw a re of t he existi ng AD se s sio n. Deter mi ne if a ny
ot he r u tility is r u n ni ng in a n o t he r se s sio n or o n a n o t he r n o de. If yo u a re s u re t h a t t he
AD u tility t h a t is c u r re n tly r u n ni ng is n o t n ee de d, yo u c a n d ro p t he FND_INSTALL_
PROCES S E S t a ble a n d co n ti n u e wit h t he n ewer AD se s sio n t h a t yo u s t a r te d.
Note: For m o re infor m a tio n, see Rest a r t Files in t hi s c h a p te r.
Using Parallel Processing

Processing Tasks in Parallel
P ar allel p roce s si ng is typic ally u s e d by AD Admi ni st r a tio n a n d AutoP a tc h to:
• Co m pile invalid object s.
• R u n d a t a b a s e d river t a s k s, s u c h a s S QL sc ript s.
• Ge ner a te vario u s ki n d s of files, s u c h a s for m s, re port, a n d m e s s age files.
Wor ke r s co m plete p roce s si ng t a s k s a s signe d to t he m by t he m a n age r. The u tilities
t he m selves de te r mi ne t he list of t a s k s to be pe rfor me d a n d p rioritize t he m for
exec u tio n. They al so p ro m p t for t he n u m b e r of worke r s to pe rfor m t he t a s k s. For
exa m ple, w he n AutoP a tc h is a p plyi ng a d a t a b a se d rive r, it cre ate s a list of d a t a b a s e
t a s k s a n d p ro m p t s yo u to s pecify t he n u m b e r of worke r s t h a t s ho uld r u n co nc u r re n tly
to exec u te t he se t a s k s.
The worke r p roce s se s a re in s t a n ce s of t he a dwor ke r p rogr a m . This p rogr a m c a n o nly
be c alled by t he m a n age r p roce s se s, a n d c a n n o t be r u n s t a n d -alo ne.
Managers
The m a n ager a s sign s e ac h worke r a u niq u e ID a n d in se rt s a row for e ac h worke r in t he
FND_INSTALL_PROCES S E S t a ble. It cre ate s t hi s t a ble to se rve a s a s t agi ng a re a for
job infor m a tio n, a n d a s a way to co m m u nic a te wit h t he worke r. Co m m u nic a tio n is
a cco m plis he d u si ng two col u m n s: CONTROL_CODE a n d STATUS.
The m a n ager u p d a te s t he t a ble wit h a s u b se t of t he list of job s, o ne job pe r worke r. For
exa m ple, if t he re a re five worker s, t he n t he t a ble h old s five job s (even t ho ug h t he re
m ay be 1 0 0 or m o re job s involved in t he co m plete a c tio n). The m a n age r s t a r t s t he
worke r s a n d u s e s t he CONTROL_CODE a n d STATUS col u m n s to a s sign t a s k s. It polls
t he se two col u m n s co n ti n uo u sly, looki ng for u p d a te s fro m t he worker s. As a worker
finis he s its a s sign m e n t, t he m a n ager u p d a te s e ac h row wit h t he n ext t a s k in t he list,
a n d leave s a n o t he r m e s s age for t he worke r.
O nce all job s a re co m plete, t he m a n ager tells t he worker s to s h u t dow n, a n d t he n
d ro p s t he FND_INSTALL_PROCESS ES t a ble (after it is s u re all worker s h ave ac t u ally
s h u t dow n).
Workers
E ac h worker u p d a te s t he S TATUS col u m n , giving t he m a n ager a re port o n its
p rogre s s. As t he jobs a re co m plete d, t he m a n age r u p d a te s t he t a ble wit h t he n ext job
in t he q u e u e, a n d u p d a te s t he CONTROL_CODE a n d STATUS col u m n s telling t he
worke r to s t a r t p roce s si ng. If t he re is a failu re, t he worke r re port s a failed s t a t u s .
For cert ai n t a s k s, so m e worker p roce s se s s p aw n ot he r c hild p roce s se s t h a t do t he
a c t u al work. The s p aw n e d c hild p roce s s ret u r n s a s t a t u s code to t he worke r t h a t
s p aw n e d it. The worker inter p ret s t he code to de te r mi ne if t he job h a s bee n co m plete d
s u cce s sf ully. Exa m ple s of c hild p roce s se s a re S QL*Plu s a n d FNDLOAD.
Deferred Jobs
The first ti me a job fails, t he m a n age r a u to m a tic ally defer s t he job a n d a s sign s a n ew
o ne to t he worke r. If t he deferre d job fails t he seco n d ti me it is r u n , t he m a n age r defer s
it ag ai n o nly if t he tot al r u n ti me of t he job is les s t h a n te n mi n u te s. If t he deferre d job
fails a t hir d ti me (or if t he job’s tot al r u n ti me is n o t les s t h a n te n mi n u te s t he seco n d
ti me it is r u n) t he job s t ay s a t failed s t a t u s a n d t he worke r wait s. At t hi s poi n t, yo u
m u s t a d d re s s t he c a u s e of t he failu re, a n d t he n re s t a r t t he job.
Note: For m o re infor m a tio n, see R u n ni ng AD Co n t roller Inte r ac tively in t hi s c h a p te r.
See al so Tro u ble s hooti ng in Oracle E-Business Suite Maintenance Procedures .
The deferre d job feat u re u s e s t he AD_DEF ERRED_ J OBS t a ble. This t a ble is cre ate d
w he n t he FND_INSTALL_PROCES S E S t a ble is cre a te d, a n d is d ro p pe d w he n t he
FND_INSTALL_PROCES S E S t a ble is d ro p pe d.
Determining Number of Workers

The AD u tilities p rovide a defa ult n u m be r of worker s of twice t he n u m b e r of CPU s o n
t he d a t a b a se se rve r. Or acle reco m m e n d s yo u c hoo se a n u m b e r of worke r s be twee n 2-4
ti me s t he n u m b e r of CPU s. For exa m ple, if t he re a re fou r CPU s o n t he d a t a b a s e s e rve r,
yo u s ho uld c hoo se so m e t hi ng in t he r a nge of 8-1 6 worke r s.
The AD u tilities c alc ul ate a m a xi m u m n u m be r of worker s t h a t yo u r d a t a b a se c a n
s u p po rt (up to 9 9 9). Yo u c a n no t e n te r a n u m b e r of worke r s gre ater t h a n t he d a t a b a se
c a n s u p port.
Worker Log Files

In a d ditio n to t he infor m a tio n recor de d in t he .log file, u tilities t h a t
p roce s s job s in p a r allel write de t ails a bo u t error s to worker log files. The
a dwork< n u m be r>.log files (adwork 0 0 1.log, a dwork 0 0 2.log...) re side in t he $APPL_
TOP / a d mi n / < SID> / log directory, w here <SID> is t he val ue of t he ORACLE_SID or
TWO_TASK varia ble (UNIX), or in %APPL_TOP% \ a d mi n \ < SID> \ log, w he re <SID> is
t he val ue of ORACLE_SID or LOCAL (Win dow s).
Co nc u r re n t req u e s t s r u n by AutoP atc h a n d AD Admi ni st r a tio n cre a te t heir ow n log
files.
Note: For m o re infor m a tio n, see Log a n d O u t p u t File n a m e s in Oracle E-Business Suite
Worker Restart Files
Rest a r t files a re u s e d to co n ti n u e p roce s si ng a t t he poi n t w here it s to p pe d. E ac h
worke r m ay al so h ave a re s t a r t file c alled a dworkxxx.rf9. The se files a re s to re d in
$APPL_TOP / a d mi n / < SID> / r e s t a r t (UNIX) or in %APPL_TOP% \ a d mi n \ < SID> \ r e s t a r t
(Win dow s). The worker cre a te s t he re s t a r t file w he n t he m a n age r a s sign s it a job, a n d
delete s t he re s t a r t file w he n it finis he s t he job.
Caution: Do n o t m o dify or delete a n y m a n ager or worker re s t a r t files u nle s s explicitly
told to do so by Or acle S u p port Services.
The Tro u ble s hooti ng c h a p te r in Oracle E-Business Suite Maintenance Procedures
di sc u s se s vario u s error sit u a tio n s w he n r u n ni ng a u tility a n d how to re solve t he m .
Parallel Support for Data Manipulation Language (DML)

To re d u ce dow n ti me w he n cre a ti ng in dexe s, t he p a r allel_in dex_t h re s hold a rg u m e n t
for AD u tilities is se t to a defa ult val ue of 2 0, 0 0 0. This m e a n s t h a t if a t a ble co n t ai n s
les s t h a n 2 0, 0 0 0 block s, t he AD u tilities cre a te in dexe s wit h p a r allel worke r s a n d
se ri al DML (ju s t a s in e arlier rele a se s). If a t a ble co n t ai n s 2 0, 0 0 0 block s or m o re,
in dexe s a re n ow cre a te d wit h o nly o ne worker a n d p a r allel DML. Yo u c a n a dj u s t t hi s
t h re s hold val ue by s pecifying t he p a r allel_in dex_t h re s hold a rg u m e n t o n t he AD u tility
co m m a n d line.
Monitoring and Controlling Parallel Processes

AD se s sio n s t h a t u s e p a r allel p roce s si ng m ay r u n to co m pletio n wit ho u t u s e r
inte rve n tio n. Howeve r, it is ofte n u s ef ul to de ter mi ne how m a n y job s h ave bee n
co m plete d or w het he r p roce s si ng h a s s to p pe d for so m e re a so n . AD Co n t roller is a
u tility t h a t yo u c a n u s e to de te r mi ne t he s t a t u s of AD Admi ni st r a tio n or AutoP atc h
worke r s a n d to co n trol t heir ac tio n s. Yo u c a n r u n AD Co n t roller inter ac tively or n o n -
inte r ac tively. It m u s t be r u n in its ow n win do w, n o t in t he s a m e win dow a s AD
Admi ni str a tio n or AutoP a tc h.
Note: For m o re infor m a tio n, see Inter ac tive a n d Non-Inter ac tive Proce s si ng in t hi s
c h a p te r.
Yo u c hoo se optio n s t h a t di s play worker s t a t u s, re s t a r t worke r s, or is s u e co m m a n d s to
t he m a n ager fro m t he AD Co n t roller m ai n m e n u .
Running AD Controller Interactively

Follow t he se s te p s to acce s s AD Co n t rolle r.
1. Log in a s a p pl mgr a n d se t t he e nviro n m e n t a s de sc ribe d in Setti ng t he
E nviro n m e n t in t hi s c h a p te r.
2. S t a r t AD Co n t roller wit h t he a dc t rl co m m a n d. This will p ro m p t yo u to:
• Co nfir m t he val ue of APPL_TO P.
• S pecify a n AD Co n troller log file (the defa ult is a dc trl.log). The AD
Co n t roller log file is writte n in t he c u r re n t worki ng directory.
• S u p ply t he Or acle Applicatio n O bject Libr a ry u s e r n a m e a n d p a s sword.
3. C hoo se a n optio n fro m t he m ai n m e n u .
O nce yo u re s po n d to t he p ro m p t s, t he m ai n m e n u a p pe a r s.
AD Controller Menu
Type a n u m be r to s elect a n optio n. Pre s s [Ret u r n] a t a ny ti me to re t u r n to t he AD

Co n t roller m ai n m e n u .
Note: See Tro u ble s hooti ng in Oracle E-Business Suite Maintenance Procedures for
in s t r u c tio n s o n u si ng e ac h m e n u optio n.
Running AD Controller Non-Interactively

Yo u c a n r u n AD Co n t roller wit ho u t u s e r in te rve n tio n by cre ati ng a defa ult s file, w hic h
c a p t u re s infor m a tio n yo u s u p ply a t t he inter ac tive p ro m p t s in a file t h a t yo u c a n late r
u s e to r u n AD Co n t roller wit ho u t u s e r interve n tio n. Cre a ti ng a defa ult s file a n d
r u n ni ng AD Co n troller n o n -inte r ac tively work s in m u c h t he s a m e w ay a s it doe s for AD
Admi ni str a tio n.
Note: For m o re infor m a tio n, see Sc he d uli ng Non-In te r ac tive Mai n te n a n ce in Oracle E-
Business Suite Maintenance Procedures.
Like AD Admi nist r a tio n, t he s a m e defa ult s file c a n be u s e d to r u n differe n t AD
Co n t roller co m m a n d s: a si ngle file c a n co n t ai n all yo u r c hoice s for t he differe n t m e n u
optio n s. In orde r to c hoo se w hic h t a s k t he defa ult s file will r u n , yo u a d d m e n u_
optio n= <me n u c hoice> to t he u tility s t a r t co m m a n d. Thi s override s a n y m e n u - s pecific
key s t ro ke infor m a tio n s to re d in t he defa ult s file initially, a n d allows yo u to u s e t he
defa ult s file for a ny of t he AD Co n t roller m e n u ite m s. It al so e n s u re s t h a t t he m e n u
optio n yo u inte n de d for t he defa ult s file is alw ays valid, eve n it t he m e n u ite m s a re
re n u m be re d or reloc ate d in s u b se q u e n t rele a se s.
The av ailable optio n s a re liste d in t he following t a ble.
AD Co n t roller Me n u O ptio n s
Menu Option Effect
ACKNOWLEDGE_QUIT Tell m a n ager t h a t a worke r ac k nowledge s
q uit
INFORM_FAILURE Tell m a n ager t h a t a worke r failed its job
RESTART_ JOB Tell worker to re s t a r t a failed job
SHOW_STATUS S how worker s t a t u s
SHUTDOWN_WORKER Tell worker to q uit
S TART_WORKER Re st a r t a worke r o n t he c u r re n t m a c hi ne
Note: The m e n u optio n s for r u n ni ng AD Admi ni st r a tio n a re liste d in Pre p a ri ng for Non-
Inter ac tive Proce s si ng in C h a p te r 4 .
The following is a n exa m ple of r u n ni ng AD Co n t roller n o n -inter ac tively to s how worker
s t a t u s:
$ adctrl interactive=n defaults_file=$APPL_TOP/admin/prod/ctrldefs.txt \
logfile=adctr.log menu_option=S H O W_STATUS
U si ng a ny m e n u optio n o n t he co m m a n d line, exce pt for SHOW_STATUS, req uire s

t h a t yo u al so u s e t he worker_ r a nge=<r a nge> optio n. See t he AD Co n troller co m m a n d
line h elp for de t ails.
Distributing Processing Tasks Across Nodes

AD u s e s its existi ng m a n age r-worker job sy s te m e m ployed in p a r allel p roce s si ng to
incl u de Dist rib u te d AD. This p a r allel p roce s si ng feat u re allows worker s in t he s a m e
AD se s sio n to be s t a r te d o n m u ltiple a p plicatio n tier s e rver s to u tilize all av aila ble
re so u rce s. Bec a u s e t he AD worker s cre a te a n d u p d a te file sy s te m object s, a s well a s
d a t a b a s e object s, Distrib u te d AD m u s t be u s e d o nly o n sy s te m s t h a t a re u si ng a
s h a re d a p plic atio n tier file sys te m to e n s u re t he files a re cre ate d in a si ngle,
ce n tr alized locatio n.
While r u n ni ng eit he r AD Admi ni str a tio n or AutoP a tc h o n t he p ri m a ry n o de, yo u s t a r t
a n AD Co n t roller se s sio n fro m a ny of t he n o de s in t he s h a re d a p plicatio n tier file
sy s te m e nviro n m e n t to pe rfor m a ny s t a n d a r d AD Co n t roller oper a tio n, u si ng bo t h
loc al a n d n o n -loc al worker s.
Note: For m o re infor m a tio n, see Distrib u ti ng Proce s si ng Ta s k s in Oracle E-Business
Suite Maintenance Procedures.
OAM Web-Based Utilities

Or acle Applicatio n s Ma n ager (OAM) is a We b-b a se d m a n age me n t tool t h a t allows yo u
to u s e a n d a cce s s m a n y m ai n te n a n ce u tilities t h a t were for me rly av aila ble o nly o n t he
co m m a n d line, a n d m a ke s it po s sible to q uic kly retrieve a n d di s pl ay sy s te m -s pecific
infor m a tio n in a GUI for m a t. E ac h u tility in OAM is a cce s se d fro m a m ai n p age, w hic h
co n t ai n s lin k s to m u ltiple layer s of de t ails t h a t q uic kly p u t yo u in to u c h wit h all
a s pect s of yo u r sys te m d a t a. For exa m ple, u si ng t he P atc h Wizar d u tility, yo u c a n
a cce s s a dow nlo a de d list of reco m m e n de d p a tc he s a n d view t he effect o n yo u r file
sy s te m of a p plying a n y or all of t he p a tc he s.
In a d ditio n to re porti ng re s ult s b a se d o n s pecific se a rc h criteri a, m a n y OAM u tilities
c a n be u s e d to e n te r a n d s ave c h a nge s to yo u r sy s te m co nfigu r a tio n. For exa m ple,
u si ng Lice n se Ma n age r, yo u c a n registe r p ro d u c t s t h a t were n o t a c tive in yo u r initial
in s t allatio n. O r, wit h AutoCo nfig, yo u c a n view c u r re n t co nfigu r a tio n p a r a m e ter s a n d
m o dify t he existi ng val ue s.
Note: For m o re infor m a tio n, see C h a p te r 7 of Oracle E-Business Suite Concepts.
Common OAM Operations

The OAM We b-b a se d u tilitie s a re de signe d wit h t he s a m e look a n d feel, m a ki ng
exte n sive u s e of co m mo n oper a tio n s s u c h a s u nifor m n avigatio n tools a n d d rill-dow n
m e n u s . For exa m ple, all p age s p re se n t a Help lin k t h a t ope n s a p age-s pecific OAM
h elp sc ree n.
In a d ditio n, OAM u tilities e m ploy a powerf ul se a rc h feat u re, w hic h di s plays t he se a rc h
re s ult s directly o n t he p age w here yo u initiate d t he se a rc h. There is n o n ee d to review
log files or look in a file directory for t he re port. For exa m ple, u si ng t he Applied P atc he s
u tility, yo u c a n pe rfor m a si m ple se a rc h for all t he p a tc he s t h a t h ave bee n a p plied to
yo u r sys te m . OAM di s plays t he re s ult s o n t he Si m ple Se a rc h p age.
The Applications Navigator and the OAM Dashboard and Site Map
Yo u c a n a cce s s OAM fu nc tio n ality in sever al w ays. Yo u begi n fro m t he Navigato r,
w hic h is t he first p age yo u e nco u n te r w he n yo u log in fro m t he OAM Welco me p age.
After yo u c hoo se fro m t he list of re s po n si bilities t h a t define yo u r role for u si ng Or acle
E-B u si ne s s S uite, t he Navigator p re se n t s a list of optio n s u n d e r s ever al h e a di ngs,
b a se d o n yo u r Applic atio n s u s e r role. For exa m ple, t he Sys te m Admi nist r a tio n role
p rovide s a p a t h to t he sever al gro u p s of optio n s, incl u di ng t he Or acle Applic atio n s
Ma n ager a n d relate d u tilities.
The is t he m ai n OAM p age. It p rovide s a "sn a p s ho t" of yo u r sy s te m ac tivity a n d a d ro p-
dow n list to p rovide q uick acce s s to so me of t he m o s t co m mo nly u s e d OAM u tilitie s
a n d t he OAM Site Map. In a d ditio n, it co n t ai n s a lin k to t he OAM Site Map, w hic h
di s plays lin k s to all t he OAM u tilitie s, segregate d o n in divid u al t a b s by fu nc tio n ality.
Page Navigation
Yo u n avigate t h ro ug h OAM p age s o n t he D a s h bo a r d a n d Site Map by clicki ng o n a t a b
t h a t di s pl ays a feat u re s u b se t. O n in divid u al p age s, yo u h ave n avigatio n optio n s, a n d,
w here a p p ro p ri ate, t he re a re d ro p-dow n list s t h a t p rovide lin k s to relate d feat u re s. O n
p age s wit h le ngt hy list s of ite m s, OAM di s plays a s u b se t of t he ite m s for e a sy acce s s.
OAM Interface
The Or acle Applic atio n s Ma n ager D a s h bo a r d p re se n t s a q uic k overview of t he ge ne r al
s t a t u s of yo u r sy s te m . The Site Map p rovide s a cce s s to all t he u tilitie s a n d feat u re s
wit hi n t he OAM fra m ework.
Reviewing System Status
Whe n yo u a cce s s t he OAM D a s h bo a r d, yo u c a n see a ge ner al s u m m a ry of yo u r sys te m
a c tivity.
OAM Dashboard
The OAM D a s h bo a r d se rve s a s a n HTML co n sole, w here sy s te m a d mi ni str a to r s c a n
c hec k t he s t a t u s of t he d a t a b a se, co nc u r re n t m a n ager s a n d ot he r s e rvice s, co nc u r re n t
req u e s t s, a n d Or acle Wor kflow p roce s se s, a s well a s view co nfigu r a tio n infor m a tio n,
s u c h a s initializatio n p a r a m e te r s a n d p rofile optio n s.
The D a s h bo a r d is u s e d in vario u s w ays, m a n y of w hic h a re beyo n d t he sco pe of t hi s
book. The Oracle E-Business Suite System Administrator’s Guide co n t ai n s m o re co m plete
infor m a tio n.
Accessing Maintenance Utilities

Whe n yo u a cce s s t he D a s h bo a r d, yo u c a n u s e t he Navigate To: d ro p-dow n list for
q uick lin k s. Ope n t he list, m a ke a s electio n, a n d click Go.
Navigating in OAM
O r, for a m o re co m plete list of all t he u tilitie s a n d feat u re s incl u de d in OAM, click t he

Site Map lin k.
OAM Site Map
The Site Map p age di s plays t a b s for Admi nist r a tio n, Mo nitori ng, Mai n te n a n ce, a n d
Diagno s tic s a n d Rep ai r. O n in divid u al t a b s, t he re a re lin k s to u tilitie s or fu nc tio n s
u n d e r ge ner al gro u p s. For exa m ple, o n t hi s p age t he re a re h e a di ngs for Sys te m
Co nfigu r a tio n, Applic atio n Se rvice s, Workflow, a n d so o n. U n der t he Mai n te n a n ce t a b,
t he re a re h e a di ngs for P atc hi ng Utilities a n d Critic al Activitie s.
To ope n t he m ai n p age for a u tility, fin d it u n d e r o ne of t he h e a di ngs a n d click t he lin k.
For exa m ple, to view infor m a tio n a bo u t p a tc he s t h a t h ave alre a dy bee n a p plied to yo u r
sy s te m, click Applied P atc he s u n d e r t he P atc hi ng a n d Utilities h e a di ng o n t he
Mai n te n a n ce t a b.
OAM Patching Features
Click a n y of t he ot he r t a b s to acce s s ot he r fu nc tio n s. In t hi s guide, all in s t r u c tio n s for
a cce s si ng OAM We b-b a se d u tilitie s s t a r t fro m t he Site Map.
Accessing OAM
Yo u c a n a cce s s t he OAM Welco me p age after logging into Or acle E-B u si ne s s S uite via
t he following URL:
http:.//<server:port>/OA_HT ML/AppsLogin
Oracle E-Business Suite Welcome Screen

E n te r yo u r u s e r n a m e a n d p a s swor d, a n d click Login. The sy s te m re direct s yo u to t he
Navigator p age, w hic h di s pl ays a n avigatio n p a n e t h a t list s u s e r re s po n sibilitie s. Click
Syste m Admi ni str a tio n.
Oracle E-Business Suite Main Navigation Page
In t he Sys te m Admi ni str a tio n sec tio n, click Or acle Applic atio n s Ma n ager to acce s s t he
D a s h bo a r d. Alter n a tively, yo u c a n sc roll dow n to t he Or acle Applicatio n s Ma n ager
sectio n, w he re t he u tilities a re liste d a s se p a r a te lin k s, a n d c hoo se a u tility (or t he
D a s h bo a r d) fro m t h a t sec tio n.
All t he infor m a tio n in t he Or acle E-B u si ne s s S uite m ai n te n a n ce doc u m e n t a tio n
a s s u m e s t h a t yo u will s t a r t fro m t he D a s h bo a r d > Site Map. The in divid u al u tility
sc ree n s di sc u s se d all relate to p a tc hi ng yo u r Applicatio n s sy s te m . Their fu nc tio n ality
is de sc ribe d fully in Oracle E-Business Suite Patching Procedures.

AD Utility PDF

Hochgeladen von

Dokumentinformationen

Originaltitel

Copyright

Verfügbare Formate

Dieses Dokument teilen

Dokument teilen oder einbetten

Freigabeoptionen

Stufen Sie dieses Dokument als nützlich ein?

Sind diese Inhalte unangemessen?

Copyright:

Verfügbare Formate

AD Utility PDF

Hochgeladen von

Copyright:

Verfügbare Formate

Oracle E-Business Suite Maintenance Utilities

About System Maintenance

The t a s k-s pecific p ro m p t s a re de sc ribe d m o re fully in t he di sc u s sio n of e ac h t a s k.

Preparing for Non-Interactive Processing

Specifying a Menu Option in the AD Administration Defaults File

The AD Administration Interface

Thi s m e n u di s pl ays t he s u b m e n u s w he re t he in divid u al m ai n te n a n ce t a s k s a re

Running AD Administration Interactively

The u tility s t a r t s a n d di s pl ays t he first p ro m p t.

Generating Applications Files

If sys te m u s e r s a re h avi ng diffic ulty acce s si ng m e s s age s, for m s, or re port s, yo u m ay be

Generate Message Files

Generate Form and Report Files

Generate Product JAR Files

If yo u c hoo se No, it ge ner a te s o nly JAR files t h a t a re mi s si ng or o u t-of-d a te. If yo u

Maintaining Applications Files

Copy Files to Destinations

Convert Character Set

Maintain Snapshot Information

The se optio n s allow yo u to:

Maintain Current View Snapshot Information

2. Fro m t he Mai n t ai n C u r re n t View S n a p s ho t Infor m a tio n m e n u , yo u c a n select

Managing Database Entities

Compiling or Reloading Database Entities

Compile APPS schema

Reload JAR files to Database

Maintaining Applications Database Entities

Validate APPS schema

Recreate Grants and Synonyms for APPS Schema

Check DUAL Table

Using Maintenance Mode

Select optio n 1 to e n a ble Mai n te n a n ce m o de, or optio n 2 to di s a ble it.

• y (relin k regar dle s s of t he s t a t u s of t he libr a rie s or object files)

Defa ult n o n e (m u s t e n te r eit he r y or n)

• all (bac k u p all exec u t a ble s)

• file (bac k u p files a ccordi ng to in s t r u c tio n s in

Defa ult b ac k u p_ mo de=file

Oracle E-Business Suite Maintenance Utilities

Oracle E-Business Suite Maintenance Utilities

Command Line Utilities

The a rg u m e n t s a n d optio n s t h a t yo u c a n u s e to refine t he oper a tio n of a u tility a re

adadmin Non-Interactive mode

Obtaining Help in OAM

Command Line Utilities

Enter the ORACLE password of Application Object Library [APPS] :

Press [Return] to accept the default value, or type a new value

Interactive and Non-Interactive Processing

Special Parameter for Using AutoPatch and AD Administration Non-Interactively

Filename [<utility na me>.log] :

Warning: Do n o t u p d a te t hi s file m a n u ally.

<CONTEXT_NAME $INST_TOP / U se d to co nfigu re t he e nviro n m e n t w he n

Feature Version Numbers

Fro m t hi s sc ree n, c hoo se o ne of t he s u b m e n u s , a n d t he n fro m t he re, c hoo se t he

Command Line Arguments

The to ke n ("LOGFILE") will be co nverte d to lowerc a se, b u t t he val ue (TEST.LOG) is n o t

Yo u c a n e n te r m o re t h a n o ne to ke n=val ue a rg u m e n t o n a si ngle co m m a n d line by

Co m m a -se p a r a te d list s m u s t n o t co n t ai n bl a n k s p ace s. For exa m ple, t he following

So me co m m a n d line a rg u m e n t s a re u s e d by sever al u tilitie s a n d a re liste d in t he

For UNIX, t he ORACLE_HOME m u s t be se t to t he p ro per d a t a b a se directory,

Note: For m o re infor m a tio n, see Co m m a n d Line Utilitie s in t hi s c h a p te r for a list of AD

Using Parallel Processing

Determining Number of Workers

Worker Log Files