Fonction SAP ARCHIVE_ADMIN_SELECT_SESSIONS - Selection of Archiving Runs and Files

Paramètre Reférence Type Long. Valeur par déf. Facultatif Description
BEING_RELOADED CHAR1 C 1 SPACE X Being Reloaded
CLIENT_DEPENDENCE CHAR1 C 1 'X' X Take Client-Dependence Into Account
COMPLETE CHAR1 C 1 SPACE X Complete
CREATED_BY_RELOAD CHAR1 C 1 SPACE X Created Upon reload
INCOMPLETE CHAR1 C 1 SPACE X Incomplete
INCORRECT CHAR1 C 1 SPACE X Errors
INDICATE_PROGRESS CHAR1 C 1 SPACE X Activate GUI Progress Indicator
INTERRUPTED_COMPLETE CHAR1 C 1 SPACE X Interrupted/Complete
INTERRUPTED_INCOMPLETE CHAR1 C 1 SPACE X Interrupted/Incomplete
INVALID CHAR1 C 1 SPACE X Invalid
REPLACED CHAR1 C 1 SPACE X Replaced
RUNS_WITHOUT_FILES CHAR1 C 1 'X' X Run Without Files
TO_BE_ARCHIVED CHAR1 C 1 SPACE X With "To Be Archived" Flag
WRITING ADMI_RUN-WRITING C 1 X Write Phase Running

Paramètre Reférence Type Long. Description
ARCHIVE_RUNS ARCH_T_RUNS h 296 Archiving Sessions: Properties, Jobs, and Status

Paramètre Reférence Long. Facultatif Description
ADK_SELECTED_FILES ADMI_FILST 680 X Archive Files: Header Information, Jobs, and Status
ADK_SELECTED_RUNS ADMI_RUNST 288 X Archiving Runs: Header Information, Jobs, and Status
CLIENT RNG_CLIENT 9 X Ranking table for client field
DATE RNG_DATE 19 X Ranking table for date field
DOCUMENT RNG_RUN 15 X Ranking table for archiving sessions
OBJECT RNG_OBJECT 23 X Range Table for Archiving Object Field
ORIG_CLIENT RNG_CLIENT 9 X Ranking table for client field
SELECTED_FILES ADMI_FILES 512 X Archive Files of Archive Sessions
SELECTED_RUNS ADMI_RUN 160 X Archive Runs Header Data
SYSID RNG_SYSID 19 X Range Table for the System ID Field
USER RNG_USER 27 X Range Table for Field with Name of User

Exception Description
OBJECT_NOT_FOUND Unknown Object

