CurrentRecord (RecordsetCursor function)

<section begin=dpl_desc/><section end=dpl_desc/>

CurrentRecord is a member of the RecordsetCursor class.

This method returns a record object representing the current record in the set, or it cancels the request if there is no current record.

Syntax

%rec = %rscursor:CurrentRecord( [lockstr] - [, LoopLockStrength=lockstr] )

Syntax terms

%rec	A declared Record object variable for the assignment of the current record in %rscursor's record set. The variable must have the same file or group context as %rscursor.
%rscursor	An instantiated RecordsetCursor object.
lockstr	The value of a Lockstrength enumeration: None, Share, or Exclusive. These correspond to standard Model 204 record-locking levels, as described below. The default lock strength is Share, matching the locking behavior of a User Language For Record Number statement. None Record is not locked. No locks are held on the object, so there is no conflict with others holding Share or Exclusive locks (readers and updaters may proceed). Share Record is share locked. This level allows other users to hold a Share lock, but not an Exclusive lock (allows readers but not updaters to proceed). Exclusive Record is exclusively locked. This level prohibits others from holding either an Exclusive lock or a Share lock. It is generally used for update.
LoopLockStrength	The lock strength to be used for For Record loops on the Record object. This is an optional, name required, parameter, and it defaults to None. Its possible values are described above.

Usage Notes

• CurrentRecord is valid only if cursor state is HasRecord.
• The default lock strength of the new record object is Share.
• For more information about enumerations, see Enumerations.