Fonction SAP ARCHIVE_ADMIN_CHECK_STATUS - Status Information Is Transferred to Archiving Object

Paramètre Reférence Type Long. Valeur par déf. Facultatif Description
ARCHIVING_SESSION ADMI_RUN_D N 6 X Archiving Session Number
DISREGARD_OWN_JOB BOOLE_D C 1 SPACE X Do Not Consider Own Job
OBJECT ARCH_OBJ-OBJECT C 10 Archiving Object

Paramètre Reférence Type Long. Description
ARCHIVE_PROGRAM_IS_RUNNING 0 Archive Program Running
INTERRUPTED_SESSIONS C C 0 Interrupted Sessions Exist
NOT_DELETED_FILE_EXISTS 0 Undeleted Files Exist

Paramètre Reférence Long. Facultatif Description
RUNNING_JOBS ADMI_JOBS 124 X Running Archiving Jobs

Exception Description
OBJECT_NOT_FOUND Unknown Object

Functionality
Queries status information on an archiving object.
This function module enables you to determine whether, when you call upa data archiving object such as a preliminary, write, or delete job isplanned or running in Archive Administration for that archiving objectand whether there are archive files for correctly completed sessionsthat were not processed by the delete program. This function modulealso determines whether there are sessions that have been interrupted.
You can use this function module in your archiving programs to preventdata from being archived several times.

Example
DATA: PROG_EXT TYPE C.
DATA: FILE_EXT TYPE C.
...
CALL FUNCTION 'ARCHIVE_ADMIN_CHECK_STATUS'
EXPORTING
OBJECT = 'EXAMPLE'
IMPORTING
ARCHIVE_PROGRAM_IS_RUNNING = PROG_EXT
NOT_DELETED_FILE_EXISTS = FILE_EXT
EXCEPTIONS
OBJECT_NOT_FOUND = 01.

Description
Indicates the existence of interrupted archiving sessions for thearchiving object in question.
If the archiving object is client-dependent, the system only searchesin the current client. In Archive Administration, "incorrect" sessionsare not taken into consideration.
The existence of interrupted archiving sessions can, as with incompletearchiving sessions, lead to multiple archiving of the same data becausenot all of the data for archiving has been written to files.

Value range
'X': There is at least one interrupted archiving session of this kind.
' ': There are no interrupted archiving sessions of this kind.

Description
This parameter states whether a file exists that has not yet beenprocessed by the delete program.

Value range

  • ' ' = no file exists

  • 'X' = at least one file exists

    • Description
    When this parameter is set and the calling program is running in thebackground, the system does not take your own background job intoaccount when it determines the parameter ARCHIVE_PROGRAM_IS_RUNNING.

    Value range

    • ' ' = The system takes all archiving jobs belonging to this archiving
      • object into account when it determines ARCHIVE_PROGRAM_IS_RUNNING.
      • 'X' = The system does not take your own job (in which context
        • ARCHIVE_ADMIN _CHECK_STATUS was called) into account. If only your ownjob is running, the parameter ARCHIVE_PROGRAM_IS_RUNNING is not set.

1646195Data Collectors corrections ST-A/PI 01N* SP1