Oracle Forms Developer – Form Builder Reference, Volume 1

RUN_PRODUCT built-in
Description
Invokes one of the supported Oracle tools products and specifies the name of the module or module to be
run. If the called product is unavailable at the time of the call, Form Builder returns a message to the end
user.
If you create a parameter list and then reference it in the call to RUN_PRODUCT, the form can pass text
and data parameters to the called product that represent values for command line parameters, bind or
lexical references, and named queries. Parameters of type DATA_PARAMETER are pointers to record
groups in Form Builder. You can pass DATA_PARAMETERs to Report Builder and Graphics Builder,
but not to Form Builder.
To run a report from within a form, you can alternatively use the dedicated report integration built-in
RUN_REPORT_OBJECT .
Syntax
PROCEDURE RUN_PRODUCT
(product NUMBER,
module VARCHAR2,
commmode NUMBER,
execmode NUMBER,
location NUMBER,
paramlist_id VARCHAR2,
display VARCHAR2);
PROCEDURE RUN_PRODUCT
(product NUMBER,
module VARCHAR2,
commmode NUMBER,
execmode NUMBER,
location NUMBER,
paramlist_name VARCHAR2,
display VARCHAR2);
Built-in Type unrestricted procedure
Enter Query Mode yes
Parameters
product Specifies a numeric constant for the Oracle product you want to invoke:
FORMS specifies a Runform session. GRAPHICS specifies Graphics
Builder. REPORTS specifies Report Builder. BOOK specifies Oracle
Book.
module Specifies the VARCHAR2 name of the module or module to be executed
by the called product. Valid values are the name of a form module, report,
Graphics Builder display, or Oracle Book module. The application looks
for the module or module in the default paths defined for the called
product.
commmode Specifies the communication mode to be used when running the called
product. Valid numeric constants for this parameter are SYNCHRONOUS
and ASYNCHRONOUS.
347