Ansicht
Dokumentation

RSPO_OUTPUT_DEVICEDATA - Spool Output Control of an Internal Table with Formatted Data

CL_GUI_FRONTEND_SERVICES - Frontend Services   BAL_S_LOG - Application Log: Log header data  
This documentation is copyright by SAP AG.

Functionality

Output of printer data to be delivered in an internal table.

This function module executes a user dialog, if necessary, to determine the output device, number of copies etc. (Function module 'GET_PRINT_PARAMETERS' is used for this.)

Required Tables

DEVICE_DATA

A table containing ready and complete printer data. It must contain a correct leader, character set, escape sequences, trailer and so on. The table lines are sent one after the other without a separator to the output device.

Required Input Parameters

None

Optional Input Parameters

DEVICE

Output device
If this parameter is missing or empty, the function module is interactive and requests the information. The user can then influence other parameters (such as number of copies, cover page and so on) or search for a device with the possible entries.
If this parameter is set, processing takes place in the background. Terminations may occur if the device specified does not exist or is not suitable.

DATATYPE

Data type
This type is used to select suitable output devices and initialize them correctly if necessary.
The connection is as follows: A format name is created for the spooler from the prefix 'G_' and the data type specified here. For example, DATATYPE = 'HPGL': An output device can only be reached if its device type has a 'G_HPGL' format.

SIZE

Number of bytes to be output
If this parameter is missing or is set to 0, the entire internal table is output.
If, for example, you do not want to output all the bytes of the last table line, you should specify the total number of bytes here. In this case, the following applies:
If L is the number of table lines:
If R is the width of the table in bytes:
( L - 1 ) * R < SIZE <= L * R

RQTITLE

The title of the spool request to be generated. It can be seen in Transaction SP01 and in the host spooler, and is printed on the SAP cover page (if a cover page is used).

PAGES

Number of pages. Provides information on the size of the request for Transaction SP01.

LOCATION

Location for storing the TemSe object created: 'db' for database and '&G' for file system.

Output Parameters (Optional)

RQID

The spool request number allocated by the spooler.

Example

See test report RSPO0044.

Notes

Output devices can only be used if their device type supports the format whose name is composed of 'G_' and the specified DATATYPE.

Further information

Function module 'GET_PRINT_PARAMETERS'

Parameters

DATATYPE
DEVICE
DEVICE_DATA
IMMEDIATELY
LOCATION
PAGES
RQID
RQTITLE
SIZE

Exceptions

CANCELED_BY_USER
DEVICE_TYPE_BAD
DEVICE_TYPE_UNKNOWN
DEVICE_UNKNOWN
INTERNAL_ERROR
SIZE_MISMATCH

Function Group

SPOD

BAL_S_LOG - Application Log: Log header data   ABAP Short Reference  
This documentation is copyright by SAP AG.

Length: 3571 Date: 20240523 Time: 130444     sap01-206 ( 57 ms )