Functionality
This function module determines archiving runs and archive files thatmeet the selection criteria that were specified when the functionmodule was called.
The selection parameters archiving object, client, date of archivingrun, archiving run number, and user that started the run, can be passedto the function module through the range tables OBJECT, CLIENT, DATE,DOCUMENT, and USER. In addition, you can restrict the selection toarchiving runs with a particular status.
The runs and files that the function module determines are output intothe structures SELECTED_RUNS (which has the same structure as theadministration table ADMI_RUN) and SELECTED_FILES (which has the samestructure as the administration table ADMI_FILES). If additionalinformation is required for the runs and files, the output structuresADK_SELECTED_RUNS and ADK_SELECTED_FILES can also be requested. Thesestructures also contain:

  • Information about the archiving jobs that belong to the runs and files

  • Status information

  • The status information for the archiving runs that is outputcorresponds to the status information displayed in SARA administration.
    For a more detailed description, see the documentation for theADK_SELECTED_RUNS parameter of this function module.

    Example
    1. Selection of runs for archiving object EXAMPLE that have REPLACED orINVALID status:
    ...
    DATA:
    selected_runs LIKE TABLE OF admi_run,
    selected_files LIKE TABLE OF admi_files,
    ls_selected_object LIKE rng_object,
    lt_selected_object LIKE TABLE OF rng_object.
    ls_selected_object-sign = 'I'.
    ls_selected_object-option = 'EQ'.
    ls_selected_object-low = 'EXAMPLE'.
    ls_selected_object-high = ''.
    APPEND ls_selected_object TO lt_selected_object.
    ...
    CALL FUNCTION 'ARCHIVE_ADMIN_SELECT_SESSIONS'
    EXPORTING
    REPLACED = 'X'
    INVALID = 'X'
    TABLES
    OBJECT = lt_selected_object
    SELECTED_RUNS = selected_runs
    SELECTED_FILES = selected_files.
    ...

    Description
    Selection of archiving runs that are reloaded. The contents of thearchiving runs are reloaded into the database.

    Description
    If this parameter is assigned the value X (Default: CLIENT_DEPENDENCE ='X'), the client dependence indicator of the archiving object isconsidered during the selection. If the parameter has an initial value,the runs are selected independent of the client dependence indicator fothe archiving object.

    Description
    Selection of complete archiving runs. Both the write process and thedeletion phase have been completed.

    Description
    Selection of runs that arise due to reloading. The archiving runcontains the data that is not inserted into the database during thereload of another archiving run. The archiving run is not released forfurther access before the successful completion of the reload.

    Description
    Selection of incomplete archiving runs. The write process is not yetcomplete or the deletion program has not yet run for all archive files.

    Description
    Selection of archiving runs with errors. The write process terminatedbefore the completion of the first archive file.

    Description
    Selection of interrupted, complete archiving runs. The archiving runwas interrupted, either explicitly by the user or because the runtimeor the total amount of data to be written exceeded the correspondinginterruption criteria that were set.

    Description
    Selection of interrupted, incomplete archiving runs. The archiving runwas interrupted, either explicitly by the user or because the runtimeor total amount of data to be written exceed their respectiveinterruption criteria.

    Description
    Selection of invalid archiving runs. The archiving run is declaredinvalid.

    Description
    Selection of replaced archiving runs. The archiving run has beenreloaded or converted.

    Description
    If the parameter is assigned the value X (Default: RUNS_WITHOUT_FILES ='X'), runs for which no archive files exist are also selected. If theparameter has an initial value, the resulting set does not include runsof this type.

    Description
    Selection of archiving runs marked as to be archived. Theadministration data of the archiving run can be archived with thearchiving object BC_ARCHIVE.

    Description
    This parameter determines whether archiving runs for which the writephase is not yet complete should be selected; that is, runs for whichthe last file has not yet been completely written or the write programor write job has terminated uncontrolled. WRITING = 'X' means that onlyruns for which the write phase is not yet complete are selected.WRITING = '' means that only runs whose write phases have beencompleted (controlled) are selected. If the parameter is not specified,the selection is made, irrespective of whether the write phase iscomplete.

    Description
    The archive files that belong to the selected archiving runs aredisplayed along with their header data in ADK_SELECTED_FILES. Inaddition to the data contained in the archiving administration tableADMI_FILES, ADK_SELECTED_RUNS contains information about the archivingjobs that belong to the archiving files.

    Description
    The selected archiving runs, their header information and the jobsbelonging to the runs and the status of the runs in archivingadministration (transaction SARA) are displayed in ADK_SELECTED_RUNS.There are two status values displayed in the structureADK_SELECTED_RUNS. The column HEADING contains the status value thatdetermines in which section of the archiving administration(transaction SARA ) the runs appear.
    0 : Archiving runs with errors
    1 : Incomplete archiving runs
    2 : Complete archiving runs
    3 : Archiving runs that are loaded back
    4 : Archiving runs created by reloads
    5 : Replaced archiving runs
    6 : Archiving runs marked to be archived
    7 : Invalid archiving runs
    8 : Interrupted archiving runs (incomplete)
    9 : Interrupted archiving runs (complete)
    The column DIS_STATUS contains the status value that specifies whichstatus is displayed for the archiving run in the detail information inarchiving administration (transaction SARA ).
    0 : terminated
    1 : incomplete
    2 : complete
    3 : reloaded
    4 : converted
    5 : being reloaded
    6 : created due to reload

    Description
    The archive files that belong to the selected archiving runs aredisplayed with their header data in SELECTED_RUNS. SELECTED_RUNS hasthe same structure as the ADK administration table ADMI_FILES.

    Description
    The selected archiving runs and their header data are displayed inSELECTED_RUNS. SELECTED_RUNS has the same structure as the ADKadministration table ADMI_RUN.