Fonction SAP ARCHIVE_GET_TABLE - Read Records by Structure from the Current Data Object

Paramètre Reférence Type Long. Valeur par déf. Facultatif Description
ALL_RECORDS_OF_OBJECT 0 SPACE X Read All Records of the Structure in the Data Object
ARCHIVE_HANDLE SYST-TABIX I 4 Handle to the Open Archive Files
ARCHIVING_CLASS ARCH_CLAS_ C 10 SPACE X Archiving Class
AUTOMATIC_CONVERSION 0 'X' X Automatic Conversion of all Data Records
RECORD_STRUCTURE ARC_BUFFER-RNAME C 30 Name of Structure of All Data Records in the Table

Paramètre Reférence Type Long. Description
RECORD_CURSOR SYST-TABIX I 4 Pointer to a Data Record in the Data Object
RECORD_FLAGS ARCH_FLAGS u 8 Flag Bar for All Data Records in the Table
RECORD_LENGTH ARCH_INT-INT4 I 4 Length of the Data Record in the Table

Paramètre Reférence Long. Facultatif Description
RECORD_FLAGS_TABLE ARCH_FLAGS 8 X Flag Bar for All Data Records in the Table
TABLE 0 Table Containing the Data Records

Exception Description
END_OF_OBJECT No Further Data Record Exists
INTERNAL_ERROR Internal Error
WRONG_ACCESS_TO_ARCHIVE Incorrect Access to the Archive

Functions
This function module reads several data records for the structureRECORD_STRUCTURE from the current data object and imports theinternal table that is specified in the parameter.
This function module can also be used together with logical databases.To do this, ensure that the parameter is ALL_RECORDS_OF_OBJECT= ' '.
This function module is one of the general functions in the ADKinterface. This means that is can be called from programs within anarchiving object or from an archiving class. If the function module isused in a read, delete, reload or conversion progam, it reads recordsthat were archived using object-specific functions in the ADK interface(such as ARCHIVE_PUT_RECORD). The call from an archiving class mustoccur within the subroutine _put_data. Here, the records fromthe current class are read. (handle-specific, depending on the dataobject in question).
INCLUDE 'ARCHIVE_PARAM_ALL_RECORDS' OBJECT DOKU ID TX

Examples
A comprehensive example is contained in the programs SBOOKR_3 andRSARCH11 (read programs for an archiving object) and in the subroutineBC_DEMO_PUT_DATA (archiving class BC_DEMO in function group DEMOCLASS).

Description
The documentation of the parameter ALL_RECORDS_OF_OBJECT showshow the parameter RECORDS_OF_CURSOR is returned depending onthe setting of the parameter ALL_RECORDS_OF_OBJECT.
INCLUDE 'ARCHIVE_PARAM_FLAGS_GET' OBJECT DOKU ID TX
As EXPORT parameter for the function module ARCHIVE_GET_TABLE, theindicators are returned for the last record that was transferred to thetable TABLE; in other words, the last line of the tableRECORD_FLAGS_TABLE.

Description
The parameter RECORD_LENGTH provides the length of the datarecords passed on in Table TABLE.

Description
INCLUDE 'ARCHIVE_PARAM_ALL_RECORDS' OBJECT DOKU ID TX

Default
ALL_RECORDS_OF_OBJECT = ' '
INCLUDE 'ARCHIVE_PARAM_HANDLE' OBJECT DOKU ID TX
INCLUDE 'ARCHIVE_PARAM_AUTOMATIC_CONV' OBJECT DOKU ID TX

Description
Table with indicator bars for all data records that are returned inTABLE.
Record TABLE[i] has the indicator bar RECORD_FLAGS_TABLE[i]. Forinformation on using the indicators, refer to the parameterRECORD_FLAGS.

Description
The data records are returned in this table.