Oracle Forms Developer – Form Builder Reference, Volume 1

SERVER_ACTIVE built-in
Description
Indicates whether or not the server associated with a given container is running: Returns TRUE if the
OLE server is running, FALSE if the OLE server is not running. You must define an appropriately typed
variable to accept the return value.
Syntax
FUNCTION SERVER_ACTIVE
(item_id Item);
FUNCTION SERVER_ACTIVE
(item_name VARCHAR2);
Returns BOOLEAN
Built-in Type unrestricted function
Enter Query Mode no
Parameters
item_id Specifies the unique ID that Form Builder assigns to the item when created.
Use the FIND_ITEM built-in to return the ID to an appropriately typed
variable. The data type of the ID is Item.
item_name Specifies the name of the object created at design time. The data type of
the name is VARCHAR2 string.
SERVER_ACTIVE restrictions
Valid only on Microsoft Windows and Macintosh.
SERVER_ACTIVE examples
/*
** Built-in: SERVER_ACTIVE
** Example: Checks to see if the OLE server is active.
** trigger: When-Button-Pressed
*/
DECLARE
item_id ITEM;
item_name VARCHAR(25) := ’OLEITM’;
active_serv BOOLEAN;
BEGIN
item_id := Find_Item(item_name);
IF Id_Null(item_id) THEN
message(’No such item: ’||item_name);
ELSE
active_serv := Forms_OLE.Server_Active(item_id);
IF active_serv = FALSE THEN
Forms_OLE.Activate_Server(item_id);
END IF;
END IF;
END;
357