Poor memory or poor documentation?

Question

This might be no more than a failure of my memory, but I can't figure out what the up statement in the following does:
     IF :System.Record_Status = 'NEW' THEN
          vRecNum := :System.Cursor_Record;
               up;
     END IF;
I can't seem to find any documentation of this as a valid PL/SQL statement, but it obviously is-this compiles without error (although the form as a whole generates an error, possibly caused by whatever this statement does).
thanks.

Answer 1

:System.Record_Status and :System.Cursor_RecordThese are Oracle Forms internal system variables. A search of the Forms Help system would have given you all the information you need about these variables. For example; Start the Forms Help system, Click on the Index tab and type "System" in the search field...
SYSTEM.RECORD_STATUS System Variable
Syntax
SYSTEM.RECORD_STATUS
Description
SYSTEM.RECORD_STATUS represents the status of the record where the cursor is located. The value can be one of four character strings:
CHANGED - Indicates that a queried record's validation status is Changed.
INSERT - Indicates that the record's validation status is Changed and that the record does not exist in the database.
NEW - Indicates that the record's validation status is New.
QUERY - Indicates that the record's validation status is Valid and that it was retrieved from the database.
Usage Notes
Both SYSTEM.RECORD_STATUS and the GET_RECORD_PROPERTY built-in return the status of a record in a given block, and in most cases, they return the same status. However, there are specific cases in which the results may differ.
SYSTEM.RECORD_STATUS can in certain cases return a value of NULL, because SYSTEM.RECORD_STATUS is undefined when there is no current record in the system. For example, in a When-Clear-Block trigger, Oracle Forms is at the block level in its processing sequence, so there is no current record to report on, and the value of SYSTEM.RECORD_STATUS is NULL.
GET_RECORD_PROPERTY, on the other hand, always has a value of NEW, CHANGED, QUERY, or INSERT, because it returns the status of a specific record without regard to the processing sequence or whether the record is the current record.
SYSTEM.RECORD_STATUS Examples
Assume that you want to create a trigger that performs a commit before clearing a Changed record. The following Key-CLRREC trigger performs this function.
IF :System.Record_Status IN ('CHANGED', 'INSERT') THEN
   Commi t_Form;
END IF;
Clear_Record;Related topics
GET_RECORD_PROPERTY built-in
SET_RECORD_PROPERTY built-in
SYSTEM.BLOCK_STATUS examples
Craig B-)
If someone's response is helpful or correct, please mark it accordingly.
Edited by: CraigB on Jan 7, 2011 2:24 PM