Reconfiguring Oracle Forms Developer Web

Cartridge Applications to CGI

An Oracle Technical White Paper
January 2000
INTRODUCTION

7UDGLWLRQDOO\ORDGEDODQFLQJVHUYLFHVLQ2UDFOH)RUPV6HUYHUZHUHVXSSOLHGYLDDQ2UDFOH
$SSOLFDWLRQ6HUYHU2$6FDUWULGJH,I\RXZDQWHGWRGHSOR\IRUPVRQWKH:HEYLDD&RPPRQ
*DWHZD\,QWHUIDFH&*,LPSOHPHQWDWLRQLQOLHXRIDQ2$6FDUWULGJHORDGEDODQFLQJZDVQRWDQ
RSWLRQ

:LWKWKHUHOHDVHRI2UDFOH)RUPV6HUYHUL\RXFDQQRZXVHORDGEDODQFLQJZLWKIRUPVDSSOLFDWLRQV
WKDWDUHGHSOR\HGRQWKH:HEYLDD&*,LPSOHPHQWDWLRQ

1RWH:LWKORDGEDODQFLQJZKHQ\RXDSSURDFKWKHXVDJHOLPLWVRI\RXUKDUGZDUHUDWKHUWKDQ
XSJUDGLQJRUUHSODFLQJDPDFKLQH\RXFDQVLPSO\DGGPRUHPDFKLQHVWRUXQ\RXUDSSOLFDWLRQDQG
EDODQFHWKHORDGRIVHUYHUWUDIILFDFURVVVHYHUDOPDFKLQHV
,I\RXKDYHDOUHDG\GHSOR\HG:HEEDVHG)RUPV'HYHORSHUDSSOLFDWLRQVYLDDQ2$6FDUWULGJHDQG
\RXZLVKWRVZLWFKWR&*,\RXZLOOQHHGWRLQVWDOO2UDFOH)RUPV6HUYHULDQGFRQILJXUHLWIRU&*,
,I\RXKDYHDOUHDG\LQVWDOOHG2UDFOH)RUPV6HUYHUL\RX·OOQHHGWRUHFRQILJXUHLWIRU&*,

7KHSXUSRVHRIWKLVSDSHULVWRKHOSWKRVHZLWKH[LVWLQJFDUWULGJHEDVHGLPSOHPHQWDWLRQVLQVWDOORU
UHFRQILJXUH2UDFOH)RUPV6HUYHULIURP2$6FDUWULGJHVWRQRQ2$6&*,

WHO SHOULD READ THIS PAPER?

7KLVSDSHUZLOOEHXVHIXOWR\RXLIWKHIROORZLQJVWDWHPHQWVDSSO\WR\RXUGHSOR\PHQWHQYLURQPHQW
· <RXFXUUHQWO\GHSOR\:HEEDVHG2UDFOH)RUPV'HYHORSHUDSSOLFDWLRQV
· <RXRZQ2UDFOH)RUPV6HUYHUL
· <RXXVH2$6IRU:HEVHUYHUVXSSRUW
· <RXGHSOR\:HEEDVHG2UDFOH)RUPV'HYHORSHUDSSOLFDWLRQVXVLQJ2$6FDUWULGJHV
· <RXZDQWWRPRYHIURPFDUWULGJHGHSOR\PHQWWR&*,

ASSUMPTIONS

7KLVSDSHUGHVFULEHVWKHSURFHGXUHV\RXZRXOGXVHRQDV\VWHPUXQQLQJRQHLWKHU:LQGRZV17RU
81,;

,QWKHVHFWLRQVWKDWGLVFXVV2$6WKLVSDSHUGHVFULEHVXVHULQWHUIDFHHOHPHQWVWKDWDSSHDULQ2$6
YHUVLRQVDQGKLJKHU,I\RXDUHXVLQJDYHUVLRQRI2$6HDUOLHUWKDQUHIHUWR\RXU2$6
GRFXPHQWDWLRQIRULQIRUPDWLRQRQKRZWRDFFRPSOLVKWKH2$6UHODWHGWDVNVGHVFULEHGKHUH

Reconfiguring Cartridge to CGI 2

November 1999
OVERVIEW

COMPARING CARTRIDGE AND CGI

&DUWULGJHDQG&*,LPSOHPHQWDWLRQVERWKUHTXLUHWKDW\RXVHWVHUYHURSHUDWLRQDOSDUDPHWHUVWKDW
GHILQHYDOXHVIRUVXFKWKLQJVDVSRUWQXPEHUVDQGORFDWLRQVRIUHOHYDQWILOHV7KHGLIIHUHQFHLVLQ
ZKHUH\RXVHWWKHP,Q2$6\RXRSHQWKH2$60DQDJHUDQGQDYLJDWHWRYDULRXVGHVWLQDWLRQVWRVHW
SDUDPHWHUVIRUGLIIHUHQWGHSOR\PHQWHQWLWLHV,Q2UDFOH)RUPV6HUYHUFRQILJXUDWLRQFRPSOH[LW\LV
PRUHFHQWUDOL]HG<RXVHWPDQ\RSHUDWLRQDOSDUDPHWHUVDXWRPDWLFDOO\WKURXJKFRQILJXUDWLRQFKRLFHV
\RXPDNHGXULQJLQVWDOODWLRQ<RXFDQUHYLVHDQGVHWDGGLWLRQDORSHUDWLRQDOSDUDPHWHUVLQ2UDFOH
)RUPV6HUYHU·VIRUPVZHEFIJILOHZKLFKLVFUHDWHGGXULQJLQVWDOODWLRQ

1RWH7KHIRUPVZHEFIJILOHLVGLVFXVVHGLQGHWDLOVWDUWLQJRQSDJH

&DUWULGJHDQG&*,LPSOHPHQWDWLRQVERWKSURGXFHDQ+70/ILOHRQWKHIO\WKDWLVURRWHGLQD
VWDQGDUGEDVH+70/ILOH,QDFDUWULGJHLPSOHPHQWDWLRQWKH+70/ILOHLVFUHDWHGWKURXJKD
FRPELQDWLRQRIWKHFDUWULGJKWPOILOHFDUWULGJHFRQILJXUDWLRQVHWWLQJVDQGWKHDSSOLFDWLRQ·V85/,Q
D)RUPV:HE&*,LPSOHPHQWDWLRQWKH+70/ILOHLVFUHDWHGWKURXJKDFRPELQDWLRQRIWKHEDVHKWP
RUEDVHMLQLKWPILOHWKHIRUPVZHEFIJILOHDQGWKHDSSOLFDWLRQ·V85/

,QERWKFDUWULGJHDQG&*,EDVH+70/ILOHV\RXFDQGHILQHDSDUDPHWHUZLWKDYDULDEOHDQGWKHQ
GHILQHWKHYDULDEOHYDOXHLQWKHDSSOLFDWLRQ·VFDUWULGJHVHWWLQJV2$6WKHIRUPVZHEFIJILOH2UDFOH
)RUPV6HUYHULRUYLDDTXHU\VWULQJLQWKHDSSOLFDWLRQ·V85/ERWK2$6DQG2UDFOH)RUPV
6HUYHU

7KHPDMRUGLIIHUHQFHVEHWZHHQFDUWULGJHDQG&*,LPSOHPHQWDWLRQVDUHLQWKHW\SHVRIVHUYLFHVDQG
OHYHORISHUIRUPDQFHRIIHUHGWKURXJK\RXUQRQ2$6:HEVHUYHUDVFRPSDUHGWRWKRVHRIIHUHG
WKURXJK2$6WKHEURDGHUUDQJHRIRSHUDWLRQDOSDUDPHWHUVQRZDYDLODEOHWKURXJK2UDFOH)RUPV
6HUYHULDQGWKHYDVWO\VLPSOLILHGSURFHVVRIVHWWLQJIRUPVSDUDPHWHUVYLD2UDFOH)RUPV6HUYHU
LQVWDOODWLRQDQGWKHIRUPVZHEFIJILOH

Reconfiguring Cartridge to CGI 3

November 1999
RECONFIGURATION STRATEGIES

1RWH7KLVVHFWLRQSURYLGHVDKLJKOHYHORYHUYLHZRIWKHUHFRQILJXUDWLRQSURFHVV,WLVVXLWDEOHIRU
XVHUVZKRKDYHDWHFKQLFDOXQGHUVWDQGLQJRI2$62UDFOH)RUPV6HUYHUEDVH+70/ILOHVDQG
WKHOLNH)RUDPRUHGHWDLOHGGHVFULSWLRQRIWKHHQWLUHSURFHVVUHIHUWRWKHUHPDLQLQJVHFWLRQVLQWKLV
SDSHU
7KHUHDUHWZREDVLFVWUDWHJLHVIRUUHFRQILJXULQJFDUWULGJHGHSOR\PHQWVWR&*,

· .HHSHYHU\WKLQJWKHVDPHUHSOLFDWLQJFDUWULGJHSDUDPHWHUVLQWKHIRUPVZHEFIJILOH
· 8VHWKHGHIDXOW2UDFOH)RUPV6HUYHULLQVWDOODWLRQ

7KHILUVWVWUDWHJ\LVDSSURSULDWHIRUXVHUVZLWKFRPSOH[EDVH+70/ILOHVWKDWLVILOHVWKDWFRQWDLQ
PXFKH[WUDQHRXVWH[WLPDJHVDQGRWKHUREMHFWVLQDGGLWLRQWRWKH)RUPVDSSOHWWDJV7KHVHFRQG
VWUDWHJ\LVDSSURSULDWHIRUXVHUVZLWKVLPSOHEDVH+70/ILOHV

Strategy for Users with Complex Base HTML files: Keep Everything the Same

1. 6WRSDOOLQVWDQFHVRI2$6\RXZLOOQRORQJHUXVH
 ,QVWDOO2UDFOH)RUPV6HUYHUL
 ,QVWDOOWKH:HE'%/LVWHQHURUVRPHRWKHU&*,FDSDEOH:HEVHUYHU7KH2UDFOH:HE'%
/LVWHQHULVSURYLGHGDWQRFRVWZLWK2UDFOH)RUPV6HUYHUL,WLVRIIHUHGDVDQLQVWDOODWLRQ
RSWLRQZKHQ\RXLQVWDOO2UDFOH)RUPV6HUYHUL
 ,QWKHIRUPVZHEFIJILOHUHSURGXFHWKHSDUDPHWHUVWKDWZHUHXVHGIRUFDUWULGJH
FRQILJXUDWLRQ
7RORFDWHFXUUHQW2$6FDUWULGJHSDUDPHWHUVODXQFK2$6DQGQDYLJDWHWRHDFKIRUPV
DSSOLFDWLRQ·V&DUWULGJH&RQILJXUDWLRQIROGHU:LWKLQHDFKIROGHUFOLFN&DUWULGJH3DUDPHWHUV
7KLVGLVSOD\VWKH2$6FDUWULGJHSDUDPHWHUVHWWLQJV$GGLWLRQDOO\\RXZLOOILQGSDUDPHWHU
VHWWLQJVLQWKHEDVH+70/ILOHV\RXFUHDWHGIRU)RUPVFDUWULGJHDSSOLFDWLRQV

