Reads the spool list of an ABAP program step.
Transaction: SM37
Interface: AE and Standard
R3_GET_JOB_SPOOL
FILE=...
[,NAME=...]
[,JOBCOUNT=...]
[,STEP=...]
[,NOFOUND=...]
[,MAXLINES=...]
[,SPOOLNR=...]
[,FORMAT=...]
[,PAGES=...]
[,FILTER=...]
[,RAW=...]
Syntax | Description/Format |
---|---|
FILE= |
Name of a file to which the result (step's
spool list) should be written. This file is also registered as job output in the AE job. |
NAME= |
Name of the SAP job that contains the step. Not defining the job name has the effect that the system automatically uses the name of the last SAP job that has been processed via the AE job that includes this script element. |
JOBCOUNT= |
Job count of the SAP job that contains the step. Not defining the job count has the effect that the system automatically uses the value of the last SAP job that has been processed via the AE job. If you use the parameters NAME and JOBCOUNT, keep in mind that the spool cannot be retrieved if the corresponding job has been deleted in the SAP system (setting "Delete job in CCMS after completion" in the AE job). |
STEP= |
Number of steps in SAP job. Default value: 1 |
NOFOUND= |
Handling if the spool list could not be found. Allowed values: NORMAL (default value) and ABEND NORMAL - The AE
job continues. |
MAXLINES= |
Maximum number of lines that are written to the file. Default value: 9999 The definitions that are made here are not considered if the settings FORMAT = PDF or BIN have been specified. |
SPOOLNR= |
Spool-request number. Not defining NAME, JOBCOUNT or SPOOLNR has the effect that the system automatically uses the last SAP job that has been processed via the AE job. |
FORMAT= |
Output format. Allowed values: TXT (default), RAW (instead of the parameter RAW - see below), PDF, BIN and HTM With the settings BIN and PDF being used, the spool list is not converted and transferred in a binary format. |
PAGES= |
Pages. Syntax of the parameter: PAGES=page[;page[;...]] Separate the specifications for the individual page areas by using the character ";". Examples:
The symbol $ can be used instead of the last page:
The parameters FORMAT( not PDF), SPOOLNR and PAGES are also available for the XBP 3.0 interface (as of version 1.1). |
FILTER= |
Filter setting. String according to which a selection should be made. Wildcard characters cannot be used. |
RAW= |
Supplies the spool list in untrimmed size. Allowed values: YES and NO (default value) YES - The spool list is supplied
in untrimmed size (i.e. including all formatting characters). Automic recommends using FORMAT=RAW instead of this parameter. |
ENCODING= |
Encoding for the generated output file (Parameter FILE=). For example: UTF-8 Default value: ISO-8859-1 When you specify an encoding that is not supported or invalid, the job will abort with an error message. The SAP Forms provide an input assistant for this field which lists all the supported encodings. |
This script element can be used with the following parameter combinations:
The parameter FILTER requires the AE interface and the parameter RAW requires the standard interface.
The spool list can only be transferred if the checkbox "Delete job in CCMS after completion" in the Host Attributes tab has not been activated. This limitation does not apply if either the parameter SPOOLNR has been defined or the standard XBP 3.0 interface (as of version 1.1) is used without the parameters NAME, JOBCOUNT and SPOOLNR.
Note for using the standard interface XBP3.0 with a later version than V1.1:
standard interface: As a rule, the entire spool list
is sent to the SAP agent. The standard function of the XBP interface
does not allow the user to access parts of the spool list. Note
that large spool lists can reduce the performance of the SAP agent.
The parameter MAXLINES= is first
read when the entire spool list has already been transferred.
Note that by default, created files are stored on the computer on which the agent has been installed (for example, R3_GET_JOB_SPOOL; FILE=).
A report is activated in the example shown below. The spool list of the step is retrieved without the job name or job count being indicated as parameters.Therefore, the job last processed by the agent is automatically used.
R3_ACTIVATE_REPORT REPORT='RSPO0041',VAR='STANDARD',COVERPAGE=YES
R3_GET_JOB_SPOOL FILE='c:\temp\spoollist.txt',NOFOUND=ABEND,MAXLINES=20
See also: