SAP Function CONVERT_OTF_MEMORY - SAPscript: Convert OTF from memory into text format

Parameter Reference Type Length Default Optional Text
FORMAT 0 'ASCII' X Target format for LINES table
MAX_LINEWIDTH 0 132 X For ASCII format: Number of lines in LINES-TDLINE

Parameter Reference Type Length Text
BIN_FILESIZE 0 For binary format: Number of bytes in LINES

Parameter Reference Length Optional Text
LINES TLINE 134 Output table with target format

Exception Text
ERR_CONV_NOT_POSSIBLE Conversion not possible/supported
ERR_FORMAT Format not supported
ERR_MAX_LINEWIDTH Line width must be between 2 and 132
MEMORY_EMPTY Memory for OTF data is empty

Functionality
The parameter DEVICE=OTF_MEM with the function OPEN_FORM allowsSAPscript word processing to be output to a buffer instead of creatinga spool request, for example. In this case, the text is formattedinternally for the pseudo device SCREEN and the result stored in thebuffer.
The buffer is read with the function module CONVERT_OTF_MEMORY andreturned in a table (table parameter LINES). The format of the text inthe table is determined by the parameter FORMAT. The maximum line widthused in the field LINES-TDLINE in the table LINES is controlled by theparameter MAX_LINEWIDTH.
The values currently supported for the FORMAT parameter are:

  • ASCII

    • In the case of the ASCII format, the LINES table contains the text tobe output (without any control characters) in the field LINES-TDLINE,adjusted to the specified maximum line width. The field LINES-TDFORMATcontains the indicator for a SAPscript extended line with a line break(/=) when a new line is be started. Lines which only contain theextended line tag (=) in this field are continuations of the previousline. Line breaks are not shown in the ASCII format.

    Example
    The returned table LINES could appear as follows:
    PROTECT
    /= This is the first text line in the table LINES.
    /= This is the second text line. Very long lines are
    = represented by subsequent lines.
    ENDPROTECT

    Notes
    The maximum line length in the parameter FORMAT must not be smallerthan 2 or greater than 132 !
    The text returned for the ASCII format can be regarded as a SAPscripttext if the field LINES-TDFORMAT is interpreted as a SAPscript tagcolumn. The text can also be regarded as a "raw text" if the fieldLINES-TDFORMAT is ignored and each line of the table LINES (fieldLINES-TDLINE) interpreted as a text line.
    INCLUDE STXD_PP_FORMAT OBJECT DOKU ID TX
    INCLUDE STXD_PP_MAX_LINEWIDTH OBJECT DOKU ID TX
    INCLUDE STXD_PP_LINES OBJECT DOKU ID TX