5. ,I\RXZHUHXVLQJVHYHUDO2$6FDUWULGJHGHILQLWLRQVIRUWKH)RUPVFDUWULGJHWKDWLV\RX
ZHUHXVLQJVHYHUDOEDVH+70/ILOHVGHILQHVHSDUDWHFRQILJXUDWLRQVHFWLRQVLQWKH
IRUPVZHEFIJILOH³RQHIRUHDFKFDUWULGJH:LWKERWKVWUDWHJLHVWKHEHWWHUSUDFWLFHLVWR
FUHDWHQHZFRQILJXUDWLRQVHFWLRQVIRUFDUWULGJHSDUDPHWHUVLQWKHIRUPVZHEFIJILOHUDWKHU
WKDQVSHFLI\WKHSDUDPHWHUVDWWKHVWDUWRIWKHIRUPVZHEFIJILOHRXWVLGHDQDPHGVHFWLRQ
6. )RUDQRQ2$6:HEOLVWHQHUGHILQHWKHVDPHYLUWXDOSDWKV\RXXVHGZLWK2$67KH
LQVWDOOHUGRHVWKLVWDVNIRU\RXZKHQ\RXFKRRVHWRLQVWDOOWKH2UDFOH:HE'%/LVWHQHU$GG
DQHZYLUWXDOSDWKIRU&*,VFULSWVWKDWSRLQWVWRWKHGLUHFWRU\FRQWDLQLQJWKH)RUPV&*,
LIFJLH[HRQ17IFJLRQ81,;DVIROORZV
YLUWXDOBSDWKBQDPH GHYFJL

Reconfiguring Cartridge to CGI 4

November 1999
 17SK\VLFDOBSDWK 25$&/(B+20(?WRROV?ZHE?FJL
81,;SK\VLFDOBSDWK 25$&/(B+20(WRROVZHEFJL

7. &KDQJHDOOWKH85/·V\RXXVHWRUXQIRUPVWRSRLQWWRWKH&*,UDWKHUWKDQWKHFDUWULGJH
)RUH[DPSOHLIWKHRULJLQDO85/ZDV
KWWSVHUYHUQDPHP\GRPDLQFRPGHYHORSHUIRUPVIRUPVFDUW"PRGXOH HPSIP[

,WVKRXOGEHFRPH

17KWWSVHUYHUQDPHP\GRPDLQFRPGHYFJLLIFJLH[H"FRQILJ P\FRQILJ
PRGXOH HPSIP[
81,;KWWSVHUYHUQDPHP\GRPDLQFRPGHYFJLIFJL"FRQILJ P\FRQILJ
PRGXOH HPSIP[

,QWKLVH[DPSOH´P\FRQILJµLVWKHQDPHRIWKHFRQILJXUDWLRQVHFWLRQ\RXGHILQHGLQWKH
IRUPVZHEFIJILOHWKDWFRQWDLQVWKHSDUDPHWHUVHTXLYDOHQWWR\RXUROGFDUWULGJHSDUDPHWHUV

Strategy for Users with Simple Base HTML Files: Use the Default 6 i Installation

,I\RXUFDUWULGJHLPSOHPHQWDWLRQXVHGVLPSOHEDVH+70/ILOHV\RXUUHFRQILJXUDWLRQWR&*,FDQ
HDVLO\EHQHILWIURPWKHGHIDXOWFRQILJXUDWLRQWKDWLVFUHDWHGDXWRPDWLFDOO\GXULQJ2UDFOH)RUPV6HUYHU
LLQVWDOODWLRQ

1. 6WRSDOO2$6LQVWDQFHV\RXZLOOQRORQJHUXVH
2. ,QVWDOO2UDFOH)RUPV6HUYHUL
 ,QVWDOOWKH:HE'%OLVWHQHURUVRPHRWKHU&*,FDSDEOH:HEVHUYHU7KH2UDFOH:HE'%
/LVWHQHULVSURYLGHGDWQRFRVWZLWK2UDFOH)RUPV6HUYHUL,WLVRIIHUHGDVDQLQVWDOODWLRQ
RSWLRQZKHQ\RXLQVWDOO2UDFOH)RUPV6HUYHUL
4. &RQILJXUHYLUWXDOSDWKVZLWK\RXU:HEOLVWHQHUIRUXVHZLWK2UDFOH)RUPV6HUYHU7KH
LQVWDOOHUGRHVWKLVWDVNIRU\RXZKHQ\RXFKRRVHWRLQVWDOOWKH2UDFOH:HE'%/LVWHQHU
5. $GDSWWKH85/V\RXXVHGWRUXQ\RXUIRUPVWRDFKLHYHWKHVDPHHIIHFWDV\RXKDGZLWKWKH
FDUWULGJH8VHWKHSDUDPHWHUVWKDWDUHGHILQHGIRU\RXLQWKHIRUPVZHEFIJILOH7KHVHDOORZ
\RXWRFKDQJHMXVWDERXWHYHU\FRQFHLYDEOH+70/DQG)RUPV$SSOHWSDUDPHWHUYDOXHE\
VSHFLI\LQJWKHYDOXHLQWKHDSSOLFDWLRQ·V85/7KHVDPH85/ZLOOZRUNIRUXVHUVRIWKH
$SSOHW9LHZHUD:HEEURZVHULQFRPELQDWLRQZLWK2UDFOH-,QLWLDWRURU,QWHUQHW([SORUHU

6. 8VHWKHUXQIRUPKWPILOHWRH[SHULPHQWZLWKGLIIHUHQWSDUDPHWHUVHWWLQJVLQWKHDSSOLFDWLRQ·V
85/)RUH[DPSOHWKLVPLJKWEHWKH85/\RXZRXOGXVHWRUXQDIRUPZLWKDSDJHWLWOH
´0\)RUPµDSDJHZLGWKRIDQGDSDJHKHLJKWRI
17KWWSVHUYHUQDPHP\GRPDLQFRPGHYFJLLIFJLH[H"SDJHWLWOH
0\)RUP ZLGWK  KHLJKW 
81,;KWWSVHUYHUQDPHP\GRPDLQFRPGHYFJLIFJL"SDJHWLWOH
0\)RUP ZLGWK  KHLJKW 

Reconfiguring Cartridge to CGI 5

November 1999
 ,QWKHVHH[DPSOHVWKHTXHVWLRQPDUNVLJQDOVWKHVWDUWRIWKHTXHU\VWULQJLQWKHDSSOLFDWLRQ
85/7KHTXHU\VWULQJVSHFLILHVWKHYDOXHVIRUWKHSDJHWLWOHZLGWKDQGKHLJKWSDUDPHWHUV

,Q:LQGRZVHQYLURQPHQWV\RXFDQJHWWRWKHUXQIRUPKWPILOHYLDWKH´5XQD)RUPRQWKH
:HEµVKRUWFXWZKLFKLVFUHDWHGE\WKHLQVWDOODWLRQSURFHVV,Q81,;HQYLURQPHQWVVSHFLI\
DSDWKWRUXQIRUPKWPIRUH[DPSOH
KWWSVHUYHUQDPHP\GRPDLQFRPGHYKWPOUXQIRUPKWP

RECONFIGURING FORMS WEB CARTRIDGE TO CGI

7DNHWKHVHVWHSVWRUHFRQILJXUHIRUPVGHSOR\PHQWVIURP2$6FDUWULGJHWRQRQ2$6&*,

1. 6WRSWKH2$6:HE/LVWHQHULQVWDQFHV\RXZLOOQRORQJHUXVH
2. ,QVWDOO2UDFOH)RUPV6HUYHUL
 ,QVWDOOWKH:HE'%/LVWHQHURUVRPHRWKHU&*,FDSDEOH:HEVHUYHU7KH2UDFOH:HE'%
/LVWHQHULVSURYLGHGDWQRFRVWZLWK2UDFOH)RUPV6HUYHUL,WLVRIIHUHGDVDQLQVWDOODWLRQ
RSWLRQZKHQ\RXLQVWDOO2UDFOH)RUPV6HUYHUL
4. 3HUIRUPWKHDGGLWLRQDOFRQILJXUDWLRQVWHSVWKDWDUHVSHFLILHGLQWKHLQVWDOOHUJHQHUDWHG
GHYLFRQILJW[WILOH
5. &RQILJXUHWKH2UDFOH)RUPV6HUYHUIRUPVZHEFIJILOH
6. 2SWLRQDOO\FRQILJXUHWKH2UDFOH)RUPV6HUYHUEDVHKWPDQGEDVHMLQLKWPILOHV
7. %URDGFDVWWKHDSSOLFDWLRQ·V85/

7KHUHVWRIWKLVSDSHUGLVFXVVHVWKHVHVWHSVLQGHWDLO

STEP 1: STOPPING OAS WEB LISTENER INSTANCES

7KHUHDUHWZRVFHQDULRVIRUVWRSSLQJ2$6

· 6WRSLWFRPSOHWHO\
· 6WRSRQO\VSHFLILFLQVWDQFHVZKLOH2$6FRQWLQXHVWRVXSSRUWRWKHULQVWDQFHV

7KLVVHFWLRQSURYLGHVLQIRUPDWLRQIRUERWKVFHQDULRV

STOPPING OAS COMPLETELY

8VHWKLVWHFKQLTXHLI\RXZLVKWRVWRSXVLQJDOOVHUYLFHVRIIHUHGWKURXJK2$6

1. /DXQFK2$6
2. 2SHQWKH2$60DQDJHU
3. 1DYLJDWHWRWKHWRSOHYHOVLWHRIWKH2$6LQVWDOODWLRQ

Reconfiguring Cartridge to CGI 6

November 1999
 4. 6HOHFW$OO
5. &OLFNWKH6WRSEXWWRQ
STOPPING SPECIFIC INSTANCES OF OAS

8VHWKLVWHFKQLTXHLI\RXZLVKWRVWRSRQO\VRPH2$6+773/LVWHQHUVDQGOHDYHRWKHUVUXQQLQJ

1. /DXQFK2$6
2. 2SHQWKH2$60DQDJHU
3. 1DYLJDWHWR+773/LVWHQHUV
4. 6HOHFWWKRVH+773/LVWHQHUVUXQQLQJRQSRUWV\RXDUHSODQQLQJWRFRQYHUWIURPFDUWULGJHWR
&*,

1RWH,I\RXSODQWRLQVWDOOWKH2UDFOH:HE'%/LVWHQHU\RXPXVWVWRSDQ\2$6+773
/LVWHQHUWKDWLVUXQQLQJRQSRUW
5. &OLFNWKH6WRSEXWWRQ

STEP 2: INSTALLING ORACLE FORMS SERVER 6i

7KH2UDFOH)RUPV6HUYHULLQVWDOOHURIIHUVPDQ\DXWRPDWLFFRQILJXUDWLRQRSWLRQVGXULQJLQVWDOODWLRQ
7KHRSWLRQV\RXFKRRVHZLOOGHSHQGRQ\RXUQHHGVDQG\RXUHQYLURQPHQW,I\RXUGHSOR\PHQWQHHGV
FKDQJHRYHUWLPHWKHLQVWDOOHULV´UHHQWUDQWµ7KDWLV\RXFDQUHUXQWKHLQVWDOOHUDQGFKDQJHHDUOLHU
FRQILJXUDWLRQGHFLVLRQV

7KLVVHFWLRQGLVFXVVHVDPXOWLSOHPDFKLQHLQVWDOODWLRQZLWKORDGEDODQFLQJ,WLVZULWWHQZLWKWKH
DVVXPSWLRQWKDW\RXZLOODFFHSWGHIDXOWFRQILJXUDWLRQVIRU2UDFOH5HJLVWU\RU(QYLURQPHQW9DULDEOHV
DQGIRU)RUPV6HUYHU6WDUWXS3DUDPHWHUV17RQO\,QIRUPDWLRQDERXWUHFRQILJXULQJWKHVH
FRPSRQHQWVLVQRWLQFOXGHGZLWKLQWKHVFRSHRIWKLVSDSHU

1RWH,I\RXDUHXVLQJ:LQGRZV17EHIRUH\RXUXQWKHLQVWDOOHUPDNHVXUH\RXKDYH
DGPLQLVWUDWLYHSULYLOHJHVRQWKH:LQGRZV17ZRUNVWDWLRQZKHUH\RXZLOOLQVWDOOWKHVHUYHU

7RLQVWDOO2UDFOH)RUPV6HUYHULQDPXOWLSOHPDFKLQHFRQILJXUDWLRQZLWKORDGEDODQFLQJ
1. 6KXWGRZQDQ\DFWLYHDSSOLFDWLRQV
2. ,QVHUWWKH2UDFOH)RUPV6HUYHULQVWDOOHU&'
3. 5XQWKH2UDFOHLQVWDOOHU
4. ,QWKH2UDFOH,QVWDOODWLRQ6HWWLQJVGLDORJER[HOHFWDODQJXDJHLQZKLFKWRUXQ2UDFOH)RUPV
6HUYHU
5. ,QWKH2UDFOH,QVWDOODWLRQ6HWWLQJVGLDORJER[HQWHU\RXUFRPSDQ\QDPHWKHQDPHRIDQG
SDWKIRUWKH2UDFOH+RPHGLUHFWRU\DQGWKHODQJXDJHLQZKLFKWRUXQ2UDFOH)RUPV6HUYHU
)RUQDPHDQGORFDWLRQZHVWURQJO\UHFRPPHQGWKDW\RXDFFHSWWKHGHIDXOWV

Reconfiguring Cartridge to CGI 7

November 1999
 6. 7KHLQVWDOOHUSUHVHQWVDVHULHVRIRSWLRQV<RXUVHOHFWLRQVLQIRUPWKHLQVWDOOHUKRZWR
