Fonction SAP ARCHIVE_FILES_ACCESS_KIND_GET - Read Archives Sequentially or By Object?

Paramètre Reférence Type Long. Valeur par déf. Facultatif Description
I_LIMIT F F 8 5 X Threshold (in percent)

Paramètre Reférence Long. Facultatif Description
ET_FILES_OBJ_READ ARCH_OFFS 24 X Address of Data Objects for Accessing by Object
ET_FILES_SEQ_READ ARCHIV_KEY 20 X Key for Archive File for Accessing Sequentially
IT_FILES_AND_POS ARCH_OFFS 24 Address of Data Objects To Be Read

Exception Description
LIMIT_INVALID Parameter I_LIMIT Transferred with Invalid Value

Functionality
Reads the data objects of specific archive files. The data objects arepassed with IT_FILES_AND_POS.
The function module decides which access type is faster:

  • Access to specific data objects (using function module
    • ARCHIVE_READ_OBJECT) or
    • Sequential reading of complete archive files (using function modules
      • ARCHIVE_OPEN_FOR_READ andARCHIVE_GET_NEXT_OBJECT). Dataobjects not relevant for the read are skipped.
      Important here is the ratio of the number of data objects to be read tothe total number of data objects in the archive file.

      Description
      This is the ratio of the number of data objects to be read to the totalnumber of data objects in the archive file. If this value is exceeded,sequential reading of complete archive files is recommended.

      Value range
      0 < I_LIMIT < 100

      Default
      5 - Sequerntial access is to be used when 5% or more of the dataobjects are to be read.
      This default value is based on recommendations from the ADK team.

      Description
      Identifies archive files (including offset for data objects) for whichspecific read access is recommended.
      The number of relevant data objects is less than I_LIMIT
      .

      Description
      Identifies archive files for which sequential reading of completearchive files is recommended.
      The number of relevant data objects exceeds I_LIMIT.

      Description
      Internal table that contains the following information per row:

      • Offset of data object to be read

      • ID of archive file that contains the data object

        • Archive files that do not contain any data objects according to SARA"Management" and archive files not found in "Management" are notincluded. They are neither included in table ET_FILES_SEQ_READnor table ET_FILES_OBJ_READ.

        Value range
        Archive files and offsets that are included in SARA "Management".