Appendix - G - Frequently Asked Questions- Application Object Library

General AOL

Where do concurrent request logfiles and output files go? The concurrent manager first looks for the environment variable $APPLCSF If this is set, it creates a path using two other environment variables $APPLL!" an# $APPL!$T It places log files in $APPLCSF%$APPLL!"
!utput files go in $APPLCSF%$APPL!$T

So for e&ample, if 'ou have this environment set $APPLCSF = /u01/appl/common $APPLLOG = log $APPLOUT = out The concurrent manager will place log files in %u()%appl%common%log, an# output files in %u()%appl%common%out *ote that $APPLCSF must be a full, absolute path, an# the other two are #irector' names+ If $APPLCSF is not set, it places the files un#er the pro#uct top of the application associate# with the re,uest+ So for e&ample, a P! report woul# go un#er $P!-T!P%$APPLL!" an# $P!-T!P% $APPL!$T Logfiles go to %u()%appl%po%.+(%log !utput files to %u()%appl%po%.+(%out !f course, all these #irectories must e&ist an# have the correct permissions+ *ote that all concurrent re,uests pro#uce a log file, but not necessaril' an output file+ What are the logfile and output file naming conventions? Logfiles l/re,uest i#0+re, !utput files If $APPCP*A1 is not set /username0+/re,uest i#0 If $APPCP*A1 2 345I6 o/re,uest i#0+out If $APPCP*A1 2 $S43 /username0+out 7here /re,uest i#0 2 The re,uest i# of the concurrent re,uest An# /username0 2 The i# of the user that submitte# the re,uest How do I check if Multi-org is installed? SELECT multi_org_flag F O! fn"_pro"uct_group#$ How do I find out what the currently installed release of Applications is? SELECT r%l%a#%_nam% F O! fn"_pro"uct_group# How do I find the name of a form? "$I $se 8elp90About !racle Applications Scroll #own to fin# the form name Character $se :8elp90;ersion How do I lookup O A errors? !and "#$ errors% $se oerr ora <<<< or oerr tns <<<< where <<<< is the error number =This also supports a number of other error t'pes+ $se the >9letter error prefi& in place of ?ora?@

)APage

How do I generate a message file !usaeng&ms'%? $se F&'!'C!F appl#(#/p)" 0 * APP u#a%ng where appls's%pw# is the APPLSBS user an# passwor# an# APP is the short name of the application =like P! or I*;@ How do I su'mit a concurrent request from ()*$+)? $se F*6-345$4ST+S$C1IT-345$4ST 4&ample r%+_i" ,= F&'_ E-UEST.SU/!0T_ E-UEST12F&'23 2F&'SCA U24$ *ote that this can onl' be calle# from a concurrent program See the Co#ing Stan#ar#s for parameter #etails How do I cancel a running concurrent request? *avigate to the Concurrent 3e,uest Summar' form Select a re,uest In character, #o a 5uickpick on the Status column Bou can select Cancel or 8ol# In "$I, use the Cancel or 8ol# buttons The S'sa#min responsibilit' can cancel or hol# an' running re,uest Why can,t I find adrelink on my #" A(()-"O(? This is a trick ,uestion rightD There is no a#relink, we suppl' e&ecutables pre9built+ There is no nee# to relink as on $*I<+ There is also no a#unloa#+ Why can,t I use character mode on #"? Bou?re Eust full of trick ,uestions to#a'+++ Applications for *T #oes not inclu#e character mo#e forms+ Why does Help-."ools-./0amine ask for a password? The profile option $tilities 6iagnostics is set to *! This profile option controls whether users can use the 4&amine utilit'+ The passwor# shoul# be the APPS passwor#+ How do I set the name of the site that shows up under Help-.A'out Oracle Applications? Set the profile option ?Site *ame? How do I open a form in query-only mode? *avigate to the Form Functions form =Application90Function@ 5uer' the particular form an# a## the parameter 5$43B-!*LB2B4S *ot all forms will accept this parameter however+ How do I find the version of an installed product? !such as eports1 $+)2#et etc&% !ne of the easiest wa's is to run the pro#uct if 'ou can+ 3unning 3eports #esigner will give 'ou the 3eports version, running S5LFPlus will give 'ou its version etc+ Another eas' wa' is to launch the !racle Installer an# look in the installe# pro#ucts on the right si#e+ It will list all the pro#ucts installe# with their versions+ Another wa' is to look at the +rgs file+ This file is locate# in $!3ACL4-8!14%orainst !n $*I<, it will be calle# uni&+rgs+ !n the PC, it will be calle# 7in#ows+rgs+ This file will list all the pro#ucts installe# an# their versions+ *ote though that this file is not alwa's correct+ For e&ample, patching 3eports from G+H+H+I to G+H+H+J will not show up in this file as the new version+ 3unning 3eports 6esigner is the best wa' of getting the correct version+ GAPage

Also, on $*I< there is an e&ecutable calle# ?insp#ver?+ It is locate# in $!3ACL4-8!14%orainst+ 3unning it will pro#uce a #ispla' of all the installe# pro#ucts+ It Eust pulls the information from uni&+rgs, so it ma' show the wrong information as well+ I 3ust ran AutoInstall successfully1 'ut I don,t have character mode4 !on 5#I6% Bou probabl' picke# ?Server? when aske# what t'pe of installation to #o+ This choice installs ever'thing e&cept the character mo#e forms an# e&ecutables+ The choice 'ou wante# to pick was ?Stan#alone?+ Bou can recreate character mo#e b' unloa#ing the forms #irectories, regenerating the forms, an# relinking aiap+ I changed a profile option1 'ut it doesn,t seem to take effect? Profile option values are cache#, so 'ou nee# to log out an# back in in or#er to have the new value take effect+ Switching responsibilities will usuall' #o it too+ How do I generate one single form? =As oppose# to using a#a#min to generate them all@ Character mo#e forms $se a#frmgen $sage a"frmg%n fil%li#t=5nam% of fil%li#t fil%6 or a"frmg%n pro"uct=7pro"uct #8ortnam%1#47 9fil%pat8=7"ir: pat8/fil%nam%7; For e&ample a"frmg%n fil%li#t=fil%li#t.t<t a"frmg%n pro"uct=7gl7 fil%pat8=7form#/GL=SS!T*.inp7 1on% fil%4 a"frmg%n pro"uct=7gl7 fil%pat8=7form#7 1%ntir% "ir%ctor(4 a"frmg%n pro"uct=7gl7 1%ntir% pro"uct4 a"frmg%n pro"uct=7fn" gl7 1multipl% pro"uct#4 a"frmg%n pro"uct=7fn" gl7 fil%pat8=7form#7 =entire #irectories from multiple pro#ucts@ "$I forms use f>?g%n $sage f>?g%n mo"ul%=5#ourc% fil%6 u#%ri"=5App# account/pa##)or"6 output_fil%=5"%#tination fil%6 mo"ul%_t(p%=form @atc8=(%# compil%_all=#p%cial 4&ample f>?g%n mo"ul%=/u1A/appl/nca/au/1.0/form#/US/F&'CP!CP.fm@ u#%ri"=APPS_APP'E!O/APPS output_fil%=/u1A/appl/nca/fn"/B.?/form#/US/F&'CP!CP.fm< mo"ul%_t(p%=form @atc8=(%# compil%_all=#p%cial *ote that in 3elease )), a#a#min will allow 'ou to compile specific forms What do I do if I am missing an e0ecuta'le from my A(()-"O(? Cinar' e&ecutables are create# with a#relink+ For e&ample, if a##mimp is missing use
a"r%linC forc%=( ranli@=( 7a" a""mimp7

