Processes the specified report. If required, you can select a variant and parameters for list controlling matters.
Transaction: SM36, SM37
Interface: AE and Standard
R3_ACTIVATE_REP[ORT]
REPORT=...
[,VARIANT=...]
[,DESTINATION=...]
[,COPIES=...]
[,LIST_NAME=...]
[,LIST_TEXT=...]
[,IMMEDIATELY=...]
[,RELEASE=...]
[,NEW_LIST_ID=...]
[,EXPIRATION=...]
[,LINE_COUNT=...]
[,LINE_SIZE=...]
[,LAYOUT=...]
[,COVERPAGE=...]
[,SAP_COVER_PAGE=...]
[,OS_COVER_PAGE=...]
[,RECEIVER=...]
[,DEPARTMENT=...]
[,AUTHORITY=...]
[,DATA_SET=...]
[,TYPE=...]
[,SPOOL_PRIORITY=...]
[,TEXTONLY=...]
[,FRAMES=...]
[,SUPPRESS_SHADING=...]
[,WITH_STRUCTURE=...]
[,DEFAULT_SPOOL_SIZE=...]
[,PRINTER_MAIL_ADDRESS=...]
[,SPOOL_PAGE_FROM=...]
[,SPOOL_PAGE_TO=...]
[,ARCHIVE_MODE=...]
[,ARCHIVE_SAPOBJECT=...]
[,ARCHIVE_OBJECT=...]
[,ARCHIVE_INFO=...]
[,ARCHIVE_TEXT=...]
[,MONITOR=...]
[,WAIT=...]
[,ABORTED=...]
[,REPL[ICATE]=...]
[,BEG_LOGLINES=...]
[,END_LOGLINES=...]
[,GET_SPOOL=...]
Syntax | Description/Format |
---|---|
REP[ORT]= | The name of the report. Format: script literal |
VAR[IANT]= | The name of the variant. Format: script literal |
Print Parameters | |
DEST[INATION]= |
The output device. This parameter specifies the name of the output device. In most cases, this is a printer name but it can also be the name of a fax machine or the like. Note that you cannot use the long SAP printer names for technical reasons caused by SAP's XBP interface. Use the 4-digit technical name instead. |
COPIES= |
The number of copies. Default value: 0 Here you specify the number of document copies that should be printed. |
LIST_N[AME]= |
The name of the spool request. This parameter can be used to specify the name of the spool request. It can consist of any letters, numbers, special characters and blanks. The suggested standard name for a spool request consists of the 8 letters of the report name, the separator '_' and the first 3 letters of the user nameName of the Automation Engine user.. |
LIST_T[EXT]= |
The text for the cover page. This parameter can be used to specify the descriptive text for the spool request. It can consist of any letters, numbers, special characters and blanks. |
IMM[EDIATELY]= |
Print immediately. Allowed values: YES and NO (default value) |
REL[EASE]= |
Delete after printing. Allowed values: YES and NO (default value) This parameter specifies whether the spool request will be deleted immediately after printing at the output device or only when the spool retention period has expired. |
NEW_LIST_ID= |
A new spool request. Allowed Values: YES (default value) and NO |
EXPIR[ATION]= |
The spool retention period. Default value: 0 This parameter specifies how many days a spool request is kept in the spool system before it will be deleted. |
LINE_COUNT= |
The page length of list. Default value: 0 The number of lines per list page. When this field contains a zero or if it is empty, the number of pages of the particular list is not limited (not allowed for printing). In this case, the page length of the list is only determined by its content. For printing, the maximum number of lines per page depends on the selected format. You can select a different format to have the number of lines changed. |
LINE_SIZE= |
The width of list. Default value: 0 This parameter contains the current line width of the list. For printing, the maximum line width depends on the selected format. Select another format to change the line width. |
LAYOUT= |
Editing for printout. This parameter defines the print format of the spool request. The format mainly defines the page format such as the maximum number of lines and columns on one printed page. |
COVER[PAGE]= |
The selection of a cover page. Allowed values: YES and NO (default value) This parameter determines whether a cover page with report selections is printed at the beginning. When a cover page is created, it will be adjusted to the job report. This documents which parameters were used for this execution. |
SAP_COVER[_PAGE]= |
The SAP cover page. Allowed values: "" (default value), "X" and "D" "" - No cover page is printed. |
OS_COVER[_PAGE]= |
The host spool cover page. Allowed values: "" (default value), "X" and "D" "" - No cover page is printed. |
RECEIVER= |
Recipient. This parameter contains the receiver name of the spool request. This name is printed on the cover page. The current user's name is used by default. |
DEPART[MENT]= |
The departmentDepartment name to which the Automation Engine user belongs. name as it is printed on the cover page. This parameter contains the department name for the spool request. |
AUTHORITY= |
Authorization. This parameter contains authorization for the spool request (maximum of 12 characters). The content of the spool request is only displayed to authorized users. |
DATA_SET= | The name of the spool dataset. Format: script literal |
TYPE= | The type of spool request. Format: script literal |
SPOOL_PRI[ORITY]= |
The spool request priority. Default value: 5 |
TEXTO[NLY]= |
Plain text. Allowed values: YES and NO (default value) Controls the output of non-ASCII characters of a print list. |
FRAMES= |
Frame characters. Allowed values: YES (default value) and NO Handles default framing. |
SUPPRESS_SHADING= |
Colors and shades are not printed. Allowed values: "YES", "NO" (default value) |
WITH_STRUCTURE= |
Structured information is included. Allowed values: "YES", "NO" (default value) |
DEFAULT_SPOOL_SIZE= |
This is the definition of 255 characters as the maximum line width. Allowed values: "YES", "NO" (default value) |
PRINTER_MAIL_ADDRESS= |
The email address of an email printer. |
SPOOL_PAGE_FROM= SPOOL_PAGE_TO= |
The number of the page as of which and until which you want to print. The default setting is that all pages are printed. |
Archive Parameters | |
ARCHIVE_M[ODE]= |
The archiving mode. Allowed values: 1 (default value), 2 and 3 1 - The document should only be printed. |
ARCHIVE_S[APOBJECT]= |
The object type of the business object. SAP objects are classified with object types. |
ARCHIVE_O[BJECT]= |
The document type. Archive objects are classified according to document types. |
ARCHIVE_I[NFO]= |
The information field. Information code for the archiving request. |
ARCHIVE_T[EXT]= |
The text information field. Descriptive text for the archiving request. It can consist of any letters, numbers, special characters and blanks. |
Control Parameters | |
MON[ITOR]= |
The logging of status monitoring in the activation log. Allowed Values: YES and NO (default value) |
Parameters for parent child relationship |
|
WAIT= |
Waits for SAP job children to end. Allowed values: YES and NO (default value) YES - Wait for all children to end. Children are logged in the activation report. |
ABORTED= |
Reaction to abnormal end of SAP job children. Allowed values: YES (default value) and NO YES - SAP job (parent) is aborted. The script is not continued and the AE job ends abnormally. |
REPL[ICATE]= |
The handling of children of intercepted jobs. Allowed values: YES and NO (default value) YES - The children of a job are replicated in the AE system. They are displayed in the UserInterface's Activity Window. Statistical records and reports are created in the AE system. |
BEG_LOGLINES= | This parameter determines the number of lines that should be assumed to the AE job report (starting with the SAP job log's beginning). |
END_LOGLINES= |
The number of lines that should be written to the AE job report (starting with the SAP job log's ending). By default, the complete job log is used if neither the parameter END_LOGLINES nor BEG_LOGLINES has been specified. If only one of these two parameters has been specified, the corresponding job-log lines (either from the beginning or the end) are read. In both parameters, you can only use numeric values. |
GET_SPOOL= |
This requests the spool list of the started job.
Allowed values: YES or NO (default) YES = The spool list is requested. It is stored as a text file in the directory that has been defined in the SAP agent's INI file with the parameter Download_dir= (section [GLOBAL]). The name of this file is structured as follows: NO = The spool list is not requested. The spool list is requested for ALL child jobs if you use this script element several times in an SAP job and if you combine all the individual job steps by using the option "Combine job steps" in the Connection objecteven if the parameter GET_SPOOL="YES" is only set for one R3_ACTIVE_REPORT. Spool entries of children are only requested when the parameter REPLICATE= is either set to YES or to ALL. |
This script element enables the modification of an ABAP step. The name of the report, variant and various archiving and print parameters for the ABAP step can be reset when the SAP job has been selected.
This parameter corresponds to the SAP Dictionary Structure PRI_PARAMS and ARC_PARAMS fields. Please use the dictionary or the BAPI Browser to get detailed information about the individual fields.
Instead of using a variant, the selection criteria can also be assigned using the script element R3_SET_SELECT_OPTION.
R3_ACTIVATE_REPORT REPORT='ZSUSER00',VARIANT='ALL_USERS',COVERPAGE='YES',DESTINATION='LT77',IMMEDIATELY='YES'
See also:
Sample Collection
Calling an MBean