FRQILJXUH\RXUVHUYHU7KHVHDUHGLVFXVVHGLQWKHQH[WVHFWLRQV

1RWH<RX·OOILQGPRUHLQIRUPDWLRQDERXWLQVWDOOLQJ2UDFOH)RUPV6HUYHULQ*HWWLQJ6WDUWHG
LQFOXGHGZLWKWKH2UDFOH)RUPV'HYHORSHULRQOLQHPDQXDOV

INSTALLING FOR WEB CGI IMPLEMENTATION AND LOAD BALANCING

7KLVVHFWLRQSURYLGHVDQH[DPSOHRIWKHFKRLFHV\RXZRXOGPDNHLI\RXZHUHLQVWDOOLQJ2UDFOH)RUPV
6HUYHULQDPXOWLSOHPDFKLQHFRQILJXUDWLRQDQGLQWHQGHGWRLPSOHPHQW:HE&*,DQGORDGEDODQFLQJ

1RWH7KHRSWLRQVSUHVHQWHGLQWKLVVHFWLRQDUHIRUDQ17VHUYHUHQYLURQPHQW)RU81,;WKH
RSWLRQVYDU\VOLJKWO\EXWWKLVLQIRUPDWLRQVKRXOGQRQHWKHOHVVVHH\RXWKURXJK

2SWLRQDQG5HFRPPHQGDWLRQ
:KDWSURGXFWGR\RXZLVKWRLQVWDOO
&KRRVH2UDFOH)RUPV6HUYHU
:KDWW\SHRILQVWDOODWLRQZRXOG\RX
OLNHWRSHUIRUP"
&KRRVH7\SLFDO
:KDWW\SHRIGHSOR\PHQWLQVWDOODWLRQ
GR\RXZDQW"
&KRRVH)RUPV6HUYHUIRU:HE
GHSOR\PHQW
:KDWW\SHRIVHUYHUZLOOWKLVEH"
&KRRVH3DUWRIDPXOWLSOHPDFKLQH
FRQILJXUDWLRQ
'HVFULSWLRQ
7KLVZLOOUHGXFHWKHQXPEHURILQVWDOODWLRQGHFLVLRQV\RXPXVW
PDNHWRWKRVHUHODWHGWR2UDFOH)RUPV6HUYHUDQGLWVVXSSRUWLQJ
FRPSRQHQWV
7KLVZLOOVWDUW\RXGRZQDQDXWRPDWHGSDWKZD\WRLQVWDOOLQJ:HE
GHSOR\PHQWFRPSRQHQWV
,QVWDOOVDQGFRQILJXUHVWKHQHFHVVDU\FRPSRQHQWVWRUXQ2UDFOH
)RUPV'HYHORSHUDSSOLFDWLRQVDV:HEDSSOLFDWLRQVRQRQHRUPRUH
VHUYHUPDFKLQHV
,QVWDOOV2UDFOH)RUPV6HUYHUDVSDUWRIDPXOWLSOHPDFKLQH
FRQILJXUDWLRQ8VHWKLVRSWLRQZKHQ\RXDOVRSODQWRXVHORDG
EDODQFLQJ

:KDWW\SHRIQRGHZLOOWKLVPDFKLQH
EH"
&KRRVH3ULPDU\1RGHZKHQ\RX
DUHLQVWDOOLQJ2UDFOH)RUPV6HUYHU
RQWKHPDFKLQHZKHUH\RXZLOODOVR
LQVWDOOD:HEVHUYHU&KRRVH
6HFRQGDU\1RGHIRUDOORWKHU
LQVWDOODWLRQV
:KHUHVKRXOG2UDFOH)RUPV
DSSOLFDWLRQVUXQ"
&KRRVH2QWKHVHFRQGDU\QRGHV
DQGWKLVSULPDU\QRGH
:KHQWKHUHDUHPXOWLSOHPDFKLQHVRQHPDFKLQHDFWVDVWKH
3ULPDU\1RGH,WPXVWKDYHD:HEOLVWHQHUUXQQLQJRQLW,WZLOO
UHFHLYHDQGSURFHVVDOO85/UHTXHVWVWRH[HFXWHDSSOLFDWLRQV,W
URXWHVHDFKUHTXHVWWRWKHPDFKLQHWKDWZLOODFWXDOO\H[HFXWHWKH
DSSOLFDWLRQ7KLVFRXOGEHD6HFRQGDU\1RGHRUWKH3ULPDU\1RGH
LI)RUPVUXQWLPHVDUHDYDLODEOHRQWKDWPDFKLQH
6HOHFWWKLVRSWLRQWRDOORZ2UDFOH)RUPV'HYHORSHUDSSOLFDWLRQVWR
UXQRQWKLV3ULPDU\1RGH,QWKLVFDVHWKH)RUPV6HUYHUZLOOEH
LQVWDOOHGDQGFRQILJXUHGRQWKLVQRGHDORQJZLWKWKHRWKHU3ULPDU\
1RGHFRPSRQHQWVLQFOXGLQJORDGEDODQFHUFRPSRQHQWVDQG
)RUPV5XQWLPHV
:HE/LVWHQHU <RXQHHGD:HEOLVWHQHU+773GDHPRQWRUXQ2UDFOH)RUPV
&KRRVH(LWKHU:HE'%RUDQRWKHU 'HYHORSHUDSSOLFDWLRQVRQWKH:HE)RU\RXUFRQYHQLHQFHWKH
:HEOLVWHQHUWKDWVXSSRUWV&*, 2UDFOH:HE'%/LVWHQHUDOLJKWZHLJKWOLVWHQHUWKDWVXSSRUWV&*,
LVSURYLGHGZLWK2UDFOH)RUPV'HYHORSHU$OWHUQDWLYHO\\RXPD\

Reconfiguring Cartridge to CGI 8

November 1999
 ZKLFKHYHU\RXSUHIHU XVHDQ\RWKHU:HEOLVWHQHUWKDWVXSSRUWV&*,&RPPRQ*DWHZD\
,QWHUIDFH,I\RXFKRRVHD:HEOLVWHQHURWKHUWKDQ:HE'%DIWHU
\RXLQVWDOO2UDFOH)RUPV6HUYHU\RXZLOOQHHGWRGHILQHVRPH
YLUWXDOSDWKV6HHSDJHIRUPRUHLQIRUPDWLRQ
,I\RXFKRRVH:HE'%/LVWHQHU\RXZLOODOVREHDVNHGWRVSHFLI\
'DWD$FFHVV'HVFULSWRU'$'FRQILJXUDWLRQLQIRUPDWLRQ'$'
LVXVHGWRFDSWXUHGDWDEDVHFRQQHFWLRQLQIRUPDWLRQIRUDQ
DSSOLFDWLRQ

COMPONENT INSTALLATION OPTIONS

6RPH2UDFOH)RUPV6HUYHULQVWDOODWLRQRSWLRQVEUDQFKRIILQWRDGGLWLRQDOFKRLFHV7KLVVHFWLRQ
SURYLGHVGHWDLOVRQFRQILJXULQJWKHVHDGGLWLRQDOFKRLFHVGXULQJLQVWDOODWLRQ

'HSOR\PHQW&RPSRQHQWDQG 5HFRPPHQGHG$FWLRQ
2SWLRQV
)RUPV6HUYHUSDUDPHWHUV 5HFRPPHQGDWLRQ$FFHSWWKHGHIDXOWV
(QWHUSDUDPHWHUYDOXHVIRUWKH)RUPV <RXPD\DFFHSWRUPRGLI\WKHVWDUWXSSDUDPHWHUYDOXHVIRUWKH
6HUYHU )RUPV6HUYHU
2SWLRQV )RUPV6HUYHU3RUW(QWHUWKH7&3,3SRUWQXPEHURQZKLFKWKH
)RUPV6HUYHU3RUW>@ )RUPV6HUYHUZLOOOLVWHQIRUIRUPH[HFXWLRQUHTXHVWV7KH
GLVSOD\HGYDOXHQHHGRQO\EHFKDQJHGLIDQRWKHUSURJUDPDOUHDG\
3URWRFRO XVHVLW
6RFNHWVGHIDXOW 3URWRFRO7KLVVSHFLILHVWKHPHWKRGWREHXVHGWRFRPPXQLFDWH
+773 EHWZHHQWKH)RUPVUXQWLPHHQJLQHDQGWKH)RUPV-DYD$SSOHW
/RDG%DODQFHU6HUYHU3DUDPHWHUV
(QWHUWKHSRUWQXPEHUVWREHXVHGE\
WKH)RUPVORDGEDODQFHUVHUYHU
2SWLRQV GHIDXOWSRUWQXPEHURQO\LIWKHGHIDXOWQXPEHULVDOUHDG\EHLQJ
'DWDSRUW>@
5HTXHVWSRUW>@
ZKLFKUXQVLQWKHXVHU·V:HEEURZVHU&KDQJHWKHYDOXHWR
+773RQO\LIWKHFRPPXQLFDWLRQQHHGVWRSDVVWKURXJKDILUHZDOO
)RUH[DPSOHVHOHFW+773LIWKLVPDFKLQHLVLQVLGHDILUHZDOOEXW
\RXU)RUPVDSSOLFDWLRQVQHHGWREHDYDLODEOHWRXVHUVRXWVLGHWKH
ILUHZDOO
5HFRPPHQGDWLRQ$FFHSWWKHGHIDXOWV
<RXPD\DFFHSWRUPRGLI\WKHVWDUWXSSDUDPHWHUYDOXHVIRUWKH
ORDGEDODQFHUVHUYHU7KHVHDUH7&3,3SRUWQXPEHUV&KDQJHD
XVHGE\DQRWKHUSURJUDP
'DWDSRUW(QWHUWKH7&3,3SRUWQXPEHURQZKLFKWROLVWHQIRU
ORDGGDWDIURPWKHORDGEDODQFHUFOLHQWSURFHVVHVZKLFKUXQRQ
/RDG%DODQFHU&OLHQW3DUDPHWHUV
(QWHUWKHIXOOKRVWQDPHRIWKH
3ULPDU\1RGHDQGWKHGDWDSRUW
QXPEHUIRUWKHORDGEDODQFHUVHUYHU
UXQQLQJRQWKDWQRGH
2SWLRQV 3ULPDU\1RGHWKHPDFKLQHRQZKLFKWKHORDGEDODQFHU6HUYHULV
Reconfiguring Cartridge to CGI
November 1999
6HFRQGDU\1RGHV
5HTXHVWSRUW(QWHUWKH7&3,3SRUWQXPEHURQZKLFKWROLVWHQ
IRUUHTXHVWVIRUWKH´OHDVWORDGHGKRVWµPDGHE\WKH)RUPV:HE
&*,
5HFRPPHQGDWLRQ$FFHSWWKHGHIDXOWV
<RXPD\DFFHSWRUPRGLI\WKHVWDUWXSSDUDPHWHUYDOXHVIRUWKH
ORDGEDODQFHUFOLHQW7KHVHWHOOLWKRZWRFRQQHFWWRWKHORDG
EDODQFHUVHUYHU
'DWDKRVW(QWHUWKHIXOOKRVWQDPHRIWKHPDFKLQHWKDWLVWKH
9
 'DWDKRVW>@ UXQQLQJLQWKLVPXOWLSOHPDFKLQHFRQILJXUDWLRQ
'DWDSRUW>@ 'DWDSRUW(QWHUWKH7&3,3SRUWQXPEHURQZKLFKWKHORDG
EDODQFHUVHUYHULVOLVWHQLQJIRUORDGGDWD

STEP 3: INSTALLING YOUR CGI-CAPABLE WEB SERVER

7KH2UDFOH)RUPV6HUYHULLQVWDOODWLRQSDFNDJHLQFOXGHVWKH2UDFOH:HE'%:HE/LVWHQHU,I\RX
FKRRVH:HE'%IRU:HEVHUYHUVXSSRUWWKH2UDFOH)RUPV6HUYHULQVWDOOHUZLOODXWRPDWLFDOO\
FRQILJXUHLWIRU\RX,I\RXFKRRVHD:HEOLVWHQHURWKHUWKDQ:HE'%\RXPXVWSHUIRUPVRPH
DGGLWLRQDO:HEVHUYHUFRQILJXUDWLRQ6SHFLILFDOO\\RXPXVW

· 6SHFLI\DKRVWQDPH
· 6SHFLI\DSRUWQXPEHU0RVW:HEVHUYHUVXVHSRUW
· &UHDWH YLUWXDO SDWKV WKDW PDS WR WKH SK\VLFDO GLUHFWRULHV OLVWHG LQ WKH IROORZLQJ WDEOH 7KH
2UDFOH)RUPV6HUYHULQVWDOOHUFUHDWHV WKHVH SK\VLFDO GLUHFWRULHV 7KH\ FRQWDLQ ILOHV WKDW DUH
XVHGE\)RUPV

