Oracle Forms Developer – Form Builder Reference, Volume 1

CREATE_PARAMETER_LIST built-in
Description
Creates a parameter list with the given name. The parameter list has no parameters when it is created;
they must be added using the ADD_PARAMETER built-in subprogram. A parameter list can be passed
as an argument to the CALL_FORM, NEW_FORM, OPEN_FORM, and RUN_PRODUCT built-in
subprograms.
Syntax
FUNCTION CREATE_PARAMETER_LIST
(name VARCHAR2);
Built-in Type unrestricted function
Returns ParamList
Enter Query Mode yes
Parameters
name Specifies the VARCHAR2 name of the parameter list object.
CREATE_PARAMETER_LIST restrictions
When Form Builder creates the object, it assigns it a unique ID of type
PARAMLIST. You can call the parameter list by name or by ID in later
calls to parameter list-related built-in subprograms.
• You cannot create a parameter list named DEFAULT. DEFAULT is reserved for the parameter list
that Form Builder creates at the initiation of a runtime session.
• You cannot create a parameter list if one already exists; to do so will cause an error. To avoid this
error, use ID_NULL to check to see if a parameter list already exists before creating one. If a
parameter list already exists, delete it before creating a new list.
CREATE_PARAMETER_LIST examples
/*
** Built-in: CREATE_PARAMETER_LIST
** Example: Create a parameter list named ’TEMPDATA’. First
** make sure the list does not already exist, then
** attempt to create a new list. Signal an error
** if the list already exists or if creating the
** list fails.
*/
DECLARE
pl_id ParamList;
pl_name VARCHAR2(10) := ’tempdata’;
BEGIN
pl_id := Get_Parameter_List(pl_name);
IF Id_Null(pl_id) THEN
pl_id := Create_Parameter_List(pl_name);
IF Id_Null(pl_id) THEN
Message(’Error creating parameter list ’||pl_name);
61