Fonction SAP ARCHIVE_ADMIN_SCHEDULE_WRI_JOB - Schedule Write Job for Parallel, Partial Archiving

Paramètre Reférence Type Long. Valeur par déf. Facultatif Description
ARCH_PARAMETERS ARC_PARAMS u 332 X ImageLink Structure
JOB_START TBTCSTRT u 224 X Start Data Description / Repetition Period of Background Job
OBJECT ARCH_OBJ-OBJECT C 10 Archiving Object
PRINT_PARAMETERS PRI_PARAMS u 196 X Structure for Passing Print Parameters
USER TBTCO-AUTHCKNAM C 12 SY-UNAME X Background User Name for Authorization Check
VARIANT RSVAR-VARIANT C 14 SPACE X Variant Name

Paramètre Reférence Type Long. Description
JOBCOUNT TBTCJOB-JOBCOUNT C 8 Background Job Number
JOBNAME TBTCJOB-JOBNAME C 32 Background Job Name

Paramètre Reférence Long. Facultatif Description
SELECTIONS RSPARAMS 102 X ABAP: General Structure for PARAMETERS and SELECT-OPTIONS

Exception Description
JOB_NOT_CREATED Write Job Could not Be Created
NO_SUCH_VARIANT Variant Does not Exist
OBJECT_NOT_FOUND Archiving Object Unknown
SPOOL_NOT_VALID Invalid Spool Parameter

Functionality
Schedules a write job without DB-server preference and withoutcompletely specified variant for parallel processing of the writephase.
The write program is determined for the archiving object and isscheduled as a background job using the variant and selection criteriaas specified at runtime. If a server group has been defined incross-archiving-object Customizing, the group is used to execute thewrite program. This function module does not attmpt to determine whichserver is running on the database host. The background processingsystem determines the exact server where the program is to be executed.

Example

Notes
Due to the job scheduling, the function module sets a COMMIT WORK sothat the function module cannot be called within a SELECT loop orcursor processing.
Write jobs that have been scheduled using this function module are notautomatically given a higher priority, with the result that schedulingwill fail on a server that only permits jobs with class A.
To schedule other job types or select the database host for a writejob, you can use function module ARCHIVE_SCHEDULE_JOB or theRFC-enabled function module XDA_SCHEDULE_JOB.

Description
If the write job could be scheduled, its number is displayed at thispoint.

Description
If the write job could be scheduled, its name is displayed at thispoint.

Description
Archiving parameters for print list for write job.
The specification for the archiving parameters is predefined by thestructure ARC_PARAMS and described in the documentation on the functionmodule GET_PRINT_PARAMETERS.
If no archiving parameters are specified, the folowing occurs whenfunction module is called for the fist time in the current program:

  • If the current program is running in the background: The current
    • archiving parameters are adopted.
    • If the current program is running online: The archiving parameters are
      • defined in a user dialog.
      Subsequent calls of the function module ARCHIVE_ADMIN_SCHEDULE_WRI_JOBwhere archiving parameters are not specified use the last parametersthat were determined.

      Default
      <(><<)>initial>

      Description
      Starting conditions for the write job
      The specification of a starting condition is specified in the structureTBTCSTRT and described in the documentation for the function moduleJOB_CLOSE beschrieben.
      If no starting condition is specified, the scheduled write job is startdimmediately.

      Default
      <(><<)>initial>

      Description
      Name of the archiving object whose write program is to be scheduled. Ifthe archiving object is not available, the exception OBJECT_NOT_FOUNDis triggered.

      Description
      Print parameters for the print list for write jobs.
      The specification of print parameters is defined in the structurePRI_PARAMS and described in the documentation for the function moduleGET_PRINT_PARAMETERS.
      If no print parameters are specified, the following occurs when thefunction module is called for the first time:

      • If the current program is running in the background: The current print
        • parameters are adopted.
        • If the current program is running online: The print parameters are
          • defined in a user dialog.
          Subsequent calls of the function module ARCHIVE_ADMIN_SCHEDULE_WRI_JOBwhere print parameters are not specified use the last parameters thatwere determined.

          Default
          <(><<)>initial>

          Description
          User name to whom the job step of the write job is assigned and that isis subjected to authorization check

          Default
          Current user who calls the function module

          Description
          Name of a variant with which the write program for the selectedarchiving object is to be run. However, only values from the variant forthe write program are adopted that are not contained in the SELECTIONStable.
          If no variant or ' ' is specified, only the SELECTIONS table determinesthe selection screen for the write program.
          If the specified variant does not exist, the exception NO_SUCH_VARIANTis displayed.

          Default
          ' '

          Description
          Table with structure RSPARAMS for the transfer of names and contents ofparameters and select-options for the write program.
          If a default variant is specified for the write program in the importparameter VARIANT, the parameters and selection options contained in theSELECTIONS table overwrite the variant values. In this way, it ispossible to use an existing standard variant as a basis and to changeselected selection criteria dynamically using table parameterSELECTIONS.
          For more information, refer to the ABAP documentation under key wordSUBMIT ... WITH SELECTION-TABLE.