9LUWXDO3DWK 3K\VLFDO'LUHFWRU\ 'HVFULSWLRQ

IRUPVMDYD 1725$&/(B+20(?)RUPV?MDYD )RUPV-DYDILOHV
81,;25$&/(B+20()RUPVMDYD
GHYKWPO 1725$&/(B+20(?7RROV?ZHE?KWPO 6WDUWHU+70/ILOHVIRUUXQQLQJIRUPV
81,;25$&/(B+20(7RROVZHEKWPO
GHYFJL 1725$&/(B+20(?7RROV?ZHE?FJL &*,H[HFXWDEOHV
81,;25$&/(B+20(7RROVZHEFJL
MLQLWLDWRU 1725$&/(B+20(?-LQLW? -,QLWLDWRUIRUGRZQORDG
81,;25$&/(B+20(-LQLWGRF
GHYWHPS 1725$&/(B+20(?7RROV?ZHE?WHPS )RUPVWHPSRUDU\ILOHV
81,;25$&/(B+20(7RROVZHEWHPS

Reconfiguring Cartridge to CGI 10

November 1999
STEP 4: COMPLETING ADDITIONAL CONFIGURATION

6RPHDGGLWLRQDOFRQILJXUDWLRQVWHSVPD\EHUHTXLUHGRQFH\RXILQLVKLQVWDOOLQJ2UDFOH)RUPV6HUYHU
7RKHOS\RXZLWKWKLVWKHLQVWDOOHUJHQHUDWHVWKHGHYLFRQILJW[WILOH7KLVILOHFRQWDLQVGHWDLOVDERXW
WKHDXWRPDWLFFRQILJXUDWLRQSHUIRUPHGE\WKHLQVWDOOHUDQGWKHPDQXDOVWHSV\RXPXVWWDNHWR
FRPSOHWHWKHSURFHVV

<RX·OOILQGWKHGHYLFRQILJW[WILOHLQ25$&/(B+20(?RUDLQVWRU
25$&/(B+20(RUDLQVW2QFH\RXILQLVKLQVWDOOLQJ2UDFOH)RUPV6HUYHUUHDGWKLVILOHDQG
SHUIRUPWKHUHTXHVWHGDFWLRQV

7KHIROORZLQJWH[WLVDQH[DPSOHRIWKHW\SHRILQIRUPDWLRQWKDWDSSHDUVLQWKHGHYLFRQILJW[WILOH
,WHPVPDUNHG>DFWLRQ@DUHPDQXDOVWHSV\RXPXVWWDNHWRFRPSOHWHWKHFRQILJXUDWLRQSURFHVV,WHPV
PDUNHG>LQIR@DUHWKHDXWRPDWLFFRQILJXUDWLRQVWHSVWKDWZHUHFRPSOHWHGE\WKHLQVWDOOHU

This file gives details of the configuration steps done for you by the installation
process, marked [info], and any actions you need to do manually, marked [action].

Oracle WebDB listener message

[action] If you are using the Oracle WebDB listener and if the messages below state that
virtual paths have been created for you, you must restart the listener to have the changes
taken into account (this may be done from the Services tool on the Windows Control Panel).

Virtual path message (webdb)

[info] Virtual path <name> has been created with your WebDb listener, mapping to physical
path <physical_path>.

Virtual path message (not webdb)

[action] Please configure the following virtual path with your web listener: <vpname> for
physical directory <dir>

Service startup message (NT only)

[info] NT service <servicename> has been created and started for the <componentname>

Process startup message (UNIX only)

[action] A command to start the <componentname> has been written to the Oracle Forms
Developer process startup script <scriptfilename>.

Reports Server TNS message

[info]The following TNS name for the Reports Server has been defined in the Net8
<tnsnames.ora> file : <TNSname>

Reports Service message (NT only)

[action] NT service Oracle Reports Server [<servername>] has been created for the Reports
Multitier Server. This must be started under an NT user with access to a printer before
any reports may run on this machine.

Reports CGI message

Reconfiguring Cartridge to CGI 11

November 1999
[action] Oracle Reports Web CGI and cartridge: in order to run reports on other machines,
your must add entries to your Net8 "tnsnames.ora" file to identify the Reports Servers
running on those machines.

Primary node install message

[action] You have requested that this machine be the primary node in a multiple machine
configuration. If you wish to distribute the execution of Oracle Reports reports across
the different machines using Reports Server clustering, you will need to add the
CLUSTERCONFIG parameter to the Reports Server configuration file. Please refer to the
Reports Server documentation for details.

Test form message

[info] An internet shortcut to run a standard test form, or any form of your choice, has
been created for you in the Oracle Forms Developer program group.

Test report message

[info] An internet shortcut to run a standard test report, or any report of your choice,
has been created for you in the Oracle Reports Developer program group.

STEP 5: CONFIGURING THE FORMSWEB.CFG FILE

7KHIRUPVZHEFIJILOHLVDSRZHUIXOQHZFRQYHQLHQFHLQFOXGHGZLWK2UDFOH)RUPV6HUYHUL8VHLW
DVDUHSRVLWRU\IRUDOOWKHVHWWLQJV\RXQHHGWRUXQ2UDFOHIRUPVRQWKH:HELQD&*,
LPSOHPHQWDWLRQ7KHLQVWDOOHUSODFHVWKLVILOHLQ25$&/(B+20(?)2506?VHUYHURU
25$&/(B+20()2506VHUYHU

7KLVVHFWLRQ

· 'HVFULEHVWKHSXUSRVHDQGJHQHUDORUJDQL]DWLRQRIWKHIRUPVZHEFIJILOH
· /LVWVDQGGHVFULEHVRSWLRQDODQGPDQGDWRU\SDUDPHWHUVLQWKHIRUPVZHEFIJILOH
· 3URYLGHVDQH[DPSOHRIDGHIDXOWIRUPVZHEFIJILOH
· 'LVFXVVHVFDVHVHQVLWLYLW\LVVXHVLQWKHIRUPVZHEFIJILOH

UNDERSTANDING THE FORMSWEB.CFG FILE

7KHIRUPVZHEFIJILOHLVDWH[WILOHWKDWFRQWDLQVFRQILJXUDWLRQSDUDPHWHUVIRUUXQQLQJ)RUPV
DSSOLFDWLRQVRQWKH:HELQD&*,LPSOHPHQWDWLRQ7KHFRQILJXUDWLRQSDUDPHWHUVLQWKH
IRUPVZHEFIJILOHDUHWKH&*,HTXLYDOHQWRIWKHFDUWULGJHSDUDPHWHUVXVHGZLWKWKH)RUPVFDUWULGJH
7KHIRUPVZHEFIJILOHLVGLYLGHGLQWRWKUHHPDLQVHFWLRQV

· 6\VWHP3DUDPHWHUV
· 8VHU3DUDPHWHUV
· 6SHFLILF&RQILJXUDWLRQV

Reconfiguring Cartridge to CGI 12

November 1999
System Parameters

7KH6\VWHP3DUDPHWHUVVHFWLRQSURYLGHVLQIRUPDWLRQUHTXLUHGE\WKH)RUPV:HE&*,8QOLNHPDQ\
RWKHUSDUDPHWHUVLQIRUPVZHEFIJ6\VWHP3DUDPHWHUVFDQQRWEHVSHFLILHGLQD85/TXHU\VWULQJ
+RZHYHU\RXFDQRYHUULGHWKHLUYDOXHVE\SODFLQJDQDOWHUQDWHSDUDPHWHUYDOXHVHWLQD6SHFLILF
&RQILJXUDWLRQVHFWLRQLQIRUPVZHEFIJWKHQFDOOLQJWKDWFRQILJXUDWLRQLQWKHDSSOLFDWLRQ85/

User Parameters

7KH8VHU3DUDPHWHUVVHFWLRQLVZKHUH\RXVSHFLI\WKHDFWXDOYDOXHVIRUSDUDPHWHUVWKDWDUHGHILQHG
ZLWKYDULDEOHVLQWKHEDVH+70/ILOH)RUH[DPSOHLQWKHEDVHKWPILOH\RXPLJKWKDYH

3$5$01$0( ´VHSDUDWH)UDPHµ9$/8( ´VHSDUDWH)UDPHµ!

,QWKHIRUPVZHEFIJ\RXZRXOGVHWWKHVSHFLILFYDOXHIRUWKHYDULDEOHVHSDUDWH)UDPH

VHSDUDWH)UDPH IDOVH

<RXFDQRYHUULGHVSHFLILHG8VHU3DUDPHWHUYDOXHVLQD6SHFLILF&RQILJXUDWLRQVHFWLRQLQ
IRUPVZHEFIJRULQDTXHU\VWULQJLQWKHDSSOLFDWLRQ·V85/)RUH[DPSOH

17KWWSVHUYHUQDPHP\GRPDLQQDPHFRPGHYFJLLIFJLH[H"VHSDUDWH)UDPH WUXH
81,;KWWSVHUYHUQDPHP\GRPDLQQDPHFRPGHYFJLIFJL"VHSDUDWH)UDPH WUXH

,QWKHVHH[DPSOHVWKHTXHU\VWULQJ"VHSDUDWH)UDPH WUXHZLOORYHUULGHWKHYDOXHIRUVHSDUDWH)UDPH
WKDWLVVSHFLILHGLQWKHIRUPVZHEFIJILOH

1RWH:KHQDVSHFLILFYDOXHIRUDSDUDPHWHULVGHILQHGLQERWKWKHIRUPVZHEFIJILOHDQGWKH
DSSOLFDWLRQ·V85/WKHYDOXHGHILQHGLQWKH85/LVXVHG

Specific Configurations

,I\RXZDQWWRUXQWKHVDPHIRUPZLWKPXOWLSOHFRQILJXUDWLRQV\RXFDQGHILQHFXVWRP
FRQILJXUDWLRQVZLWKFXVWRPYDOXHVLQWKH6SHFLILF&RQILJXUDWLRQVVHFWLRQRIWKHIRUPVZHEFIJILOH
:KHQ\RXFDOOWKHFXVWRPFRQILJXUDWLRQZLWKDTXHU\VWULQJLQWKHDSSOLFDWLRQ·V85/WKHFXVWRP
YDOXHVZLOORYHUULGHWKHSDUDPHWHUVGHILQHGLQWKH8VHU3DUDPHWHUVVHFWLRQRIIRUPVZHEFIJ:KHQ
\RXVHWXSD6SHFLILF&RQILJXUDWLRQVVHFWLRQ\RXQHHGRQO\VSHFLI\WKHSDUDPHWHUV\RXZDQWWR
FKDQJH7KHGHIDXOWYDOXHVWKDWDUHVSHFLILHGLQWKH8VHU3DUDPHWHUVVHFWLRQZLOOEHXVHGIRUDOORWKHU
SDUDPHWHUV

Reconfiguring Cartridge to CGI 13

November 1999
8VHWKH´FRQILJµSDUDPHWHULQWKHDSSOLFDWLRQ·V85/WRFDOODSDUWLFXODU6SHFLILF&RQILJXUDWLRQ
VHFWLRQ)RUH[DPSOHWKHIROORZLQJ85/VFDOOWKH6SHFLILF&RQILJXUDWLRQVHFWLRQ>P\FRQILJ@

17KWWSVHUYHUQDPHP\GRPDLQQDPHFRPGHYFJLLIFJLH[H"FRQILJ P\FRQILJ
81,;KWWSVHUYHUQDPHP\GRPDLQQDPHFRPGHYFJLIFJL"FRQILJ P\FRQILJ

FORMSWEB.CFG PARAMETERS

0RVWRIWKHSDUDPHWHUVLQWKHIRUPVZHEFIJILOHDUHVHWDXWRPDWLFDOO\DV\RXVHOHFWFRQILJXUDWLRQ
RSWLRQVGXULQJ2UDFOH)RUPV6HUYHULLQVWDOODWLRQ7KLVVHFWLRQSURYLGHVLQIRUPDWLRQRQWKH
SDUDPHWHUVLQWKHIRUPVZHEFIJILOHLQWKHHYHQWWKDW\RXZLVKWRPDQXDOO\DGMXVWFRQILJXUDWLRQ
RSWLRQV

IRUPVZHEFIJ 5HTXLUHPHQW 'HILQLWLRQ

3DUDPHWHU
EDVH+70/ 5HTXLUHG 8VHWKLVSDUDPHWHUWRVSHFLI\WKHSK\VLFDOSDWKWRWKH+70/
ILOHWKDWFRQWDLQV)RUPVDSSOHWWDJV,WDOORZVWKH)RUPVDSSOHW
WRUXQXQGHUD:HEEURZVHU·VQDWLYH-DYD9LUWXDO0DFKLQH
EDVH+70/-,QLWLDWRU
Reconfiguring Cartridge to CGI
November 1999
-90DQGLVVXLWDEOHIRUXVHZLWKWKH$SSOHW9LHZHU
2SWLRQDO 8VHWKLVSDUDPHWHUWRVSHFLI\WKHSK\VLFDOSDWKWRWKHEDVH
+70/ILOHWREHXVHGLIWKHXVHU·VEURZVHULVUXQQLQJRQ
:LQGRZVDQGUHTXLUHV2UDFOH-,QLWLDWRUWRUXQWKH)RUPV
DSSOHW,WVKRXOGUHIHUHQFHDILOHWKDWFRQWDLQVWDJVZLWKDV\QWD[
WKDWLVDSSURSULDWHWR-,QLWLDWRU
:KHQDYDOXHLVQRWVSHFLILHGIRUWKHEDVH+70/-,QLWLDWRU
SDUDPHWHUWKHEDVH+70/SDUDPHWHUDQGYDOXHDUHXVHG
14
LH 2SWLRQDO 7KLVSDUDPHWHULVSURYLGHGIRUXVHLQFRQMXQFWLRQZLWKWKH
EDVH+70/-,QLWLDWRUSDUDPHWHU,WVHWVXSFRQGLWLRQDOXVHRI
HLWKHU-,QLWLDWRURUWKHQDWLYH-90ZLWKLQWKH,QWHUQHW([SORUHU
EURZVHU
3HUPLWWHGYDOXHVDUH
· -,QLWLDWRUZKLFKPHDQVWKHILOHUHIHUHQFHGLQWKH
EDVH+70/-,QLWLDWRUSDUDPHWHUZLOOEHXVHG
· 1DWLYHZKLFKPHDQVWKH)RUPVDSSOHWZLOOUXQQDWLYHO\

XQGHU,(ZLWKRXWWKHKHOSRI-,QLWLDWRU7KHDGYDQWDJHRI
UXQQLQJQDWLYHLQDQ,(EURZVHULVWKHHOLPLQDWLRQRI
-,QLWLDWRUGRZQORDGWLPH
+70/GHOLPLWHU 2SWLRQDO 8VHWKLVSDUDPHWHUWRGHILQHWKHGHOLPLWHUWKDWLVXVHGWR
LQGLFDWHYDULDEOHVLQWKHEDVHKWPDQGEDVHMLQLKWP
FRQILJXUDWLRQILOHV7KHGHIDXOWLV)RUH[DPSOH\RXFDQ
LQGLFDWHWKHYDULDEOHYDOXHIRUFRQQHFW0RGHZLWKFRQ
QHFW0RGH7KHQ\RXFDQGHILQHWKHYDOXHIRUWKH
FRQQHFW0RGHYDULDEOHLQWKHIRUPVZHEFIJILOHRUYLDD
TXHU\VWULQJLQWKHDSSOLFDWLRQ·V85/
0HWULFV6HUYHU+RVW 2SWLRQDO 7KLVSDUDPHWHULVRSWLRQDOIRU)RUPV&*,HYHQZKHQ\RXXVH
ORDGEDODQFLQJ,ILWLVQRWVXSSOLHGWKHORDGEDODQFHUVHUYHU
PXVWEHUXQQLQJRQWKHORFDOPDFKLQH³WKHVDPHPDFKLQHDV
WKH:HEOLVWHQHUDQGWKH)RUPV&*,LIFJLH[HRQ17IFJL
RQ81,;
0HWULFV6HUYHU3RUW 'HSHQGV 7KLVSDUDPHWHULVUHTXLUHGIRUORDGEDODQFLQJRWKHUZLVHLWLV
RSWLRQDO8VHLWWRVSHFLI\WKHSRUWIRUFRQWDFWLQJWKHORDG
EDODQFHUVHUYHU,WPXVWPDWFKWKH5HTXHVW3RUWYDOXHWKDW\RX
VSHFLI\GXULQJLQVWDOODWLRQVHHSDJH
0HWULFV6HUYHU(UURU85/ 2SWLRQDO 7KLVSDUDPHWHULVRSWLRQDOIRUWKH)RUPV&*,HYHQZKHQ\RX
XVHORDGEDODQFLQJ8VHLWWRVSHFLI\WKH:HESDJHWKDWZLOOEH
GLVSOD\HGLIQRYDOLGOHDVWORDGHGKRVWFDQEHIRXQG,ILWLV
QRWVSHFLILHGRULILWVYDOXHLVHPSW\WKH)RUPV&*,ZLOO
DXWRPDWLFDOO\JHQHUDWHDQHUURUSDJHZLWKDQDSSURSULDWH
PHVVDJH
0HWULFV7LPHRXW 2SWLRQDO ,WLVXVHGIRUORDGEDODQFLQJ8VHLWWRVSHFLI\WKHWLPHWRZDLW
IRUDQDQVZHUIURPWKHORDGEDODQFHUVHUYHUZKHQJHWWLQJWKH
OHDVWORDGHGKRVW7KHGHIDXOWYDOXHLVVHFRQGV
OHDVWORDGHGKRVW 'HSHQGV 7KLVSDUDPHWHULVUHTXLUHGIRUORDGEDODQFLQJRWKHUZLVHLWLV
RSWLRQDO7KLVLVDYDULDEOHWKDWFDQEHVSHFLILHGLQHLWKHUWKH
EDVH+70/ILOHRUWKHIRUPVZHEFIJILOHZKHUHYHUWKHQDPH
RIWKHOHDVWORDGHGPDFKLQHLVUHTXLUHGIRUORDGEDODQFLQJ,I
\RXXVHWKHGHIDXOWEDVH+70/ILOHZKLFKZHUHFRPPHQG
WKHQZKHQHYHU\RXZLOOXVHORDGEDODQFLQJEHVXUHWRVSHFLI\
WKHVHUYHU+RVWSDUDPHWHULQWKHIRUPVZHEFIJILOHLQWKH
IROORZLQJZD\VHUYHU+RVW OHDVWORDGHGKRVW

Reconfiguring Cartridge to CGI 15

November 1999
6WDQGDUG+70/$SSOHW3DUDPHWHUV
7KHIROORZLQJSDUDPHWHUVDUHVWDQGDUG+70/DSSOHWSDUDPHWHUV7KRVHWKDWFRQWURODVSHFWVRIGLVSOD\VXFK
DVDOLJQDQGYDOLJQDUHQRWXVHGZKHQWKHDSSOHWLVGLVSOD\HGLQDVHSDUDWHEURZVHUZLQGRZLH
VHSDUDWH)UDPH WUXH:KHQWKHDSSOHWLVGLVSOD\HGLQDVHSDUDWHEURZVHUZLQGRZGHIDXOWYDOXHVFRQWUROWKH
GLVSOD\
,QWKHEDVH+70/ILOH\RXFDQGHILQHDSDUDPHWHUZLWKHLWKHUDYDOXHRUDYDULDEOH,I\RXVSHFLI\DYDULDEOH
UHFRPPHQGHGSXWWKHDFWXDOYDOXHLQWKHIRUPVZHEFIJILOHRUVSHFLI\DYDOXHYLDDTXHU\VWULQJLQWKH
DSSOLFDWLRQ·V85/)RUH[DPSOHLQWKHEDVH+70/ILOH\RXFDQVSHFLI\
3$5$01$0( ´ZLGWKµ9$/8( ´ZLGWKµ!
7KHQ\RXFDQGHILQHWKHYDOXHIRUZLGWKLQWKHIRUPVZHEFIJILOHRULQDTXHU\VWULQJLQWKHDSSOLFDWLRQ·V85/
)RUH[DPSOH
IRUPVZHEFIJILOHZLGWK 
$SSOLFDWLRQ85/17KWWSVHUYHUQDPHP\GRPDLQFRPGHYFJLLIFJLH[H"ZLGWK 
$SSOLFDWLRQ85/81,;KWWSVHUYHUQDPHP\GRPDLQFRPGHYFJLIFJL"ZLGWK 
7KHV\QWD[IRUSDUDPHWHUVYDULHVVOLJKWO\EHWZHHQWKHEDVHKWPDQGEDVHMLQLKWPILOHV6HHSDJHVDQGIRU
H[DPSOHVRISDUDPHWHUXVHLQWKHVHILOHV

FRGHEDVH 5HTXLUHG 8VHWKLVSDUDPHWHUWROLVWWKHYLUWXDOGLUHFWRU\\RXGHILQHGLQ

\RXU:HEVHUYHUWRSRLQWWRWKHSK\VLFDOGLUHFWRU\ZKHUH-DYD
ILOHVDUHVWRUHG6HHSDJH$Q\SDWKVJLYHQLQWKHDUFKLYHDQG
FRGHSDUDPHWHUVDUHUHODWLYHWRWKLVGLUHFWRU\85/$OWKRXJK
LW·VSRVVLEOHWRLQFOXGHWKLVSDUDPHWHUDQGYDOXHLQDTXHU\
VWULQJLQWKHDSSOLFDWLRQ·V85/ZHDGYLVHWKDW\RXGRQRW
FRGH 5HTXLUHG 7KLVSDUDPHWHUKDVDIL[HGYDOXH,WVYDOXHVKRXOGDOZD\VEH
RUDFOHIRUPVHQJLQH0DLQ$OWKRXJKLW·VSRVVLEOHWRLQFOXGHWKLV
SDUDPHWHUDQGYDOXHLQDTXHU\VWULQJLQWKHDSSOLFDWLRQ·V85/
ZHDGYLVHWKDW\RXGRQRW
DUFKLYH 2SWLRQDO 8VHWKLVSDUDPHWHUWRVSHFLI\DFRPPDVHSDUDWHGOLVWRIDUFKLYH
-$5ILOHVWRSUHORDG3DWKVDUHUHODWLYHWRWKHYDOXHGHILQHGLQ
FRGHEDVHRUWKH\DUHDEVROXWHSDWKV$OWKRXJKLW·VSRVVLEOHWR
LQFOXGHWKLVSDUDPHWHUDQGYDOXHLQDTXHU\VWULQJLQWKH
DSSOLFDWLRQ·V85/ZHDGYLVHWKDW\RXGRQRW
ZLGWK 5HTXLUHG 8VHWKLVSDUDPHWHUWRVSHFLI\WKHZLGWKRIWKHIRUP([SUHVV
WKHYDOXHLQSL[HOV
KHLJKW 5HTXLUHG 8VHWKLVSDUDPHWHUWRVSHFLI\WKHKHLJKWRIWKHIRUP([SUHVV
WKHYDOXHLQSL[HOV
DOLJQ 2SWLRQDO 8VHWKLVSDUDPHWHUWRVSHFLI\WKHKRUL]RQWDOSRVLWLRQRIWKH
IRUPVDSSOHWZLQGRZUHODWLYHWRFRPSXWHUVFUHHQGLVSOD\
$FFHSWHGYDOXHVDUHOHIWULJKWFHQWHU
YDOLJQ 2SWLRQDO 8VHWKLVSDUDPHWHUWRVSHFLI\WKHYHUWLFDOSRVLWLRQRIWKHIRUPV
DSSOHWZLQGRZUHODWLYHWRFRPSXWHUVFUHHQGLVSOD\$FFHSWHG
YDOXHVDUHWRSPLGGOHERWWRP
DOW 2SWLRQDO 8VHWKLVSDUDPHWHUWRGHILQHWKHPHVVDJHWH[WWKDWGLVSOD\VLQ
OLHXRIWKHDSSOHWZKHQDSSOHWVDUHQRWVXSSRUWHGLQWKHFOLHQW
EURZVHU

Reconfiguring Cartridge to CGI 16

November 1999
KVSDFH 2SWLRQDO 8VHWKLVSDUDPHWHUWRVHWWKHKRUL]RQWDOJXWWHUEHWZHHQWKH
DSSOHWDQGWKHDSSOHWZLQGRZIUDPH9DOXHVDUHPHDVXUHGLQ
SL[HOV%\GHIDXOWKVSDFHLVDVPDOOQRQ]HURQXPEHU
YVSDFH 2SWLRQDO 8VHWKLVSDUDPHWHUWRVHWWKHYHUWLFDOJXWWHUEHWZHHQWKHDSSOHW
DQGWKHDSSOHWZLQGRZIUDPH9DOXHVDUHPHDVXUHGLQSL[HOV
%\GHIDXOWYVSDFHLVDVPDOOQRQ]HURQXPEHU
W\SH 'HSHQGV 7KLVSDUDPHWHULVPDQGDWRU\IRU-,QLWLDWRU,WVIL[HGYDOXHLV
DSSOLFDWLRQ[MLQLWDSSOHW
1RYDOXHLVUHTXLUHGIRU$SSOHW9LHZHU
QDPH 2SWLRQDO 8VHWKLVSDUDPHWHUWROLVWWKH$SSOHWLQVWDQFHQDPH
WLWOH 2SWLRQDO 8VHWKLVSDUDPHWHUWROLVWWKHDGYLVRU\WLWOHVWULQJ
ERUGHU 2SWLRQDO 8VHWKLVSDUDPHWHUWRVSHFLI\WKHZLGWKRIWKHRXWHUERUGHU
DURXQGWKHDSSOHWWRDJLYHQQXPEHURISL[HOVHJERUGHU 
7RVXSSUHVVWKHERUGHUVHWLWVYDOXHWR]HURRURPLWWKH
SDUDPHWHU
VWDQGE\ 2SWLRQDO 8VHWKLVSDUDPHWHUWRGHILQHWKHPHVVDJHWH[WWKDWGLVSOD\V
ZKHQWKHDSSOHWLVORDGLQJ
FRGHW\SH 2SWLRQDO 7KLVSDUDPHWHUGHIDXOWVWRWKHYDOXHVSHFLILHGIRUW\SH
)RUPV$SSOHW3DUDPHWHUV
7KHIROORZLQJSDUDPHWHUVDUHVSHFLILFWRWKH)RUPVDSSOHW7KLVPHDQVWKH\DUHVSHFLILFWR2UDFOHUDWKHUWKDQ
VWDQGDUGWR+70/6SHFLI\YDOXHVLQWKHEDVH+70/ILOHRUVSHFLI\DYDULDEOHLQWKHEDVH+70/ILOHWKHQ
SXWWKHDFWXDOYDOXHLQWKHIRUPVZHEFIJILOHRULQFOXGHLWDVDTXHU\VWULQJLQWKHDSSOLFDWLRQ·V85/)RU
H[DPSOHLQWKHEDVH+70/ILOH\RXFDQVSHFLI\
3$5$01$0( ´FRQQHFW0RGHµ9DOXH ´FRQQHFW0RGHµ!
7KHQ\RXFDQGHILQHWKHYDOXHIRUFRQQHFW0RGHLQWKHIRUPVZHEFIJILOHRULQFOXGHLWDVDTXHU\VWULQJLQWKH
DSSOLFDWLRQ·V85/)RUH[DPSOH
IRUPVZHEFIJILOHFRQQHFW0RGH KWWSV
$SSOLFDWLRQ85/17KWWSVHUYHUQDPHP\GRPDLQFRPGHYFJLLIFJLH[H"FRQQHFW0RGH KWWSV
$SSOLFDWLRQ85/81,;KWWSVHUYHUQDPHP\GRPDLQFRPGHYFJLIFJL"FRQQHFW0RGH KWWSV
7KHV\QWD[IRUSDUDPHWHUVYDULHVVOLJKWO\EHWZHHQWKHEDVHKWPDQGEDVHMLQLKWPILOHV6HHSDJHVDQGIRU
H[DPSOHVRISDUDPHWHUXVHLQWKHVHILOHV
VHUYHU+RVW 'HSHQGV 7KLVSDUDPHWHULVPDQGDWRU\ZKHQ\RXLPSOHPHQWORDG
EDODQFLQJRWKHUZLVHLWLVRSWLRQDO
:LWKORDGEDODQFLQJVSHFLI\WKLVSDUDPHWHUYDOXHDVIROORZVLQ
WKHIRUPVZHEFIJILOH
VHUYHU+RVW OHDVWORDGHGKRVW
7KLVSDUDPHWHUVSHFLILHVWKHKRVWIRUWKH)RUPVVHUYHU
LIVUYH[HRQ17IVUYPRQ81,;,QWKHSUHVHQFHRI
ORDGEDODQFLQJLWDOZD\VVHOHFWVWKHOHDVWORDGHGKRVW,QWKH
DEVHQFHRIORDGEDODQFLQJLWGHIDXOWVWRWKHPDFKLQHWKDWKRVWV
WKH:HEVHUYHU
VHUYHU3RUW 5HTXLUHG 8VHWKLVSDUDPHWHUWRVSHFLI\WKHSRUWRQZKLFKWKH)RUPV
VHUYHULIVUYH[HRQ17IVUYPRQ81,;OLVWHQV,QPRVW
FDVHVWKHYDOXHZLOOEHZKLFKLVDOVRWKHGHIDXOW

Reconfiguring Cartridge to CGI 17

November 1999
VHUYHU$UJV 5HTXLUHG 8VHWKLVSDUDPHWHUWRVSHFLI\WKHFRPPDQGOLQHSDUDPHWHUVIRU
5XQIRUPVHHPRGXOHXVHULGDQGXVHUGHILQHGSDUDPHWHUV
EHORZ
KHDUW%HDW 2SWLRQDO 8VHWKLVSDUDPHWHUWRVHWWKHIUHTXHQF\DWZKLFKDFOLHQWVHQGV
DSDFNHWWRWKHVHUYHUWRLQGLFDWHWKDWLWLVVWLOOUXQQLQJ'HILQH
WKLVYDOXHLQPLQXWHV7KHGHIDXOWLVWZRPLQXWHV
LPDJH%DVH 2SWLRQDO 8VHWKLVSDUDPHWHUWRLQGLFDWHZKHUHLFRQILOHVDUHVWRUHG
&KRRVHEHWZHHQ
· FRGH%DVHLQGLFDWHVWKDWWKHLFRQVHDUFKSDWKLVUHODWLYHWRWKH
GLUHFWRU\WKDWFRQWDLQVWKH-DYDFODVVHV8VHWKLVYDOXHLI\RX
VWRUH\RXULFRQVLQD-$5ILOHUHFRPPHQGHG
· GRFXPHQW%DVHLVWKHGHIDXOW,QGHSOR\PHQWVWKDWPDNHXVH

RIWKH)RUPV6HUYHU&*,\RXPXVWVSHFLI\WKHLFRQSDWKLQ
DFXVWRPDSSOLFDWLRQILOH5HIHUWR)RUPV6HUYHU
GRFXPHQWDWLRQIRUIXUWKHULQIRUPDWLRQ
UHJLVWU\3DWK 2SWLRQDO 8VHWKLVSDUDPHWHUWROLVWWKHYLUWXDOGLUHFWRU\ZKHUHWKH
DSSOLFDWLRQILOHQDPHGLQWKHVHUYHU$SSSDUDPHWHULVORFDWHG
)RULQIRUPDWLRQRQUHOHYDQWYLUWXDOGLUHFWRULHVVHHSDJH
ZHEIRUPV7LWOH 2SWLRQDO 8VHWKLVSDUDPHWHUWRFKDQJHWKHWLWOHWKDWDSSHDUVLQWKHWRS
ERUGHURIDIRUP·VGLVSOD\ZLQGRZ
VSODVK6FUHHQ 2SWLRQDO 8VHWKLVSDUDPHWHUWRVSHFLI\WKH*,)RU-3*ILOHWKDWZLOO
DSSHDUEHIRUHWKHDSSOHWDSSHDUV6HWWKHYDOXHWR´QRµIRUQR
VSODVKVFUHHQ/HDYHLWHPSW\WRXVHWKHGHIDXOWVSODVKVFUHHQ
VXSSOLHGE\2UDFOH
EDFNJURXQG 2SWLRQDO 8VHWKLVSDUDPHWHUWRVSHFLI\WKH*,)RU-3*ILOHWKDWVKRXOG
DSSHDULQWKHEDFNJURXQG6HWWKHYDOXHWR´QRµIRUQR
EDFNJURXQGLPDJH/HDYHLWHPSW\WRXVHWKHGHIDXOW
EDFNJURXQGLPDJHWKDWLVVXSSOLHGE\2UDFOH
FRQQHFW0RGH 'HSHQGV 7KLVSDUDPHWHULVPDQGDWRU\IRU+773DQG+7736
FRQQHFWLRQV,WLVRSWLRQDOIRUVRFNHWFRQQHFWLRQV8VHLWWRWHOO
WKHFOLHQWZKLFKW\SHRIFRQQHFWLRQSURWRFROWRXVHZLWKWKH
)RUPV6HUYHU&KRRVHIURPVRFNHWKWWSKWWSV7KHGHIDXOWLV
VRFNHW
FOLHQW'3, 2SWLRQDO 8VHWKLVSDUDPHWHUWRPDQDJHYDU\LQJGRWVSHULQFK'3,
VHWWLQJVSHUSODWIRUP)RUH[DPSOHDIRUPGHYHORSHGRQWKH
:LQSODWIRUPPD\QRWGLVSOD\SURSHUO\RQWKH81,;
SODWIRUPGXHWRYDU\LQJ'3,YDOXHV7KHFOLHQW'3,YDOXHFDQ
EHDQ\SRVLWLYHLQWHJHU:HUHFRPPHQGWKDW\RXXVHDQLQWHJHU
EHWZHHQDQG
7KLVSDUDPHWHU·VYDOXHRYHUULGHVWKHYDOXHGHILQHGLQWKH-90
VHSDUDWH)UDPH 2SWLRQDO 8VHWKLVSDUDPHWHUWRVSHFLI\ZKHWKHUWKHDSSOHWRSHQVLQWKH
SULPDU\IDOVHRUDVHFRQGDU\WUXHEURZVHUZLQGRZ,I\RX
FKRRVHWRRSHQWKHDSSOHWLQDVHFRQGDU\EURZVHUZLQGRZDQ\
FXVWRPL]HGQRQGHIDXOWDSSHDUDQFHSDUDPHWHUV\RXGHILQHLQ
IRUPVZHEFIJRUDEDVH+70/ILOHZLOOEHLJQRUHG'HIDXOW
SDUDPHWHUVZLOOFRQWUROWKHORRNRIWKHVHFRQGDU\ZLQGRZ

Reconfiguring Cartridge to CGI 18

November 1999
ORRN$QG)HHO 2SWLRQDO 8VHWKLVSDUDPHWHUWRGHILQHWKHDSSOLFDWLRQ·VORRNDQGIHHO
9DOLGYDOXHVDUH2UDFOHRU*HQHULF*HQHULFLQYRNHVD
:LQGRZVORRNDQGIHHO
FRORU6FKHPH 2SWLRQDO 8VHWKLVSDUDPHWHUWRGHILQHWKHDSSOLFDWLRQ·VFRORUVFKHPH
9DOLGYDOXHVDUH7HDO7LWDQLXP5HG.KDNL%OXH2OLYHRU
3XUSOH7KHFRORU6FKHPHSDUDPHWHULVLJQRUHGLIORRN$QG)HHO
LVVHWWR*HQHULF
VHUYHU$SS 2SWLRQDO 8VHWKLVSDUDPHWHUWRVSHFLI\WKHQDPHRI\RXUDSSOLFDWLRQ
FODVVLIDQ\$SSOLFDWLRQFODVVHVDUHXVHGIRUFUHDWLQJ
DSSOLFDWLRQVSHFLILFIRQWPDSSLQJDQGLFRQSDWKVHWWLQJV
PRGXOH 5HTXLUHG 7KLVSDUDPHWHULVDVXESDUDPHWHURIWKHVHUYHU$UJVSDUDPHWHU
8VHLWWRVSHFLI\WKHIRUPPRGXOHQDPHDQGLIQHFHVVDU\WKH
PRGXOH·VSDWK,WLVH[SUHVVHGDV
3$5$01$0( ´VHUYHU$UJVµ
9$/8( ´PRGXOH RUGHUIP[µ!
XVHULG 2SWLRQDO 7KLVSDUDPHWHULVDVXESDUDPHWHURIWKHVHUYHU$UJVSDUDPHWHU
8VHLWWRVSHFLI\DXVHUORJLQVWULQJVXFKDV
VFRWWWLJHU#25$,WLVH[SUHVVHGDV
3$5$01$0( ´VHUYHU$UJVµ
9$/8( ´XVHULG VFRWWWLJHU#25$µ!
XVHUGHILQHGSDUDPHWHUV 2SWLRQDO 8VHWKHVHSDUDPHWHUVWRVSHFLI\XVHUGHILQHGQDPHYDOXHSDLUV
)RUH[DPSOH3$5$01$0( ´QDPHµ9$/8( ´YDOXHµ!

DEFAULT FORMSWEB.CFG FILE

7KLVVHFWLRQSURYLGHVDQH[DPSOHRIWKHIRUPVZHEFIJILOH7KHYDOXHVWKDWDSSHDULQ\RXUYHUVLRQRI
WKLVILOHZLOOYDU\DFFRUGLQJWRWKHFKRLFHV\RXPDNHZKHQ\RXLQVWDOO2UDFOH)RUPV6HUYHU$VSDUW
RILWVLQVWDOODWLRQ2UDFOH)RPUV6HUYHUDXWRPDWLFDOO\JHQHUDWHVWKHIRUPVZHEFIJILOHDQGSODFHVLWLQ
25$&/(B+20(?)2506?VHUYHURU25$&/(B+20()2506VHUYHU

; Forms Web CGI Configuration File

; This file defines parameter values used by the Forms Web CGI
; ********************************
; PARAMETER VALUES USED BY DEFAULT
; ********************************

; SYSTEM PARAMETERS
; -----------------
; These have fixed names and give information required by the Forms
; Web CGI in order to function. They cannot be specified in the URL
; query string. But they can be overridden in a named configuration
; (see below).
baseHTML=%ORACLE_HOME%\FORMS60\server\base.htm
baseHTMLJInitiator=%ORACLE_HOME%\FORMS60\server\basejini.htm
HTMLdelimiter=%
MetricsServerPort=9020
MetricsServerErrorURL=
; The next parameter specifies how to execute the Forms applet under
; Microsoft Internet Explorer 5.0. Put IE50=native if you want the
; Forms applet to run in the browser’s native JVM.
IE50=JInitiator

Reconfiguring Cartridge to CGI 19

November 1999
 ; USER PARAMETERS
; ---------------
; These match variables (e.g. %form%) in the baseHTML file. Their
; values may be overridden by specifying them in the URL query string
; (e.g."http://myhost.mydomain.com/ifcgi60.exe?form=myform&width=700")
; or by overriding them in a specific, named configuration (see below)

; 1) Runform arguments:
form=test.fmx
userid=
otherparams=

; 2) HTML page title, attributes for the BODY tag, and HTML to add
; before and after the form:
pageTitle=Oracle Forms Server
HTMLbodyAttrs=
HTMLbeforeForm=
HTMLafterForm=

; 3) Values for the Forms applet parameters:

width=650
height=500
separateFrame=false
splashScreen=no
background=no
lookAndFeel=Oracle
colorScheme=teal
serverApp=default
serverPort=9000
serverHost=
connectMode=socket
archive=f60web.jar

; 4) Parameters for JInitiator

; Page displayed to Netscape users to allow them to download
; JInitiator. If you create your own version, set this parameter to
; point to it.
jinit_download_page=/jinitiator/us/jinit_download.htm
; Parameters related to the version of JInitiator.
; These are valid for Oracle JInitiator version 1.1.7.21o
; WARNING: You must update these if you upgrade to a later version
; of JInitiator (as instructed in the documentation for that
; version)
jinit_classid=clsid:b8b42d42-6bba-11d3-a3c3-00c04fa32518
jinit_exename=jinit.exe#Version=1.1.7.21
jinit_mimetype=application/x-jinit-applet;version=1.1.7.21

; ********************************
; SPECIFIC CONFIGURATIONS
; ********************************
; You may define your own specific, named configurations (sets of
; parameters) by adding special sections as illustrated in the following
; examples. Note that you need only specify the parameters you want to
; change. The default values (defined above) will be used for all other
; parameters. Use of a specific configuration can be requested by
; including the text "config=<your_config_name>" in the query string of
; the URL used to run a form. For example, to use the sepwin
; configuration, your could issue a URL like
; "http://myhost.mydomain.com/ifcgi60.exe?config=sepwin".

; Example 1: configuration to run forms in a separate browser window

; with "generic" look and feel (include "config=sepwin" in the URL)
[sepwin]
separateWindow=True
lookandfeel=Generic

; Example 2: configuration affecting users of MicroSoft Internet

; Explorer 5.0. Forms applet will run under the browser’s native JVM
; rather than using Oracle JInitiator.
[ie50native]
IE50=native

Reconfiguring Cartridge to CGI 20

November 1999
; Example 3: configuration forcing use of the base.htm base HTML file in
; all cases (means applet-style tags will always be generated and
; JInitiator will never be used).
[applet]
baseHTMLJInitiator=

CASE SENSITIVITY IN FORMSWEB .CFG

,QWKHSDVWVRPHDSSOLFDWLRQGHSOR\PHQWVKDYHEHHQKLQGHUHGE\WKHLQFRUUHFWXVHRIXSSHUDQG
ORZHUFDVHOHWWHUVLQFRQILJXUDWLRQSDUDPHWHUVDQGILOHQDPHV:KHUHYHUSRVVLEOHZHDUHHOLPLQDWLQJ
FDVHUHTXLUHPHQWV)RUH[DPSOHPRVWSDUDPHWHUVLQWKHIRUPVZHEFIJILOHDUHQRWFDVHVHQVLWLYH
1RQHWKHOHVV\RXPXVWXVHFDXWLRQZKHQVSHFLI\LQJ)RUPVDSSOHWWDJSDUDPHWHUVZKLFKDUHFDVH
VHQVLWLYHZKHWKHULQWKHIRUPVZHEFIJILOHRULQRQHRIWKHEDVH+70/ILOHV$GGLWLRQDOO\WKHFDVH
VHQVLWLYLW\RIGLUHFWRU\DQGILOHQDPHVYDULHVDFFRUGLQJWRWKHUHTXLUHPHQWVRI\RXURSHUDWLQJV\VWHP

)RUWKHWLPHEHLQJDJRRGUXOHRIWKXPELVWRXVHWKHFDVHVIRUSDUDPHWHUQDPHVDQGYDOXHV
SUHVHQWHGLQWKHIROORZLQJVHFWLRQVDQGWRDOZD\VDGKHUHWRWKHUHTXLUHPHQWVRI\RXURSHUDWLQJ
V\VWHPZKHQVSHFLI\LQJWKHFDVHVRIILOHDQGGLUHFWRU\QDPHV

Reconfiguring Cartridge to CGI 21

November 1999
STEP 6: CONFIGURING THE BASE.HTM OR BASEJINI.HTM FILE

:KHQ\RXVWDUWD:HEHQDEOHGDSSOLFDWLRQE\FOLFNLQJDOLQNWRWKHDSSOLFDWLRQ·V85/WKH)RUPV

&*,UHDGVDVSHFLDOILOHWKDWFRQWDLQVDOOQHFHVVDU\DSSOHWWDJVSDUDPHWHUVDQGSDUDPHWHUYDOXHVRU
YDULDEOHVIRUWKRVHYDOXHVWKDWDUHUHTXLUHGWRUXQWKHVHOHFWHGDSSOLFDWLRQRQWKH:HE7KLVLVWKH
EDVH+70/ILOH

7KH2UDFOH)RUPV6HUYHULLQVWDOOHUSODFHVWZREDVH+70/ILOHVLQWKHIROORZLQJGLUHFWRU\
25$&/(B+20(?)2506?VHUYHU17RU25$&/(B+20()2506VHUYHU
81,;

· EDVHMLQLKWP
7KLV ILOH FRQWDLQV WKH WDJV UHTXLUHG WR UXQ WKH )RUPV DSSOHW XVLQJ D FRPELQDWLRQ RI WKH
XVHU·V:HEEURZVHUDQG2UDFOH-,QLWLDWRU
· EDVHKWP
7KLVILOHFRQWDLQVWKHWDJVUHTXLUHGWRUXQWKH)RUPVDSSOHWLQWKH$SSOHW9LHZHURULQDQ\
:HEEURZVHUFHUWLILHGE\2UDFOHZKRVHQDWLYH-90LVFHUWLILHGWRZRUNZLWK)RUPV

,QD)RUPV:HE&*,LPSOHPHQWDWLRQDVWKHDSSOLFDWLRQODXQFKSURFHVVJHWVVWDUWHGDQ\YDULDEOHV
YDULDEOHQDPHLQWKHEDVH+70/ILOHDUHUHSODFHGZLWKWKHDSSURSULDWHSDUDPHWHUYDOXHVWKDWDUH
VSHFLILHGHLWKHULQWKHIRUPVZHEFIJILOHRULQDTXHU\VWULQJLQFOXGHGLQWKHDSSOLFDWLRQ·V85/2QFH
DOOYDOXHVDUHGHILQHGWKH+70/ILOHLVJHQHUDWHGDQGWKHQGRZQORDGHGWRWKHXVHU·V:HEEURZVHU
DQGWKHVHOHFWHGIRUPVDSSOLFDWLRQODXQFKHV

1RWH:KHQDVSHFLILFYDOXHIRUDSDUDPHWHULVGHILQHGLQERWKWKHIRUPVZHEFIJILOHDQGWKH
DSSOLFDWLRQ·V85/WKHYDOXHGHILQHGLQWKH85/LVXVHG

,QPRVWFDVHV\RXZLOOQRWQHHGWRPRGLI\WKHGHIDXOWEDVH+70/ILOHV,QVWHDG\RXFDQGHILQHWKHLU
SDUDPHWHUVZLWKYDULDEOHV7KHQ\RXFDQGHILQHWKHDFWXDOYDOXHVIRUWKHYDULDEOHVLQIRUPVZHEFIJRU
LQWKHDSSOLFDWLRQ·V85/

)RUH[DPSOH\RXFDQGHILQHWKHSDUDPHWHUVSODVK6FUHHQLQWKHEDVH+70/ILOHDV

3$5$01$0( ´VSODVK6FUHHQµ9$/8( ´VSODVK6FUHHQµ!

7KHQGHILQHWKHDFWXDOYDOXHLQWKHIRUPVZHEFIJILOHDV

17VSODVK6FUHHQ GLUHFWRU\SDWK?P\VSODVKVFUHHQJLI
81,;VSODVK6FUHHQ GLUHFWRU\SDWKP\VSODVKVFUHHQJLI

Reconfiguring Cartridge to CGI 22

November 1999
,I\RXSUHIHU\RXFDQGHILQHWKHVSODVK6FUHHQYDULDEOHLQWKHDSSOLFDWLRQ·V85/

17KWWSVHUYHUQDPHP\GRPDLQFRPGHYFJLLIFJLH[H"VSODVK6FUHHQ GLUHFWRU\
SDWKP\VSODVKVFUHHQJLI
81,;KWWSVHUYHUQDPHP\GRPDLQFRPGHYFJLIFJL"VSODVK6FUHHQ GLUHFWRU\
SDWKP\VSODVKVFUHHQJLI

1RWH)RU\RXUVSODVKVFUHHQ\RXFDQXVH\RXURZQJUDSKLFRUWKHGHIDXOWILOHWKDW2UDFOHSURYLGHV

8VLQJYDULDEOHVLQVWHDGRIYDOXHVLQWKHEDVH+70/ILOHDOORZV\RXWRXVHWKHVDPHJHQHULFEDVH
+70/ILOHIRUDOO\RXUIRUPVDSSOLFDWLRQVDQGWRPDQDJHFRQILJXUDWLRQFRPSOH[LW\IURPRQH
ORFDWLRQIRUPVZHEFIJRUWKHDSSOLFDWLRQ·V85/

1RWH,I\RXGHFLGHWRVSHFLI\SDUDPHWHUYDOXHVLQWKHEDVH+70/ILOHGRQRWPRGLI\WKHRULJLQDO
EDVH+70/ILOHWKDWLVSURYLGHGE\2UDFOH,QVWHDGPRGLI\DUHQDPHGFRS\%HVXUHWRXSGDWHWKH
EDVH+70/RUWKHEDVHMLQL+70/SDUDPHWHULQWKHIRUPVZHEFIJILOHWRSRLQWWRWKHORFDWLRQRI
WKHPRGLILHGILOH

DEFAULT BASE.HTM FILE

<HTML>
<!-- FILE: base.htm (Oracle Forms Developer) -->
<!-- This is the default base HTML file for running a form on the -->
<!-- web using APPLET-style tags to include the Forms applet. -->
<!-- This file will be REPLACED if you reinstall "Forms Web CGI and -->
<!-- cartridge", so you are advised to make your own version if you -->
<!-- want to make any modifications. You should then set the -->
<!-- baseHTML parameter in the Forms web CGI configuration file -->
<!-- (formsweb.cfg) to point to your new file instead of this one. -->
<!-- IMPORTANT NOTE: default values for all the variables which -->
<!-- appear below (delimited by the percent character) are defined -->
<!-- in the formsweb.cfg file. It is preferable to make changes in -->
<!-- that file where possible, and leave this one untouched. -->

<HEAD><TITLE>%pageTitle%</TITLE></HEAD>
<BODY %HTMLbodyAttrs%>
%HTMLbeforeForm%
<!-- Forms applet definition (start) -->

<APPLET CODEBASE="/forms60java/"
CODE="oracle.forms.engine.Main"
ARCHIVE="%archive%"
WIDTH="%Width%"
HEIGHT="%Height%">

<PARAM NAME="serverPort" VALUE="%serverPort%">

<PARAM NAME="serverHost" VALUE="%serverHost%">
<PARAM NAME="connectMode" VALUE="%connectMode%">
<PARAM NAME="serverArgs" VALUE="module=%form% userid=%userid% %otherParams%">
<PARAM NAME="separateFrame" VALUE="%separateFrame%">
<PARAM NAME="splashScreen" VALUE="%splashScreen%">
<PARAM NAME="background" VALUE="%background%">
<PARAM NAME="lookAndFeel" VALUE="%lookAndFeel%">
<PARAM NAME="colorScheme" VALUE="%colorScheme%">
<PARAM NAME="serverApp" VALUE="%serverApp%">
</APPLET>

Reconfiguring Cartridge to CGI 23

November 1999
<!-- Forms applet definition (end) -->

%HTMLafterForm%
</BODY>
</HTML>

Usage Notes

· ,I\RXGRQRWXVHDSDUDPHWHUWDJLQWKHGHIDXOWEDVHKWPILOHGHOHWHLWIURPWKHILOH
· $OOYDULDEOHVPXVWUHFHLYHYDOXHVDWUXQWLPHHLWKHUIURPWKHIRUPVZHEFIJILOH RU ZLWKLQ D
TXHU\ VWULQJ LQ WKH DSSOLFDWLRQ·V 85/ ,I D YDULDEOH GRHV QRW UHFHLYH D YDOXH WKH )RUPV
6HUYHUFDQQRWJHQHUDWHDQ+70/ILOHWRSDVVEDFNWRWKHXVHU·V:HEEURZVHU7KLVUHVXOWVLQ
DQHUURUWKDWWDNHV\RXWRD:HESDJHWKDWOLVWVWKHXQGHILQHGSDUDPHWHU

DEFAULT BASEJINI.HTM FILE

<HTML>
<!-- FILE: basejini.htm (Oracle Forms Developer) -->
<!-- This is the default base HTML file for running a form on the -->
<!-- web using JInitiator-style tags to include the Forms applet. -->
<!-- This file will be REPLACED if you reinstall "Forms Web CGI and -->
<!-- cartridge", so you are advised to make your own version if you -->
<!-- want to make any modifications. You should then set the -->
<!-- baseHTML parameter in the Forms web CGI configuration file -->
<!-- (formsweb.cfg) to point to your new file instead of this one. -->
<!-- IMPORTANT NOTE: default values for all the variables which -->
<!-- appear below (delimited by the percent character) are defined -->
<!-- in the formsweb.cfg file. It is preferable to make changes in -->
<!-- that file where possible, and leave this one untouched. -->
<HEAD><TITLE>%pageTitle%</TITLE></HEAD>

<BODY %HTMLbodyAttrs%>
%HTMLbeforeForm%

<!-- Forms applet definition (start) -->

<OBJECT classid="%jinit_classid%"
codebase="/jinitiator/%jinit_exename%"
WIDTH="%Width%"
HEIGHT="%Height%"
HSPACE="0"
VSPACE="0">
<PARAM NAME="TYPE" VALUE="%jinit_mimetype%">
<PARAM NAME="CODEBASE" VALUE="/forms60java/">
<PARAM NAME="CODE" VALUE="oracle.forms.engine.Main" >
<PARAM NAME="ARCHIVE" VALUE="%archive%" >
<PARAM NAME="serverPort" VALUE="%serverPort%">
<PARAM NAME="serverHost" VALUE="%serverHost%">
<PARAM NAME="connectMode" VALUE="%connectMode%">
<PARAM NAME="serverArgs" VALUE="module=%form% userid=%userid% %otherParams%">
<PARAM NAME="separateFrame" VALUE="%separateFrame%">
<PARAM NAME="splashScreen" VALUE="%splashScreen%">
<PARAM NAME="background" VALUE="%background%">
<PARAM NAME="lookAndFeel" VALUE="%lookAndFeel%">
<PARAM NAME="colorScheme" VALUE="%colorScheme%">
<PARAM NAME="serverApp" VALUE="%serverApp%">
<COMMENT>
<EMBED SRC="" PLUGINSPAGE="%jinit_download_page%"
TYPE="%jinit_mimetype%"
java_codebase="/forms60java/"
java_code="oracle.forms.engine.Main"
java_archive="%archive%"
WIDTH="%Width%"

Reconfiguring Cartridge to CGI 24

November 1999
 HEIGHT="%Height%"
HSPACE="0"
VSPACE="0"
serverPort="%serverPort%"
serverHost="%serverHost%"
connectMode="%connectMode%"
serverArgs="module=%form% userid=%userid% %otherparams%"
separateFrame="%separateFrame%"
splashScreen="%splashScreen%"
background="%background%"
lookAndFeel="%lookAndFeel%"
colorScheme="%colorScheme%"
serverApp="%serverApp%"
>
<NOEMBED>
</COMMENT>
</NOEMBED></EMBED>
</OBJECT>
<!-- Forms applet definition (end) -->

%HTMLafterForm%
</BODY>
</HTML>

Usage Notes

· ,I\RXGRQRWXVHDSDUDPHWHUWDJLQWKHEDVHMLQLKWPILOHGHOHWHLWIURPWKHILOH
· $OOYDULDEOHVPXVWUHFHLYHYDOXHVDWUXQWLPHHLWKHUIURPWKHIRUPVZHEFIJILOH RU ZLWKLQ D
TXHU\ VWULQJ LQ WKH DSSOLFDWLRQ·V 85/ ,I D YDULDEOH GRHV QRW UHFHLYH D YDOXH WKH )RUPV
6HUYHUFDQQRWJHQHUDWHDQ+70/ILOHWRSDVVEDFNWRWKHXVHU·V:HEEURZVHU7KLVUHVXOWVLQ
DQHUURUWKDWWDNHV\RXWRD:HESDJHWKDWOLVWVWKHXQGHILQHGSDUDPHWHU
· 7RVWUHDPOLQHSHUIRUPDQFHXVHRQO\RQH :HE VHUYHU DV D VRXUFH IRU -$5 ILOH GRZQORDGV
7KLVZLOOSUHYHQWPXOWLSOHGRZQORDGVRIWKHVDPHILOHVIURPGLIIHUHQWVHUYHUV

STEP 7: BROADCASTING THE APPLICATION’S URL

7REURDGFDVWWKHDSSOLFDWLRQ·V85/VLPSO\QRWLI\\RXULQWHQGHGXVHUV<RXUXVHUVFDQFRQWDFWWKH
85/ZLWKWKHLU-DYDHQDEOHG:HEEURZVHUVDQGUXQWKHFRUUHVSRQGLQJDSSOLFDWLRQ)RUH[DPSOHWR
DQQRXQFHWKHDYDLODELOLW\RILWVQHZ2UGHU7UDFNLQJDSSOLFDWLRQ$%&&RUSPLJKWQRWLI\HPSOR\HHV
YLDHPDLORIWKHIROORZLQJ85/

17KWWSVHUYHUQDPHP\GRPDLQQDPHFRPGHYFJLLIFJLH[H"FRQILJ P\FRQILJ IRUP

WUDFNHUIP[
81,;KWWSVHUYHUQDPHP\GRPDLQQDPHFRPGHYFJLIFJL"FRQILJ P\FRQILJ IRUP
WUDFNHUIP[
$%&·V85/FRQVLVWVRIWKHIROORZLQJFRPSRQHQWV

KWWS &RQQHFWLRQSURWRFRO
VHUYHUQDPH 1DPHRIWKHPDFKLQHWKDWKRVWVWKHDSSOLFDWLRQVHUYHU
P\GRPDLQQDPHFRP 1DPHRIWKHGRPDLQWKDWKRVWVWKHWDUJHWLQIRUPDWLRQ

Reconfiguring Cartridge to CGI 25

November 1999
GHYFJL 7KHYLUWXDOSDWKGHILQHGLQWKH:HEVHUYHUWKDWSRLQWVWR&*,
H[HFXWDEOHVVFULSWV
LIFJLH[H17 )RUPV&*,ZKLFKLVXVHGIRUORDGEDODQFLQJ
IFJL81,;
"FRQILJ P\FRQILJ IRUP WUDFNHUIP[
7KHTXHU\VWULQJWKDWSRLQWVWRDFXVWRPFRQILJXUDWLRQGHILQHGLQWKH
XVHUFUHDWHG´P\FRQILJµVHFWLRQRIWKHIRUPVZHEFIJILOHDQGWRWKH
IRUPPRGXOHWUDFNHUIP[
7KHSDUDPHWHU´IRUPµLVXVHGKHUHEHFDXVH´IRUPµZDVGHILQHGDV
WKHYDULDEOHYDOXHIRU´PRGXOHµLQWKHEDVH+70/ILOH7KDWLV
3$5$01$0( ´VHUYHU$UJVµ9$/8( ´PRGXOH IRUPµ!
7KHV\QWD[LVVOLJKWO\GLIIHUHQWLQWKHEDVH+70/-,QLWLDWRUILOH
VHUYHU$UJV ´PRGXOH IRUPµ

SUMMARY

,QWKLVSDSHUZHKDYHSURYLGHGLQIRUPDWLRQDERXWUHFRQILJXULQJIRUPVFDUWULGJHLPSOHPHQWDWLRQVWR
&*,:H·YHNHSWWRDIDLUO\QDUURZSDWKRIFRQILJXUDWLRQRSWLRQVWRHQVXUHDVPRRWKDQGVXFFHVVIXO
PLJUDWLRQ,QGRLQJVRZH·YHEDUHO\VFUDWFKHGWKHVXUIDFHRIWKHWUHPHQGRXVIOH[LELOLW\DYDLODEOHWR
\RXIRUFRQILJXULQJ\RXUHQYLURQPHQWZKHQ\RXGHSOR\2UDFOH)RUPV'HYHORSHUDSSOLFDWLRQVZLWK
2UDFOH)RUPV6HUYHUDQGRSWLPDOO\WKH:HE'%OLVWHQHULQD&*,LPSOHPHQWDWLRQ

)RUPRUHLQIRUPDWLRQDERXWGHSOR\LQJ:HEDSSOLFDWLRQVZLWK2UDFOH)RUPV6HUYHUVHH2UDFOH)RUPV
'HYHORSHU'HSOR\LQJ)RUPV$SSOLFDWLRQVWRWKH:HEZLWK2UDFOH)RUPV6HUYHULDYDLODEOHLQWKH
GRFXPHQWDWLRQVHWWKDWDFFRPSDQLHV2UDFOH)RUPV'HYHORSHUL2UDFOH)RUPV'HYHORSHU2QOLQH
0DQXDOV<RXFDQSXUFKDVHDSULQWHGHGLWLRQRIWKLVERRNRQWKH:HEDWZZZRUDFOHFRP)ROORZ
WKHOLQNWRWKH2UDFOH6WRUHDQGVHOHFWWKH'RFXPHQWDWLRQOLQNRQWKH7RROVWDE

Reconfiguring Cartridge to CGI 26

November 1999
Oracle Corporation
World Headquarters
500 Oracle Parkway
Redwood Shores, CA 94065
U.S.A.

Worldwide Inquiries:
+1.650.506.7000
Fax +1.650.506.7200
http://www.oracle.com/

Copyright © Oracle Corporation 1999

All Rights Reserved

This document is provided for informational purposes only, and

the information herein is subject to change without notice.
Please report any errors herein to Oracle Corporation. Oracle
Corporation does not provide any warranties covering and
specifically disclaims any liability in connection with this
document.

Oracle is a registered trademark, and Oracle8i, Oracle8, PL/SQL,

and Oracle Expert are trademarks of Oracle Corporation. All
other company and product names mentioned are used for
identification purposes only and may be trademarks of their
respective owners.