In elease 771 where do I apply all of these new patch drivers? =i+e+ where #o I appl' the c #river, the # #river an# the g #riverD@ >APage

The ?c? #river is the cop' #river+ It copies files an# relinks e&ecutables, similar to the ol# patch+#rv+ The ?#? #river is the #atabase #river+ It runs scripts against the #atabase like the ol# #b #river+ The ?g? #river is new to release ))+ It is the generate #river+ It generates forms, reports, an# message files+ In a multiple9tier environment, 'ou shoul# appl' the cop' #river to all tiers, the #atabase #river to the a#ministration tier, an# the generate #river to the forms an# concurrent processing tier+ =Some of these ma' be the same tier@ A#patch will ask ,uestions about what kin# of APPL-T!P it is in, so it will know what portions of the #river to run+
UNIX questions

I know the name of a 5#I6 command1 'ut I don,t know what it does? $se the ?whatis? comman# whatis will give a brief #escription of the comman# 4&ample $ )8ati# gr%p grep grep =)@ 9 search a file for a pattern

O8& I know what a 5#I6 command does1 'ut I can,t remem'er the name? $se ?man 9k? This will #o a ke'wor# search of the man pages 4&ample $ man :C gr%p egrep egrep =)@ 9 search a file for a pattern using full regular e&pressions fgrep fgrep =)@ 9 search a file for a character string fmlgrep fmlgrep =)f@ 9 search a file for a pattern grep grep =)@ 9 search a file for a pattern nisgrep nismatch =)@ 9 utilities for searching *ISK tables What are &o files? &a files? 7hen a programmer writes a program, he begins b' writing the co#e in a programming language+ This ?source co#e? is kept in a te&t file+ 7hen he is rea#' to buil# the program, he runs the source co#e te&t through a compiler+ This translates the source co#e into ?obEect co#e?+ !bEect co#e is in a format that is un#erstan#able b' the machine+ =?1achine language?@ *ote that obEect co#e is not portable across platforms+ The same source co#e compile# on a Solaris machine will pro#uce a #ifferent +o file when compile# on a 8P9$< machine+ All obEect files =+o, +a, +so@ cannot be copie# across #ifferent platforms+ 7hen all the obEect co#e is compile#, the programmer ne&t collects all the obEect files, an# runs them through the linker+ The linker basicall' collects all the obEect co#e, along with an' other necessar' co#e, an# pro#uces an e&ecutable =or ?binar'?@ !bEect co#e can also be collecte# into a librar' file, or archive+ =+a file@ This file is create# b' the ?ar? comman#+ It Eust collects all the obEect co#e into one file, an# a##s a table of contents to it+ Librar' files can be linke# into an e&ecutable the same wa' as +o files+ !racle #elivers its co#e =e&cept for the *T platform@ as +o or +a files+ These files are run through the linker to pro#uce e&ecutables+ What are &so files? +so files contain obEect co#e like +a an# +o files+ 8owever, these libraries are not linke# in when the programmer creates the e&ecutable+ Instea#, the' are loa#e# in when the program runs+ This allows the librar' to be share# among multiple programs, hence the name ?share# IAPage

libraries? =on 7in#ows, these are calle# 6LLs@ If a program cannot fin# the share# libraries it nee#s, it will not run+ See also the ,uestions on l## an# L6-LIC3A3B-PAT8+ How do I tell an H(79&:9 o'3ect file from an H(77&9 o'3ect file? The preferre# wa' to tell whether an obEect was built with 8P9$< )(+G( or 8P9$< ))+( is use the o#ump comman#+ o"ump :comp 5o@D%ct nam%6 The 9comp switch will give 'ou the flags with which the obEect was compile# as will as the revision+ The revision number for obEects built with )(+& will appear as LA+)(+&&L where && is #epen#ent on the e&act revision an# patch level+ For ))+( obEects, the revision number will appear as LA+))+&&L+ What is the 'est way to kill a process? First, use ps to get the process i# =PI6@ Tr' using Cill 5pi"6 This will give the process a chance to clean up after itself, like removing temp files, etc+ Some processes will not accept or ignore this signal+ If the process #oes not go awa', use kill 9. /pi#0 This signal cannot be ignore#, it will #efinitel' kill the process+ The process will not have a chance to clean up after itself though+ $se kill 9. onl' if necessar'+ *ote that 'ou must be the process owner or the superuser to kill a process+ How a'out killing defunct processes? Bou can?t #o it+ 6efunct processes are alrea#' #ea#, the s'stem Eust has not been able to clean up the process because the parent process is not respon#ing+ How do I get a process to coredump? Sen# it the 5$IT signal+ This is usuall' #one with Control9: It will cause the process to e&it an# generate a core file+ Bou can also use Cill :# S0G-U0T 5pi"6 What does ,&&don,t know how to make target 666, mean? Applications uses the ?make? comman# to buil# e&ecutable programs+ ?1ake? uses a ?makefile?, which is basicall' a list of programs to buil# an# instructions on how to buil# them+ These programs are calle# ?targets? in the makefile+ 7hen 'ou sa' ?make <<<?, it looks in the makefile for a target calle# ?<<<?, an# follows the instructions there to buil# it+ If it cannot fin# the given target in the makefile, it returns this error+ So either )+ A wrong name was passe# to the make comman# G+ The make file #oes not contain the given target+ This coul# mean that 'ou nee# a newer version of the makefile If the error points to a +o file, as in <<<+o, it coul# mean that the +o file is missing+ 7hat happens is, make fin#s the target in the makefile, sees that it #epen#s on the +o file, an# looks for the +o file in the files'stem+ 7hen it #oes not fin# it, it tries to make the +o file b' looking for a target for the +o file+ 7hen it #oes not fin# this target, it returns the error+ *ote that a#relink uses makefiles calle# $P3!6-T!P%lib%pro#+mk 7here ?pro#? is the short name of the pro#uct, like fn#+mk an# inv+mk How do I use the modem pool? telnet appsmp() useri# is aol no passwor# HAPage

