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:

4.1 Obsolete Menu Built-ins

Menus associated with full-screen display and character mode have been removed. Code that contains these built-ins are not compiled 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 Upgrade Notes

Application_Menu

No upgrade path or replacement functionality.

Application_Parameter

No upgrade path or replacement functionality. See Chapter 12, "Menu Parameters".

Background_Menu<n>

No upgrade path or replacement functionality.

Debug_Mode

No upgrade path or replacement functionality. Code containing this Built-in compiles but does not provide functionality.

Disable_Item

Use SET_MENU_ITEM_PROPERTY().

Enable_Item

Use SET_MENU_ITEM_PROPERTY().

Exit_Menu

No upgrade path or replacement functionality.

Hide_Menu

No upgrade path or replacement functionality.

Item_Enabled

Use GET_MENU_ITEM_PROPERTY(<name>, ENABLED). Item_Enabled works in Oracle Forms, but will be removed in a future release.

Main_Menu

No upgrade path or replacement functionality.

Menu_Clear_Field

Use CLEAR_ITEM.

Menu_Failure

Use FORM_FAILURE flag.

Menu_Help

No upgrade path or replacement functionality.

Menu_Message

Use MESSAGE.

Menu_Next_Field

Use NEXT_ITEM.

Menu_Parameter

No upgrade path or replacement functionality. See Chapter 12, "Menu Parameters".

Menu_Previous_Field

Use PREVIOUS_ITEM.

Menu_Redisplay

No upgrade path or replacement functionality.

Menu_Show_Keys

Use SHOW_KEYS. The upgrade process makes this change automatically.

Menu_Success

Use FORM_SUCCESS flag.

New_Application

No upgrade path or replacement functionality.

New_User

Use LOGOUT and LOGON.

Next_Menu_Item

No upgrade path or replacement functionality.

OS_Command

Use HOST.

OS_Command1

Use HOST.

Previous_Menu

No upgrade path or replacement functionality.

Previous_Menu_Item

No upgrade path or replacement functionality.

Query_Parameter

No upgrade path or replacement functionality. See Chapter 12, "Menu Parameters".

Set_Input_Focus

No upgrade path or replacement functionality.

Show_Background_Menu

No upgrade path or replacement functionality.

Show_Menu

No upgrade path or replacement functionality.

Terminate

No upgrade path or replacement functionality. See Chapter 12, "Menu Parameters".

Where_Display

No upgrade path or replacement functionality.


4.2 Other Obsolete Built-ins

The following Built-ins have been removed. Code that contains these Built-ins does 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 Upgrade Notes

BLOCK_MENU

No upgrade path or replacement functionality.

BREAK

Upgrade 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 upgrade 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 upgrade path or replacement functionality.

MACRO

No upgrade path or replacement functionality.

OHOST

Use HOST.

PLAY_SOUND

No upgrade path or replacement functionality.

READ_SOUND_FILE

No upgrade 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 compiles but generates run-time errors.

UPDATE_CHART

No upgrade path or replacement functionality.

VBX.FIRE_EVENT

VBX.GET_PROPERTY

VBX.GET_VALUE_PROPERTY

VBX.INVOKE_METHOD

VBX.SET_PROPERTY

VBX.SET_VALUE_PROPERTY

No upgrade path or replacement functionality.

WRITE_SOUND_FILE

No upgrade path or replacement functionality.


4.3 Obsolete Built-in Packages

The following Built-in packages have been removed. Code that contains these packages does 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 Upgrade Notes

DEBUG

No upgrade path or replacement functionality because there is a new debugger. DEBUG.ATTACH and DEBUG.SUSPEND are still supported.

PECS

No upgrade path. Use Forms Trace and Oracle Trace, which are documented in the book Oracle Fusion Middleware Forms Services Deployment Guide (Part No. E10240-02).


4.4 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 does not compile and should be recoded, although exceptions are mentioned in the following table.

Table 4-4 Obsolete Constants

Obsolete Constant Upgrade 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 upgrade 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 upgrade path or replacement functionality.

SHOW_RECORD_BUTTON

SHOW_REWIND_BUTTON

SHOW_SLIDER

SHOW_TIME_INDICATOR

SHOW_VOLUME_CONTROL

STEREOPHONIC

No upgrade path or replacement functionality.


4.5 Obsolete Syntax

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