Ansicht
Dokumentation

SUBST_START_REPORT_IN_BATCH - Start eines ABAP/4 Reports mit einer neuen Variante im Batch

RFUMSV00 - Advance Return for Tax on Sales/Purchases   CL_GUI_FRONTEND_SERVICES - Frontend Services  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Funktionalität

Der Baustein dient der Einplanung von Reports im Batch von dem Upgrade-Steuer-Programm SAPup über RFC. Die Report-Parameter können in einer Tabelle mit RSPARAMS-Struktur angegeben werden.

Auch wenn die Funktionalität verführerisch erscheinen mag, ist von der Verwendung des Bausteins dringend abzuraten, da die Gruppe SUGR beim Upgrade zur Noch-Produktivzeit im Startrelease eingespielt wird und eventuell inkompatible Änderungen enthalten kann.

Beispiel

Der Standard-Aufruf des Bausteins startet einen Batch-Job mit einem Report , einem Jobnamen identisch mit und einer Variante 'SAP_UPGRADE', die mit den Parametern in TT_REPORTPARAM gefüllt wird. Der Job läuft als User 'DDIC' auf einem beliebigen ApServer in der System-Sprache. Der Job hat keine vom Standard abweichenden Druckparameter, wird nur bei Verfügbarkeit des Batch-Services eingeplant (IV_SCHEDEVER). Bei Fehlern in der Einplanung des Jobs (IV_ABORT_ON_ERROR) terminiert der Baustein mit der Exception BATCH_SCHEDULING_FAILED, die genaue Exception wird als Return Code in EV_STARTRC zurückgegeben. Bei IV_ABORT_ON_ERROR = 'X' wird die Exception direkt von den Bausteinen JOB_OPEN, JOB_SUBMIT, JOB_CLOSE ausgelöst.

*" CALL FUNCTION 'SUBST_START_REPORT_IN_BATCH'
*" IMPORTING
*" IV_JOBNAME = SPACE
*" IV_REPNAME =
*" IV_VARNAME = 'SAP_UPGRADE'
*" IV_AUTHCKNAM = 'DDIC'
*" IV_BATCHHOST = SPACE
*" IV_LANGUAGE = SY-LANGU
*" ( IS_PRIPARAMS = PRI_PARAMS )
*" IV_SCHEDEVER = ' '
*" IV_ABORT_ON_ERROR = ' '
*" IV_VARIANTTEXT = 'Upgrade variant'
*" EXPORTING
*" EV_JOBCOUNT LIKE TBTCO-JOBCOUNT
*" EV_STARTRC LIKE SY-SUBRC
*" EV_VARIWRC LIKE SY-SUBRC
*" TABLES
*" TT_REPORTPARAM STRUCTURE RSPARAMS
*" EXCEPTIONS
*" VARIANT_EXIST_CHECK_FAILED
*" VARIANT_UPDATE_FAILED
*" VARIANT_UPDATE_NOT_AUTHORIZED
*" VARIANT_UPDATE_NO_REPORT
*" VARIANT_UPDATE_NO_VARIANT
*" VARIANT_UPDATE_VARIANT_LOCKED
*" VARIANT_INSERT_FAILED
*" VARIANT_INSERT_NOT_AUTHORIZED
*" VARIANT_INSERT_NO_REPORT
*" VARIANT_INSERT_VARIANT_EXISTS
*" VARIANT_INSERT_VARIANT_LOCKED
*" VARIANT_WRITE_FAILED
*" NO_BATCH_SERVICE
*" NO_SERVER_LIST
*" BATCH_SCHEDULING_FAILED

Hinweise

Die wichtigsten Exceptions sind NO_BATCH_SERVICE und NO_SERVER_LIST. Letzte kann nur ausgelöst werden, wenn man einen Host für die Ausführung des Jobs spezifiziert hat. Der dann aufgerufene Baustein TH_SERVER_LIST zur Ermittlung aller ApServer ist fehlgeschlagen, mit großer Wahrscheinlichkeit deswegen, weil der Message-Server nicht läuft. Falls die ApServer ermittelt werden können, aber weder der IV_BATCHHOST noch der lokale Host einen Batch-Service anbieten, wird die Exception NO_BATCH_SERVICE ausgelöst. Beide Exceptions können nie bei IV_SCHEDEVER = 'X' auftreten. Allerdings ist dann zu erwarten, daß der eingeplante Job gar nicht losläuft.

Weiterführende Informationen

Parameter

EV_JOBCOUNT
EV_STARTRC
EV_VARIWRC
IS_PRIPARAMS
IV_ABORT_ON_ERROR
IV_AUTHCKNAM
IV_BATCHHOST
IV_BATCHINSTANCE
IV_JOBNAME
IV_LANGUAGE
IV_REPNAME
IV_SCHEDEVER
IV_VARIANTTEXT
IV_VARNAME
TT_REPORTPARAM

Ausnahmen

BATCH_SCHEDULING_FAILED
JOB_COULD_NOT_BE_RELEASED
NO_AUTHORIZATION
NO_BATCH_SERVICE
NO_SERVER_LIST
REPORT_DOES_NOT_EXIST
REPORT_NAME_INITIAL
SYNTAX_ERROR_IN_REPORT
VARIANT_EXIST_CHECK_FAILED
VARIANT_INSERT_FAILED
VARIANT_INSERT_NOT_AUTHORIZED
VARIANT_INSERT_NO_REPORT
VARIANT_INSERT_VARIANT_EXISTS
VARIANT_INSERT_VARIANT_LOCKED
VARIANT_UPDATE_FAILED
VARIANT_UPDATE_NOT_AUTHORIZED
VARIANT_UPDATE_NO_REPORT
VARIANT_UPDATE_NO_VARIANT
VARIANT_UPDATE_VARIANT_LOCKED
VARIANT_WRITE_FAILED

Funktionsgruppe

SUGI

Addresses (Business Address Services)   ROGBILLS - Synchronize billing plans  
Diese Dokumentation steht unter dem Copyright der SAP AG.

Length: 4792 Date: 20240523 Time: 115357     sap01-206 ( 81 ms )