t'pe c out t'pe at#t /phone number0 How do I telnet outside the firewall? t%ln%t gat%C%%p%r1 conn%ct 58o#tnam%6

aut8 5u#%rnam%6Eu# enter the response value from 'our S*M

How do I uuencode a file for mailing? $se uu%nco"% fil%nam% fil%nam% 6 fil%nam%.uu% $se uu#eco#e to #eco#e an enco#e# file How do I use ldd? The $*I< comman# ?l##? lists #'namic #epen#encies of e&ecutables or share# obEects+ Casicall', it is use# to list what share# libraries an e&ecutable #epen#s on+ 7hen an e&ecutable is launche#, it e&pects to loa# certain share# libraries =similar to 7in#ows 6LLs@ It uses the environment variable L6-LIC3A3B-PAT8 to fin# these share# libraries+ L6-LIC3A3B-PAT8 contains a list of #irectories, each of which will be searche#+ =similar to the PAT8 variable@ l## /e&ecutable name0 will #ispla' all the share# libraries the e&ecutable nee#s, an# where the librar' was foun#+ 8ere is an e&ample $ l"" a"aimgr li@m.#o.1 =6 /u#r/li@/li@m.#o.1 li@"l.#o.1 =6 /u#r/li@/li@"l.#o.1 li@po#i<>.#o.1 =6 /u#r/li@/li@po#i<>.#o.1 li@#unmat8.#o.1 =6 /u1A/oracl%B/pro"uct/B.F.F/li@/li@#unmat8.#o.1 li@c.#o.1 =6 /u#r/li@/li@c.#o.1 li@uc@.#o.1 =6 /u#r/uc@li@/li@uc@.#o.1 li@r%#olG.#o.H =6 /u#r/li@/li@r%#olG.#o.H li@%lf.#o.1 =6 /u#r/li@/li@%lf.#o.1 li@intl.#o.1 =6 /u#r/li@/li@intl.#o.1 li@mp.#o.1 =6 /u#r/li@/li@mp.#o.1 li@).#o.1 =6 /u#r/li@/li@).#o.1 This lists all the libraries a#aimgr e&pects to loa#, an# where the' are locate#+ $sing l"" :# will also show the search path l## use# to fin# the libraries $sing l"" :G will list a more verbose output See the l"" man pages for more information+ =See frhp)(+fr+oracle+com%ports+html for the comman# to use on platforms other than Solaris@ How can I capture ;write messages to a file? $se I)gc :tt(mo"% 66I).log Bou can a## this line to 'our +profile How do I cut*copy from a ;write message? 8ol# #own the shift ke' while selecting the te&t+ How do I lookup a 5#I6 signal num'er? NAPage
li@#ocC%t.#o.1 =6 /u#r/li@/li@#ocC%t.#o.1 li@n#l.#o.1 =6 /u#r/li@/li@n#l.#o.1

$se Cill :l This will list the signals an# their numbers Also, look in /u#r/inclu"%/#(#/#ignal.8 All the signals are liste# in here as well How do I set the setuid*setgid 'it? A## a fourth #igit to the ?c8mo"? comman# For e&ample, to set permissions to OHH 'ou woul# normall' use c8mo" OHH To set the #%tui" bit, a## a I before the OHH, like c8mo" IOHH To set the #%tgi" bit, use c8mo" GOHH To set them both, use c8mo" NOHH !r, use the s'mbolic metho# like c8mo" uJ#/c8mo" u:# =to set%unset the setui# bit@ c8mo" gJ#/c8mo" g:# =to set%unset the setgi# bit@ =3emember, the oracle e&ecutable must have the setui# bit set or no other users besi#es oracle will be able to connect to the #atabase@ How do I get the value of $HMMA6? Solaris use 2#(#"%f K gr%p SL!!A=2 8P9$< use 2gr%p SL!!A= /u#r/conf/ma#t%r."/cor%:8pu<2 I want to e3ect the cdrom1 'ut it says it is 'usy& How do I find who has it locked? $se the ?fuser? comman# T'pe fu#%r :u /c"rom =or whatever mount point the c#rom is on@ This will give a process I6, followe# b' a letter The letter ?c? in#icates this process is using the %c#rom #irector' as it?s current #irector' From the process i#, 'ou shoul# be able to fin# the user I,m trying to uncompress a file that I know is in this directory1 'ut it keeps telling me the file cannot 'e found? 1ake sure the file has an e&tension of +P =capital P@ $ncompress will tr' to a## the e&tension if it #oes not have it an# 'ou will get something like this $ uncompr%## ?0>F0?t.I H(I>(Ht+Q+P *o such file or #irector' How do I remove a file that 'egins with a hyphen? !)ike -filename% rm will normall' complain about an invali# option if 'ou sa' rm 9filename 1ost $*I< comman#s will bhave this wa', treating the characters after the h'phen as an option+ rm has an option to sa' ?en# of options, the ne&t parameter is a filename? The option is ?99? =#ouble h'phen@ So 'ou can use rm :: :fil%nam% 1ost $*I< comman#s have a 99 option like this to signif' en# of options+ My /scape key does not work in vi? Help4 "o to 'our *C6 boot server machine =orlsun), G, )(, or ))@ There shoul# be a file calle# ?&h? in 'our home #irector'+ A## these two lines to the file /u#r/op%n)in/@in/<mo"map :% 2C%(co"% M = graG% a#ciitil"%2 N /u#r/op%n)in/@in/<mo"map :% 2C%(co"% 1> = E#cap%2 N 3eboot 'our *C6+ *ow, the R ke' =at the top left of the ke'boar#@ is now the 4scape ke'+ OAPage

