SAP Function ARCHIV_GET_ASYNCHRON_META - Retrieving archiving objects via meta-table

Parameter Reference Type Length Default Optional Text
ARCHIV_DOC_INDEX SAPB-SAPADOKID C 40 SPACE X Direct access to document part
ARCHIV_ID TOAV0-ARCHIV_ID C 2 X Storage System
ARC_DOC_ID TOAV0-ARC_DOC_ID C 40 X Document ID
AR_OBJECT TOAOM-AR_OBJECT C 10 Object type to be archived
CREATE_FLAG 0 2 X 1: always, 2: only if requested by archive (def.)
DELETE_FLAG 0 SPACE X 1:delete when processed (def.),2:do not delete
NAME_FUB RS38L-NAME C 30 Name of function module to be called
OBJECT_ID SAPB-SAPOBJID C 50 Unique object key of application
PATH SAPB-SAPPFAD C 70 SPACE X Target path in file system
REQUEST_ID TOAR7-REQUEST_ID C 10 SPACE X Unique number of request
SAP_OBJECT TOAOM-SAP_OBJECT C 10 Calling application

Parameter Reference Type Length Text
REPATH SAPB-SAPPFAD C 70
REQUEST_ID TOAR7-REQUEST_ID C 10 Unique number of request

Exception Text
ERROR_ARCHIV Error from ArchiveLink interface
ERROR_COMMUNICATIONTABLE Table TOAAR
ERROR_CONNECTIONTABLE Error from link tables
ERROR_KERNEL SAP kernel error
ERROR_PARAMETER Invalid transfer parameters
NOT_UNIQUE Object contains several archive objects
NO_REQUEST Not possible to create request

Functionality
This FM is used for processing asynchronous retrieval requests. The FMARCHIVOBJECT_GET_ASYNCHRON is called internally. The retrieval requestsare stored in table TOAR7.
The FM can be passed a callback module which is called as soon as therequest has been processed or the status changed.
The callback module must have the following interface:
Importing:
SAP_OBJECT like TOAR7-SAP_OBJECT
AR_OBJECT like TOAR7-AR_OBJECT
OBJECT_ID like TOAR7-OBJECT_ID
STATUS like TOAR7-REQ_STATUS
SIGN like SAPB-SAPBZZ
PFAD like SAPB-SAPPFAD
The valid status values are defined in program LOPTRF01:
The following values are currently defined (19/9/95):
0. "Request created
1000. "Archive requested
2000. "Request deleted
4000. "Archive request processed
5000. "Application reports error
>3000 <4000. "Archive error confirmation
>7000. "ArchiveLink error
>2000 <=3000. "Archive error request
Others "unknown.