Database Access Commands › Navigational DML › KEEP

KEEP

Purpose

Places a shared or exclusive lock on a record occurrence that is current of run unit, record, set, or area.

Syntax

►►─── KEEP ─────┬─────────────┬────── CURRENT ────────────────────────────────►
                └─ EXCLUSIVE ─┘

 ►────┬─ record-name ──────┬──────┬────────────────────┬─────── . ────────────►◄
      ├─ WITHIN set-name  ─┤      └─ error-expression ─┘
      └─ WITHIN area-name ─┘

Parameters

EXCLUSIVE

Places an exclusive lock on the object record. If EXCLUSIVE is not specified, the object record receives a shared lock.

CURRENT

Places a lock on the current record of run unit.

record-name

Places the record lock on the current record of the named record type.

WITHIN set-name

Places the record lock on the current record of the named set.

WITHIN area-name

Places the record lock on the current record of the named area.

error-expression

Specifies the status codes that are returned to the dialog.

Usage

Definition

Record locks set with the KEEP command are maintained only for the duration of the run unit or until explicitly released by means of a COMMIT command. The COMMIT command is described earlier in this section.

Considerations

If autostatus is not in use, a dialog's error-status field indicates the outcome of a KEEP command:

More information:

Error Handling