The R an# S are on the ke' between the Shift ke' an# P+ =Control9T also works as 4scape@
Net orkin!

How do I start a $+)2#et trace? !on the client% In s,lnet+ora, set T ACE_LEOEL_CL0E&T=1A
T ACE_F0LE_CL0E&T=5fil%nam%6

=to use a #ifferent file name, #efault is s,lnet+trc@

T ACE_'0 ECTO *_CL0E&T=5pat86

=to put the trace file in a #ifferent #irector', #efault is !3ACL4-8!14:network:trace@ How do I start a $+)2#et trace? !on the listener% $se, l#nrctl trac% 1A
l#nrctl trac% off

!r In listener+ora, set T ACE_LEOEL_L0STE&E =1A T ACE_F0LE_L0STE&E =5fil%nam%6 =to use a #ifferent file name, #efault is listener+trc@ T ACE_'0 ECTO *_L0STE&E =5pat86 =to put the trace file in a #ifferent #irector', #efault is $!3ACL4-8!14%network%trace@ How do I start*stop the "#$ listener? To start the listener l#nrctl #tart 9li#t%n%r nam%; To stop the listener, l#nrctl #top 9li#t%n%r nam%; The listener #efault name is LIST4*43+ If the listener has a #ifferent name, 'ou must suppl' the name To reloa# the listener+ora file l#nrctl r%loa" 9li#t%n%r nam%; To check the status, l#nrctl #tatu# 9li#t%n%r nam%;
"eports#$rintin!

How do I run reports from the commandline? arH?run u#%ri"=app#/app#E"ata@a#% "%#t(p%=fil% "%#nam%=tr(.out "%#format=$F&'_TOP/#r)/L @atc8=(%# r%port=5pat8 to r%port6 Substitute the report name 'ou want to run+ $se the srw file appropriate for the report The output will be in the tr'+out file How do I run ar:<run in de'ug mode? $n#er $F*6-T!P%bin there shoul# be two files arGHrun, an# arGHrun# 3ename arH?run to arH?run.#aG% 3ename arH?run" to arH?run *ow, whenever a report is run, it will pro#uce a log file calle# arG(run+log This file will contain the comman# line use# to run the report, as well as the environment =*ote that this will not actuall' run the report@ JAPage

How do I relink eports? c" $O ACLE_LO!E/r%port#H?/li@ maC% :f in#_r%port#H?.mC cin#tall maC% :f in#_r%port#H?.mC min#tall How do I install $+)2 eport? !n the )(+O C6, there is a #irector' calle# r#bmsO>G+ $n#er this is a #irector' calle# rptpatch+ Cop' this #irector' to 'our local #isk an# run the script ?patchutil+sh? !n 8P9$<, the #irector' #oes not e&ist on the C6+ Instea#, there is a file calle# PATC84S+ Cop' this file to 'our #isk an# e&ecute cpio :ic"Gu 5 7PATCLES$17 What are the different eports e0ecuta'les? The Applications versions =These are linke# with Applications user e&its@ arGH#esb 3eports 6esigner arGHrun 3eports runtime 9 ascii arGHrunb 3eports runtime 9 bitmappe# arGHrun# 3eports runtime 9 #ebug version The regular 3eports versions rGH#esm 3eports 6esigner rGHrun 3eports runtime 9 ascii rGHrunm 3eports runtime 9 bitmappe# How do I trou'leshoot print driver pro'lems? !ne techni,ue is to create a shell script that will capture the print comman# an# arguments the concurrent manager is using+ )@ Create the following shell script an# place in a #irector' in the concurrent managers PAT8 =such as %usr%bin@ G@ "ive e&ecute privileges to the script >@ Shut #own the managers I@ Pick a print #river an# a## the name of the script before the lp comman# in the Arguments fiel# eg+ t%#tprt lp :c :"$P OF0LES$.P 0&TE +++ H@ 1ake sure this #river is assigne# to a st'le an# a printer N@ Start the managers O@ Print a report using this #river J@ The output shoul# look like 1on Uul N )( I. >I 46T )..J Arguments are lp 9c 9#orlprt) 9n) 9tPF43"$S!+)IHOHI( %usr%tmp%!FAAAa(()!-+t The script is VW%bin%sh =#ateX echo ?Arguments are ?$FXcat@ 00%tmp%oracle9wws+log This is for print #rivers with st# input set to 'es For #rivers with st# input set to no, remove the ?cat? comman# Bou will see the actual comman# e&ecute# b' the concurrent manager, an# an' arguments passe# to it+ Bou shoul# be able to e&ecute this from the comman# line+ From the e&ample above, we see that lp is being calle# to print one cop' on printer orlprt), with the title being ?PF43"$S!+)IHOHI(? .APage

The last argument is the file to be printe#+ Bou can open up this file an# see the escape co#es at the top an# bottom+ From this information, 'ou can #etermine if the concurrent manager is using the correct arguments an# escape co#es+ If ever'thing looks !M, an# the problem replicates from the comman# line, the problem ma' be with the printer or the !S print services+ How do I add escape codes at the 'eginning of a report? !pen the report in vi =*ote that ?more? #oes not alwa's #ispla' escape co#es@ A## an escape character with Ctrl9; Ctrl9T This will show up as YT This correspon#s to the %e in the form+ 4g+ if 'ou have the escape co#e %eZk>" in the form, a## Ctrl9; Ctrl9T Zk>" This will show up as YTZk>" !nce 'ou a## the escape co#es, 'ou can use ?lp? to print the report+ This lets 'ou troubleshoot the correct escape co#e se,uence much faster than submitting a report+ How do I get a title printed on the 'anner page of a report? $se the ?9t? option of lp A## this option to the arguments fiel# in 'our print #river+ For e&ample, the comman# line might look like lp :c :t 7T8i# i# t8% titl%7 :"$P OF0LE$.P 0&TE +++
Alerts

