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

Parameter Reference Type Length Default Optional Text
DATATYPE 0 'RAW' X Type of Data ('RAW', 'HPGL2',...)
DEVICE TSP03-PADEST C 4 ' ' X Output Device (' '=Query Interactively)
IMMEDIATELY PRI_PARAMS-PRIMM C 1
LOCATION 0 'db' X Storage Location ('db' Database, '&G' File System)
PAGES RSPOTYPE-PAGES I 4 1 X Number of Output Pages (Information Only)
RQTITLE 0 ' ' X Title of Spool Request
SIZE 0 0 X Size of Data [in Bytes]

Parameter Reference Type Length Text
RQID TSP01-RQIDENT I 4 Spool Request Number Used

Parameter Reference Length Optional Text
DEVICE_DATA 0 Outputted Device Data

Exception Text
CANCELED_BY_USER Canceled by User
DEVICE_TYPE_BAD Unsuitable Output Device Type
DEVICE_TYPE_UNKNOWN Unknown Device Type
DEVICE_UNKNOWN Unknown Output Device
INTERNAL_ERROR Internal Error in Function Module
SIZE_MISMATCH Number of Bytes Does Not Match Table Size

Functionality
Output of printer data to be delivered in an internal table.
This function module executes a user dialog, if necessary, to determinethe 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 acorrect leader, character set, escape sequences, trailer and so on. Thetable lines are sent one after the other without a separator to theoutput device.

Required Input Parameters
None

Optional Input Parameters
DEVICE
Output device
If this parameter is missing or empty, the function module isinteractive and requests the information. The user can then influenceother parameters (such as number of copies, cover page and so on) orsearch 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 notsuitable.
DATATYPE
Data type
This type is used to select suitable output devices and initialize themcorrectly if necessary.
The connection is as follows: A format name is created for the spoolerfrom the prefix 'G_' and the data type specified here. Forexample, DATATYPE = 'HPGL': An output device can only be reachedif 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 internaltable is output.
If, for example, you do not want to output all the bytes of the lasttable line, you should specify the total number of bytes here. In thiscase, 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 inTransaction SP01 and in the host spooler, and is printed on the SAPcover page (if a cover page is used).
PAGES
Number of pages. Provides information on the size of the request forTransaction 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 theformat whose name is composed of 'G_' and the specified DATATYPE.

Further information
Function module 'GET_PRINT_PARAMETERS'