4 Built-ins, Packages, Constants, and Syntax

In order to streamline the tools available and simplify the development process for building Forms applications for the Web, Built-ins, constants, packages, and some syntax that are not applicable to Web deployment have been removed.

This chapter contains the following:

Chapter4, "Obsolete Menu Built-ins"
Chapter4, "Other Obsolete Built-ins"
Chapter4, "Obsolete Built-in Packages"
Chapter4, "Obsolete Constants"
Chapter4, "Obsolete Syntax"

Obsolete Menu Built-ins

Menus associated with full-screen display and character mode have been removed. Code that contains these Built-ins will not compile and should be recoded, although exceptions are mentioned in the following table. Built-ins that are equivalent to obsolete Built-ins are also noted in the table.

Table 4-1 Obsolete Menu Built-ins

Obsolete Menu Built-in	Migration Notes
Application_Menu	No migration path or replacement functionality.
Application_Parameter	No migration path or replacement functionality. See Chapter 12, "Menu Parameters".
Background_Menu<n>	No migration path or replacement functionality.
Debug_Mode	No migration path or replacement functionality. Code containing this Built-in will compile but will not provide functionality.
Disable_Item	Use SET_MENU_ITEM_PROPERTY().
Enable_Item	Use SET_MENU_ITEM_PROPERTY().
Exit_Menu	No migration path or replacement functionality.
Hide_Menu	No migration path or replacement functionality.
Item_Enabled	Use GET_MENU_ITEM_PROPERTY(<name>, ENABLED). Item_Enabled will work in Oracle Forms, but will be removed in a future release.
Main_Menu	No migration path or replacement functionality.
Menu_Clear_Field	Use CLEAR_ITEM.
Menu_Failure	Use FORM_FAILURE flag.
Menu_Help	No migration path or replacement functionality.
Menu_Message	Use MESSAGE.
Menu_Next_Field	Use NEXT_ITEM.
Menu_Parameter	No migration path or replacement functionality. See Chapter 12, "Menu Parameters".
Menu_Previous_Field	Use PREVIOUS_ITEM.
Menu_Redisplay	No migration path or replacement functionality.
Menu_Show_Keys	Use SHOW_KEYS. The upgrade process will make this change automatically.
Menu_Success	Use FORM_SUCCESS flag.
New_Application	No migration path or replacement functionality.
New_User	Use LOGOUT and LOGON.
Next_Menu_Item	No migration path or replacement functionality.
OS_Command	Use HOST.
OS_Command1	Use HOST.
Previous_Menu	No migration path or replacement functionality.
Previous_Menu_Item	No migration path or replacement functionality.
Query_Parameter	No migration path or replacement functionality. See Chapter 12, "Menu Parameters".
Set_Input_Focus	No migration path or replacement functionality.
Show_Background_Menu	No migration path or replacement functionality.
Show_Menu	No migration path or replacement functionality.
Terminate	No migration path or replacement functionality. See Chapter 12, "Menu Parameters".
Where_Display	No migration path or replacement functionality.

Other Obsolete Built-ins

The following Built-ins have been removed. Code that contains these Built-ins will not compile and should be recoded, although exceptions are mentioned in the following table. Built-ins that are equivalent to the obsolete Built-ins are also noted in the table.

Table 4-2 Other Obsolete Built-ins

Obsolete Built-in	Migration Notes
BLOCK_MENU	No migration path or replacement functionality.
BREAK	Migrate to DEBUG.SUSPEND.
CALL	Use CALL_FORM.
CHANGE_ALERT_MESSAGE	Use SET_ALERT_PROPERTY(..., ALERT_MESSAGE_TEXT,...);
DISPATCH_EVENT	Applied only to OLE and OCX items. Therefore, no migration path or replacement functionality.
(FORMS_OLE.) ACTIVATE_SERVER (FORMS_OLE.)CLOSE_SERVER (FORMS_OLE.)EXEC_VERB (FORMS_OLE.)FIND_OLE_VERB (FORMS_OLE.)GET_INTERFACE_POINTER (FORMS_OLE.)GET_VERB_COUNT (FORMS_OLE.)GET_VERB_NAME (FORMS_OLE.)INITIALIZE_CONTAINER (FORMS_OLE.)SERVER_ACTIVE	No migration path or replacement functionality.
MACRO	No migration path or replacement functionality.
OHOST	Use HOST.
PLAY_SOUND	No migration path or replacement functionality.
READ_SOUND_FILE	No migration path or replacement functionality.
ROLLBACK_FORM	CLEAR_FORM(NO_COMMIT,FULL_ROLLBACK)
ROLLBACK_NR	CLEAR_FORM(NO_COMMIT,FULL_ROLLBACK)
ROLLBACK_RL	CLEAR_FORM(NO_COMMIT,FULL_ROLLBACK)
ROLLBACK_SV	CLEAR_FORM(NO_COMMIT,FULL_ROLLBACK)
RUN_PRODUCT	Valid only for integration with Oracle Graphics. Use RUN_REPORT_OBJECT for integration with Oracle Reports. For all other uses, code will compile but will generate run-time errors.
VBX.FIRE_EVENT VBX.GET_PROPERTY VBX.GET_VALUE_PROPERTY VBX.INVOKE_METHOD VBX.SET_PROPERTY VBX.SET_VALUE_PROPERTY	No migration path or replacement functionality.
WRITE_SOUND_FILE	No migration path or replacement functionality.

Obsolete Built-in Packages

The following Built-in packages have been removed. Code that contains these packages will not compile and should be recoded, although exceptions are mentioned in the following table. Packages that are equivalent to the obsolete packages are also noted in the table.

Table 4-3 Obsolete Built-in Packages

Obsolete Package	Migration Notes
DEBUG	No migration path or replacement functionality because there is a new debugger. DEBUG.ATTACH and DEBUG.SUSPEND are still supported.
PECS	No migration path. Use Forms Trace and Oracle Trace, which are documented in the book Oracle Application Server Forms Services Deployment Guide (Part No. B14032-01).

Obsolete Constants

The following constants used in the GET_ITEM_PROPERTY and SET_ITEM_PROPERTY Built-ins have been removed. Code that contains these constants will not compile and should be recoded, although exceptions are mentioned in the following table.

Table 4-4 Obsolete Constants

Obsolete Constant	Migration Notes
DATE_FORMAT_COMPATIBILITY mode	Used by GET_APPLICATION and SET_APPLICATION properties. This constant is ignored.
COMPRESSION_OFF COMPRESSION_ON HIGHEST_SOUND_QUALITY HIGH_SOUND_QUALITY LOW_SOUND_QUALITY LOWEST_SOUND_QUALITY MEDIUM_SOUND_QUALITY MONOPHONIC ORIGINAL_QUALITY ORIGINAL_SETTING	No migration path or replacement functionality.
POPUPMENU_CUT_ITEM POPUPMENU_COPY_ITEM POPUPMENU_DELOBJ_ITEM POPUPMENU_INSOBJ_ITEM POPUPMENU_LINKS_ITEM POPUPMENU_OBJECT_ITEM POPUPMENU_PASTE_ITEM POPUPMENU_PASTESPEC_ITEM SHOW_FAST_FORWARD_BUTTON SHOW_PLAY_BUTTON SHOW_POPUPMENU	No migration path or replacement functionality.
SHOW_RECORD_BUTTON SHOW_REWIND_BUTTON SHOW_SLIDER SHOW_TIME_INDICATOR SHOW_VOLUME_CONTROL STEREOPHONIC	No migration path or replacement functionality.

Obsolete Syntax

Using the ampersand (&) as a functional equivalent to NAME_IN() is now obsolete.