Oracle Forms Developer – Form Builder Reference, Volume 1

348
SYNCHRONOUS specifies that control returns to Form Builder only after
the called product has been exited. The end user cannot work in the form
while the called product is running.
ASYNCHRONOUS specifies that control returns to the calling application
immediately, even if the called application has not completed its display.
execmode Specifies the execution mode to be used when running the called product.
Valid numeric constants for this parameter are BATCH and RUNTIME.
When you run Report Builder and Graphics Builder, execmode can be
either BATCH or RUNTIME. When you run Form Builder, always set
execmode to RUNTIME.
locatioSpecifies the location of the module or module you want the called product to execute, either the
file system or the database. Valid constants for this property are
FILESYSTEM and DB.
Paramlist_name or paramlist_ID Specifies the parameter list to be passed to the called product. Valid
values for this parameter are the VARCHAR2 name of the parameter list,
the ID of the parameter list, or a null string (’’). To specify a parameter list
ID, use a variable of type PARAMLIST.
You can pass text parameters to called products in both SYNCHRONOUS
and ASYNCHRONOUS mode. However, parameter lists that contain
parameters of type DATA_PARAMETER (pointers to record groups) can
only be passed to Report Builder and Graphics Builder in
SYNCHRONOUS mode. (SYNCHRONOUS mode is required when
invoking Graphics Builder to return an Graphics Builder display that will
be displayed in a form chart item.)
Note: You can prevent Graphics Builder from logging on by passing a
parameter list that includes a parameter with key set to LOGON and value
set to NO.
Note: You cannot pass a DATA_PARAMETER to a child query in Report
Builder. Data passing is supported only for master queries.
display Specifies the VARCHAR2 name of the Form Builder chart item that will
contain the display (such as a pie chart, bar chart, or graph) generated by
Graphics Builder. The name of the chart item must be specified in the
format block_name.item_name. (This parameter is only required when you
are using an Graphics Builder chart item in a form.)
RUN_PRODUCT examples
/*
** Built-in: RUN_PRODUCT
** Example: Call a Report Builder report, passing the
** data in record group ’EMP_RECS’ to substitute
** for the report’s query named ’EMP_QUERY’.
** Presumes the Emp_Recs record group already
** exists and has the same column/data type
** structure as the report’s Emp_Query query.
*/
PROCEDURE Run_Emp_Report IS
pl_id ParamList;
BEGIN
/*
** Check to see if the ’tmpdata’ parameter list exists.