SAP Function STATUS_ARCHIVE_GET_TABLE - Read Status Object from Archive (A.Class STATUS)

Parameter Reference Type Length Default Optional Text
ARCHIVE_HANDLE SYST-TABIX I 4 Archive Handle
RECORD_STRUCTURE ARC_BUFFER-RNAME C 30 Name of Desired Structure

Parameter Reference Length Optional Text
T_DATA 0 Output of Data Read

Exception Text
INVALID_STRUCTURE Structure does not Belong to STATUS

Functionality
This function module can be used to read the tables for the generalstatus management from the archive.
All the entries in a currently open data object for a certain table areread from the archive.

Example
The following program carries out the Routine DO_SOMETHING for eachJEST record that was written with the archiving class STATUS in anarchive of the archiving object CO_ORDER. The archive files to be readare queried from the user. This occurs automatically throughARCHIVE_OPEN_FOR_READ.
DATA: g_handle LIKE sy-tabix,
gt_jest LIKE jest OCCURS 0,
g_jest LIKE jest.
CALL FUNCTION 'ARCHIVE_OPEN_FOR_READ'
EXPORTING
object = 'CO_ORDER'
IMPORTING
archive_handle = g_handle.
DO.
CALL FUNCTION 'ARCHIVE_GET_NEXT_OBJECT'
EXPORTING
archive_handle = g_handle
EXCEPTIONS
end_of_file = 1.
IF NOT sy-subrc IS INITIAL.
EXIT.
ENDIF.
CALL FUNCTION 'STATUS_ARCHIVE_GET_TABLE'
EXPORTING
archive_handle = g_handle
record_structure = 'JEST'
TABLES
t_data = gt_jest.
LOOP AT gt_jest INTO g_jest.
PERFORM do_something USING g_jest.
ENDLOOP.
ENDDO.
CALL FUNCTION 'ARCHIVE_CLOSE_FILE'
EXPORTING
archive_handle = g_handle.

Notes
The function module STATUS_ARCHIVE_GET_TABLE is used in particular bythe Archive Information System.

Description
Archive to be read.
The archive must have been opened with a suitable ADK function module,such as ARCHIVE_OPEN_FOR_READ. Thisfunction module the archive handle to be transferred.

Description
Here is determined for which tables data is needed. All the entries forthis table are delivered that are in the data object currently open.

Value range
All the table names for the archiving class STATUS, such as 'JSTO','JEST', 'JCDO', 'JCDS', 'DJEST'.

Description
The data read is 'delivered' here. The content of the transferred tableis relaced by the data read, it not attached.

Value range
You must transfer a line structure internal table, as specified inRECORD_STRUCTURE.