Fonction SAP ARCHIVE_SET_RECORD_CURSOR - Place Cursor on a Specific Data Record

Paramètre Reférence Type Long. Valeur par déf. Facultatif Description
ARCHIVE_HANDLE SYST-TABIX I 4 Handle to the Open Archive Files
RECORD_CURSOR SYST-TABIX I 4 Pointer to Data Record

Exception Description
INTERNAL_ERROR Internal Error
WRONG_ACCESS_TO_ARCHIVE Incorrect Access to the Archive
WRONG_CURSOR Incorrect Value in Cursor

Functions
This function module allows you to change the record cursor of a dataobject. You can position the cursor on a particular record in the dataobject and read the object sequentially from this record using thefunction module ARCHIVE_GET_NEXT_RECORD, for example.
DATA: HANDLE LIKE SY-TABIX,
CURSOR LIKE SY-TABIX.
...
CALL FUNCTION 'ARCHIVE_SET_RECORD_CURSOR'
EXPORTING
ARCHIVE_HANDLE = HANDLE
RECORD_CURSOR = CURSOR
EXCEPTIONS
INTERNAL_ERROR = 01
WRONG_ACCESS_TO_ARCHIVE = 02
WRONG_CURSOR = 03.

Notes
If you need to start to read the data object again sequentially from aparticular point in the middle, you can use this function module.
However, if you only want to read a specific data record, you shoulduse the function module ARCHIVE_GET_WITH_CURSOR.
INCLUDE 'ARCHIVE_PARAM_CURSOR' OBJECT DOKU ID TX
In this case you use the cursor to determine which data record of thearchiving object should be the current data record at the nextsequential access.