How can I find an event alert trigger? Bou nee# to know the name of the table the event alert is on Connect as APPS in S5LFPlus SELECT trigg%r_nam%3 ta@l%_nam%3 #tatu# F O! u#%r_trigg%r# PLE E ta@l%_nam% = 2TA/LE_&A!E2X Alert triggers will have names like AL3-TACL4-*A14-IA3 or AL3-TACL4-*A14-$A3 the IA3 trigger is the I*S43T trigger, the $A3 trigger is the $P6AT4 trigger Selecting T3I""43-C!6B from $S43-T3I""43S will give the te&t of the trigger
%oncurrent &ana!er

=heck*set the (MO# method? To check the P1!* metho# )@ c" $F&'_TOP/#+l
H4 #+lplu# app#/app# Eafimc8C.#+l

This will tell whether the internal manager is running, what the P1!* metho# is, an# where the log file is To set the P1!* metho# )@ first shut the concurrent managers #own G@ c" $F&'_TOP/#+l F4 #+lplu# app#/app# Eafimpmon.#+l LOCQ

1or

'/!S4

/na'le*disa'le the =onflict esolution Manager? $se the s'stem profile option ?Concurrent $se IC1? Setting this to *o =which is the #efault@ allows the C31 to be starte#

)( A P a g e

Setting it to Bes causes the C31 to be shut#own an# the Internal manager will take over the conflict resolution #uties+ If the C31 will not start =it is starte# automaticall' b' the IC1@, check this profile option+ =lean out the =oncurrent Manager ta'les? First, be sure to shut#own the managers As the APPLSBS user 'ELETE from fn"_concurr%nt_proc%##%#$ UP'ATE fn"_concurr%nt_+u%u%# SET running_proc%##%#=03 ma<_proc%##%#=0$ 'ELETE from fn"_concurr%nt_r%+u%#t# PLE E #tatu#_co"%=2T2$ If 'ou #o not nee# the information in fn#-concurrent-re,uests an# it is getting ver' large, 'ou can truncate this table as well+ This also works to shut#own the concurrent managers after killing the !S processes+ "ell concurrent manager processes apart? $se pf :%f K gr%p F&'L0/ This will pro#uce output like v#)) )>O(> )>NN( ( 1a' )) D ( () F*6LIC3 F*6 Concurrent-Processor 1A*A"4 !L!"I*2LAPPS%.IAI.)A)(((((((((((((((((( n)(O()N) GI.>N GI.GO ( Apr G. D ( (H F*6LIC3 F*6 Concurrent-Processor 1A*A"4 !L!"I*2LAPPS-APP641!%.ICIC)C)(((((((((( n)(O()N) GI.>J GI.GO ( Apr G. D ( (N F*6LIC3 F*6 Concurrent-Processor 1A*A"4 !L!"I*2LAPPS-APP641!%.ICIC)C)(((((((((( n)(O()N) GI.GO GI.GG ( Apr G. D G (> F*6LIC3 F*6 CP1"3 F*6CP1C3 s'smgr 2LL sleep2N( pmon2G( #iag2* logfile2%u)N%app The last process, VGI.GO, shows ?F*6LIC3 F*6 CP1"3? This one is the Internal concurrent manager *otice that it gives some of the parameters it was starte# with+ The other processes showing ?Concurrent-Processor? are Stan#ar# manager processes *otice that the Internal manager process is the parent process of the Stan#ar# managers+ =processes GI.>N an# GI.>J@ !ther managers will have the name of the e&ecutable, like A3LIC3 or I*;LIC3
$ p# :%f K gr%p A L0/

v#)) )>NJ> )>NN( ( 1a' )) D ( G( A3LIC3 APPS%JGAGAI.I((((((((((((( ((((((((((((((((((((((((((((((((((((((( A3 A3T The Conflict 3esolution manager will look like
$ p# :%f K gr%p F&'C !

n)(O()N) GI.I) GI.GO ( Apr G. D ) )O F*6C31 APPS-APP641!%JICFC4C.((((( ((((((((((((((((((((((((((((((((((((((((((((((

)) A P a g e

I hit the estart 'utton to start the $tandard manager 'ut it still didn,t start? Telling a manager to restart Eust sets the status to 3estart+ The IC1 will start it the ne&t process monitor session or the ne&t time the IC1 starts+ $se Activate to start a manager imme#iatel'+ Also, when a manager is #eactivate# manuall', the IC1 will not restart it+ Bou will nee# to set it to 3estart, or activate it manuall'+ Why does the >to start> date of my concurrent request default to :? hours in the past? The short stor' If 'ou get patch >JOO.J, then this behavior can be turne# on an# off using the profile LConcurrent 1ultiple Time PonesL+ The long stor' This behavior is a temporar' fi& until we can buil# time Qone support into the pro#uct in a future release+ If the profile LConcurrent 3e,uest Start TimeL is set, then we #efault the Lto startL #ate of a re,uest to that value+ !therwise we assume that the user wants the re,uest to start as soon as possible+ Problems occur when the user is in a time Qone that is ahea# of the time Qone in which the concurrent managers are running+ Sa' a user submits the re,uest in a fiel# office in the 4astern time Qone at . ((, so we #efault the re,ueste# start #ate to . ((+ Cut now the concurrent managers are at 85 in California, so user?s re,uest will run at . (( Pacific time, )G (( 4astern+ In or#er to #efault re,uests to start as soon as possible, we submit them to start GI hours before their re,uest #ate+ This covers the worst case time Qone #ifference+ =an I su'mit a report set using =O#=$5@? *o, 'ou ma' not+ This is #ocumente# in bug >>I>>O+ How do I su'mit a request with =O#=$5@ that has a null parameter? $se ?LL? as the null parameter+ =Single ,uote, #ouble ,uote, #ouble ,uote, single ,uote@ How can users su'mit requests with =O#=$5@ without giving them the A(($ password? Tr' this )+ As the applmgr user, create a shell script that runs C!*CS$C 4ither har#co#e the parameters for the report, or pass them in as parameters to the script+ G+ Change the permissions on this script to O((+ *ow no one can rea# this script an# get the passwor#+ >+ Create another script that calls the first script+ Pass parameters along if 'ou nee# to+ I+ Change the permissions on this script to NOHH+ *ow an' user can e&ecute an# rea# the secon# script, which calls the first one+ 8ave the users run this script to submit their re,uests without knowing the passwor#+ What is the synta0 for controlling the concurrent manager using startmgr and concsu' in #"? !n *T, the concurrent manager is run as an *T service+ Bou start an# stop the managers using the Services control panel+ See the Applications Installation manual for *T, Appen#i& A for #etails+ See pg+ H9. of this manual for instructions on creating the concurrent manager service+
N%A

Ao I need to reinstall the 7B&7 server patches when I install #=A? *!W See the )(+O *CA install manual+ Chapter G sa's that if 'ou previousl' installe# )G A P a g e

the )N+) server patches, 'ou can omit all steps in the chapter+ The patches inclu#e# with )N+) an# the *CA server up#ates are e&actl' the same thing+ How do I get help files to work with the appletviewer? )@ Configure the virtual #irectories for the web server This is #ocumente# in the )(+O *CA installation notes an# the 3elease )) installation manual+ )(+O *CA calls for using oa9#oc, an# 3)) calls for !A-6!C+ 4ither wa', the virtual #irector' shoul# point to where the help files have been installe#+ G@ 1ake sure the parameter clientCrowser is *!T commente# out in the html file Bou shoul# remove the e&clamation mark at the beginning of the tag >@ 1ake sure that the path to *etscape =or whatever browser 'ou are using@ is inclu#e# in the PAT8 environment variable+ !ne wa' is to a## a line to the batch file that starts the appletviewer that appen#s to the PAT8 variable+ This wa', ever' time that the batch file is run, the correct path will be use#+ I@ 1ake sure the environment variable 84LP-CAS4-$3L is set on the Forms Server+ It shoul# be set to 8ttp,//#%rG%r nam%,port/oa:"oc In 3elease )), it is set with the profile option ?8elp S'stem Case $3L? 8ttp,//#%rG%r nam%,port/OA_'OC How do I get the Corms server to produce a diagnostic log file? See $sing Forms 3untime 6iagnostics 7hen using this with webforms, 'ou a## the Lrecor#2collectL parameter to the serverArgs parameter in 'our html file+ For e&ample, if 'our html file contains
5PA A! nam%=7#%rG%rArg#7 Galu%=7mo"ul%= ... F&'&A!=APPS6

Bou woul# change it like so

5PA A! nam%=7#%rG%rArg#7 Galu%=7mo"ul%= ... r%cor"=coll%ct F&'&A!=APPS6

How do I tell if the Corms $erver is running? $se ps 9ef Agrep fIH The forms server process is calle# fIHsrvm Bou will also see other processes name# fIHrunw+ There shoul# alwa's be at least one of these processes+ 4ach user that connects will spawn another fIHrunw process+ 4&ample $ p# :%f K gr%p f>? oracle NJ ) ( 1a' )) D ( (( fIHsrvm port2.((G pool2) oracle )JG.H NJ ( Uun )G D ( (( fIHrunw webfile2O,J( What is f?<runw? What happened to f?<we'm? For some reason, the fIHwebm e&ecutable is e&ecute# with the name fIHrunw+ The' are the same thing, fIHwebm is the name of the e&ecutable on #isk, an# fIHrunw is the name of the process+ How does my environment need to 'e set 'efore starting the Corms $erver? The Forms server nee#s to be starte# with a complete Applications environment, similar to starting the concurrent managers+ This means having APPL-T!P set, an# sourcing the APPLSBS+env environment file+ The Forms server will encounter man' problems, inclu#ing failing to start, if this is not #one+ What is f?<ctl for?

)> A P a g e

fIHctl is use# to start%stop the Forms server+ This wa', 'ou #o not nee# to start it in the backgroun#, an# the process will not terminate when 'ou log out+ f>?ctl R #tart K #top S port=port_num log=log_fil% 4&ample f>?ctl #tart port=M000 log=f>?log.t<t port number an# log file are optional, it will use .((( as the #efault port un the Corms server on a different port using the static html file? In the html file, a## the line
5PA A! nam%=7#%rG%rPort7 Galu%=7M00F76

after the other PA3A1 tags, using the port number 'ou want Then start the Forms server on that port Ao I need separate O A=)/-HOM/$ for my data'ase server and my Corms server if they are on the same machine? Bes, because 6evGM )+>+G is installe# in one, an# 6evGM )+N is installe# in the other+ Bou can install them both in one home, but 'ou will have problems when 'ou tr' to relink+ What a'out elease 77? In 3elease )), 6evGM )+N+) is use# for both Forms an# 3eports so 'ou can install the #atabase server an# forms server in one home+ =an I run more than 7 Corms server on a machine? Bes, on #ifferent ports+ What is the correct synta0 for running a local copy of the 3ar file? arc8iG%=7fil%,///c,/DaGa/D"C1.1.?.1A/app#cor%.Dar7 =$sing the correct path an# #rive letter for 'our PC@ =an I use the same html file for DInitiator as the appletviewer? *o, the UInitiator file contains /41C460 an# /!CU4CT0 tags instea# of an /APPL4T0 tag+ Bou will get an error using this file with the appletviewer+
'a(a#')*

How do I tell what version of the DA8 I am using? At a comman# prompt, t'pe Eava 9version How do I get a stack dump from the appletviewer? In the 6!S win#ow where appletviewer is running, hit Control an# Creak What is the difference 'etween the DA8 and D /? U34 is the Uava 3untime 4nvironment U6M is the Uava 6evelopers Mit The' both can run Uava programs, the U6M is also a full #evelopment environment+ It contains the Uava compiler an# other utilities re,uire# to create Uava programs, The U34 can onl' run the programs+ What is this =)A$$(A"H thing anyway? CLASSPAT8 is an environment variable the Uava interpreter uses to search for class files+ It is set to a colon separate# list of #irectories, similar to the PAT8 variable+ It it use# both to locate the Uava s'stem classes, an# user9written classes+ In Uava )+(, 'ou alwa's ha# to set it, or it woul# not be able to fin# the s'stem classes+

)I A P a g e

In Uava )+), the interpreter uses classes+Qip an# the current #irector' as a #efault if CLASSPAT8 is not set+ This means that using the )+) U6M on the PC, 'ou #o not nee# to set CLASSPAT8+ It also means that if 'ou #o set it, 'ou must inclu#e the #efaults, or the s'stem classes will not be foun#+ The U34 uses rt+Ear instea# of classes+Qip, so alwa's inclu#e this file in CLASSPAT8+ What is the story on those yellow 'ars on the appletviewer windows? The Uava securit' mechanism normall' prevents applets from performing certain actions on the user?s machine+ These inclu#e accessing the local #isk, launching programs, an# printing+ This is a goo# thing, since 'ou woul# not normall' want to #ownloa# an applet off the Internet an# have that applet be able to #o these things on 'our computer+ =That woul# spoil all the fun for the virus writers@ The 'ellow bars signif' that this is an ?untruste#? applet, an# it will not be allowe# to #o these things+ =Bou will not be able to print from Action90Print, or launch a browser to view 8elp files+@ !racle supplies a #igital certificate with Applications that essentiall' turns the applet into a ?truste#? applet, an# the 'ellow bars are not #ispla'e#+ This is the reason for running appscert+bat an# importing the certificate before running Apps+ How do I specify where I want the identityd'&o'3 file to 'e put on the client? The i#entit'#b+obE file is create# when Eavake' is first run+ =From appscert+bat@ This file is use# to hol# securit' information for the appletviewer In the E#k:lib:securit' #irector' is a file calle# Eava+securit' A## a line to this file i"%ntit(."ata@a#%=C,TT"ir%ctor(TTpat8 using the path 'ou want the file place# in *ote that 'ou must use #ouble backslashes Where can I find documentation on the appletviewer1 3avakey1 etc&? "o to the Tools 3eference Page at Sun?s website %%777+S$*+C!1
%usto+i,ation

How do I create a custom application? Step ) Create the #irector' Create a top #irector' for 'our pro#uct un#erneath $APPL-T!P+ 1ake sure applmgr has the correct ownership an# permissions+ Create sub#irectories un#erneath this #irector' that 'ou will nee#+ =bin, forms, log, out, lib, etc+@ A## an entr' into 'our APPLSBS+env file to set the pro#uct top environment variable PF_TOP=/u01/appl/pf
%<port PF_TOP

If 'ou will be creating custom )(SC forms, 'ou will nee# to create a top #irector' on the client PCs+ Create a Forms an# a 1esg #irector' un#erneath it, an# a## the pro#uct top environment variable to oaconfig+ora+ )H A P a g e

Step G Create the !racle I6 Create a new !racle I6 in the #atabase+ "ive the new schema an' roles an# privileges it will nee#+ At this time 'ou can run $A'_TOP/a"min/#+l/a"app##.pl# an# a"app#@.pl# to create the APPS-66L an# APPS-A33AB-66L packages+ Step > 3egister the !racle I6 *avigate to the 3egister !racle I6 form+ 4nter the custom !racle I6, passwor#, an# logical #atabase+ Select ?3egister? an# save the screen+ Step I 3egister the application *avigate to the 3egister Applications form+ 4nter the long an# short application name, abbreviation, an# pro#uct top environment variable+ Step H A## the application to a #atagroup *avigate to the 6efine 6ata "roup form+ A## 'our application to a #atagroup, using the APPS schema as the !racle I6+ Step N 3egister custom tables an# packages Custom tables an# in#e&es are create# in the custom schema, an# registere# with A!L using the A6-66 package+ See Appen#i& C of the Installation manual for an e&ample of this+ The APPS schema must have a s'non'm for all tables, an# be grante# privileges on them+ Custom packages an# proce#ures must be create# in the APPS schema+ *ow custom concurrent programs, forms, reports, etc+ can be registere# against 'our new application+ How do I register a custom concurrent program? Step ) 3egister a concurrent program e&ecutable *avigate to the 6efine 4&ecutable form =A!L 3eference manual pg .9JI@ This #etermines the t'pe of program being run, ie an !racle 3eport, a C program, a shell script etc+ Fill in the e&ecutable name, application an# e&ecution metho#+ For the 4&ecution File, fill in Eust the filename+ The concurrent manager will look in the appropriate #irector' un#er the application?s top #irector'+ For spawne# programs, the file must be in the bin #irector', for !racle 3eports the r#f file must be in the srw #irector'+ For PLS5L concurrent programs, put the name of the store# proce#ure+ Step G 6efine the concurrent program *avigate to the 6efine Concurrent Program form =A!L 3eference manual pg .9JO@ This form links a concurrent program to the e&ecutable 'ou Eust #efine#, as well as #efines the programs parameters, incompatibilities, an# other options+ 4nter the concurrent program name, application, short name an# #escription+ Check Stan#ar# Submission if 'ou want to be able to submit this program from the Stan#ar# 3eport Submission form+ 4nter the name of the e&ecutable 'ou #efine# an# an' report information if necessar'+ Also #efine an' parameters 'our program nee#s here an# an' incompatibilities+ Step > A## the concurrent program to a 3eport "roup First 'ou will nee# to fin# the name of the 3eport "roup to use+ )N A P a g e

"o to Securit'903esponsibilit' an# ,uer' the responsibilit' 'ou want to run the program with+ It shoul# show a 3eport "roup name+ 5uer' this name in Securit'903esponsibilit'9 03eport A## 'our new program to the list of available programs+ *ow when 'ou go to submit a re,uest with this responsibilit', 'ou will be able to submit 'our custom program+ How do I compile a custom = program? Spawne# programs Step ) 7rite the co#e
Step G Compile the source

Bou must use the makefile un#er $F&'_TOP/u#r<it $se maC% :f $F&'_TOP/u#r<it/!aC%fil% program.o 7e #o not support using an' other makefile Step > Link the program This part is a little trick'+ Bou nee# to create a custom makefile for this step+ $se $F&'_TOP/li@/#ampl%.mC as a starting point+ Cop' this file to the lib #irector' un#er 'our applications top #irector'+ 3ename it /short name0+mk =ie fn#+mk, gl+mk etc@ 1o#if' this file accor#ing to the #irections in it+ Casicall' 'ou nee# to a## a target an# buil# comman#s for 'our e&ecutable+ *e&t, use a#relink to link the e&ecutable a"r%linC forc%=( ranli@=( 7#8ortnam% programnam%7 Step I 3egister the program as in the above ,uestion Imme#iate programs Uust #on?t #o it+ How do I run a shell script as a concurrent program? ) 7rite the script an# call it /name0+prog Place the script un#er the bin #irector' un#er 'our applications top #irector'+ For e&ample, call the script C$ST!1+prog an# place it un#er
$CUSTO!_TOP/@in

G 1ake a s'mbolic link from 'our script to $F*6-T!P%bin%fn#cpesr For e&ample, if the script is calle# C$ST!1+prog use this
ln :# $F&'_TOP/@in/fn"cp%#r CUSTO!

This link shoul# be name# the same as 'our script without the +prog e&tension It shoul# be in the same #irector' as the script+ > 3egister a concurrent program as #escribe# above, using an e&ecution metho# of ?8ost? $se the name of 'our script without the +prog e&tension as the name of the e&ecutable For the e&ample above, 'ou woul# use C$ST!1 I Bour script will be passe# at least I parameters, in $) through $I These will be orau#%r/p)"3 u#%ri"3 u#%rnam%3 r%+u%#t_i" An' other parameters 'ou #efine will be passe# in $H an# higher+ 1ake sure 'our script returns an e&it status+ H If 'our script returns a failure e&it status but the concurrent manager #oes not report the error =shows it as still running normal@ appl' patch IIGJGI =an I run my custom forms with Corms Aesigner? )N9bit =SmartClient@ Bou shoul# be able to run forms with the Forms 6esigner that comes on the SmartClient C6+ The #ebugger will not work, however+ See bug )O A P a g e

>G9bit =*CA@ If the forms are A!L forms =ie create# from template+fmb@ the' cannot be run from the Forms 6esigner or Forms 3untime because these e&ecutables #o not have the A!L user e&its linke# in+ Bou will see man' F319I(J(( errors tr'ing to run forms this wa'+ Also see bug I)I))H that #escribes a problem with Forms I+H an# attaching libraries+ The onl' wa' to run these forms is through Applications+ Why do my ()$+) stored procedure concurrent programs error out withE ,Invalid num'er of arguments,? See pg+ .9O. of the A!L 3eference manual+ PLS5L concurrent programs must have G !$T arguments #efine#+ 34TC!64 is use# to return the error status 433C$F is use# to return an error message *ote that 'ou #o not nee# to #efine these arguments in the 6efine Arguments form, onl' in the proce#ure itself+ How come when I close my custom form using the ,6, close 'o0 I get an e0port window popping up? Bou nee# to look at the proce#ure APP-C$ST!1+CL!S4-7I*6!7 This proce#ure is #efine# in the T41PLAT4 form+ It contains instructions in the comments on how to mo#if' this proce#ure+ Bou must #o this for all of the custom forms 'ou write or 'ou will have problems closing the win#ow+ How do I preserve customi;ations through an upgrade? The upgra#e process ma' overwrite an' #ata owne# b' one of the !racle Applications+ 1ove all of 'our customiQations =menus, responsibilities, report groups, etc@ to a custom application+ After the upgra#e, 'ou can move them back if 'ou want+ =an I disa'le the items in the Help menu? !like "race1 Ae'ug1 etc% Bes+
-eb Applications

How can I assign responsi'ilities in elease 77 We' Apps? In 3elease )), regular applications users an# web users have been merge#+ This means that the same user name an# passwor# is use# to log into Apps an# 7eb apps+ Also, !SS7A responsibilities are assigne# in the 6efine $sers form, Eust like regular responsibilities+ This also means that F*6-74C-$S43S is no longer use#+ Where do I find the configuration files for the We'server? "o to $!3A74C-A61I* =usuall' $!3ACL4-8!14%ows%a#min@+ *avigate #own to the ows #irector', then into the site name #irector'+ There shoul# be a wrb #irector' here an# a http-servername #irector' here+ $n#er the wrb #irector' will be a config #irector' an# a log #irector'+ In config, 'ou will fin# a file calle# wrb+app+ This file contains the configuration for the 7eb 3e,uest Croker+ It is all the information 'ou enter on the a#min screens+ =ie, all the 6A6 info, cartri#ge info, virtual #irectories etc++@ The log #irector' of course hol#s log files+ Cack up in the http-servername #irector', 'ou will fin# #irectories for each listener+ In each #irector' there will be config an# log #irectories again+ In the config #irector' is a file calle# sv?listenername?+cfg =substitute the name of the listener@ This file hol#s the configuration for this listener+ )J A P a g e

)atabase questions

Which version of ,alter package, compiles 3ust the header? the 'ody? 'oth? ALTE PACQAGE pacCag%_nam% CO!P0LE 9 compiles the hea#er an# the bo#' ALTE PACQAGE pacCag%_nam% CO!P0LE PACQAGE 9 compiles Eust the hea#er ALTE PACQAGE pacCag%_nam% CO!P0LE /O'* 9 compiles Eust the bo#' How do I find the errors when a package will not compile? From S5LFPlus, ?show errors? will usuall' give 'ou the last error messages+ SELECT nam%3 t%<t F O! u#%r_%rror# will give 'ou the errors+ What is the 'est way to recompile invalid o'3ects? This has been #ebate#, but m' mone' is on a#a#min+ It uses the A6-PA3ALL4L-C!1PIL4-PM" to fin# invali# obEects, create a #epen#enc' tree of them, an# #ivi#es the Eobs up among multiple workers+ Also, the a#cmpusr script #oes the same thing, if a#a#min is not working, or 'ou reall' Eust want to run a script+ How do I get the version of a package or package 'ody? The table $S43-S!$3C4 contains the te&t of all the packages in the current schema+ 4ach package hea#er or bo#' will have a version number in the te&t, something like %F $8ea#er AFSC74CS+pls N)+( .J%(J%)> (. GN HN porting ship $ F% This shows that this package is version N)+( Bou can use SELECT t%<t F O! u#%r_#ourc% PLE E nam% = 5pacCag% nam%6 A&' TE=T L0QE 2U$L%a"%rU2$ This also shows the name of the file =AFSC74CS+pls@ that contains the C34AT4 statement for this package+ Bou can run this script if 'ou nee# to recreate this package+ How do I find the name of the script that creates a particular package header or 'ody? See the ,uestion above+ How do I 'ackup a ta'le? C EATE TA/LE @acCup_ta@l% AS SELECT V F O! ta@l%_to_@acCup$

). A P a g e