Register Login

Options for the SAPSprint print server tool

Updated May 18, 2018

CAUTION: We no longer support SAPLPD as a print server tool (access method 'S' or 'U). Please use the new SAPSprint tool or access method G. This note contains all information about the SAPSprint options.

For most options, it should generally not be necessary to change the default value. If you are in any doubt, please contact SAP Support.

Options that have a printer-specific identifier can also be overridden for individual printers. The printer-specific value only works if the global standard value has not been changed.

If, for example, the PortraitOnly global value is set to 1 (different to the default setting), you cannot use the landscape setting for an individual printer.

The syntax for printer-specific settings is generally:
<Value> = <Windows printer name>:<Parameter name> therefore for example
'HP Laserjet:PortraitOnly'


Solution

If possible, use the SAPSprint Options Editor that is available in the Windows Start menu as of SAPSprint Version 7.20 to change option values.

Alternatively, you can change the values by calling sapsprint from the command line with parameter -oi or -os. The parameter is case-sensitive.

Exact syntax:
'sapsprint -oi <key> <value>' for numbers or
'sapsprint -os <key> <value>' for character strings

Examples:
sapsprint -oi PortraitOnly 1
sapsprint -os SwinDataType EMF


The options in detail

Key: "LPDPort"
Default: 515
Effect: The value determines the TCP/IP port that SAPSprint listens to. 515 is the standard port for printing using the access methods 'S' and 'U'.
Key: "LogLevel"
Default: 1
Other values: 0, 5, 9
Effect: Determines the level of details in the log file.  If the value is 0, no log files are created.  If the value is 1, the situation should be normal in the live operation.  The value is 5 for troubleshooting by SAP Support.  The value is 9 only for special requests by SAP Support because a lot of information is written. It is not usually required.
Key: "LogPath"
Default: Subdirectory 'Logs' in the installation directory.
Other values: Any path for which the user (who is running the SAPSprint service) must have access authorization.
Effect: Path on which the print data and log files are saved.
Key: "OutputPath"
Default: Subdirectory 'Output' in the installation directory.
Other values: Any path for which the user (who is running the SAPSprint service) must have access authorization.
Effect: Path on which print data is saved, instead of printing it. Also see option "SaveAsFile".
Key: "SaveAsFile"
Default: 0
Other values: 1
Effect: Instead of sending the print data to a printer, the system saves the data as a file in the "OutputPath". This is particularly useful for downloading PDF spool requests.
Key: "UseOMSPrint"
Default: 0
Other values: 1
Effect: Can be activated to prevent the CreateDC problem (see Note 1069483) from occurring.
Key: "KeepFile"
Default: 0
Other values: 1
Effect: If the value is 0, the system deletes job-specific log files and print data after they are successfully printed.  They are retained if there are errors.  If the value is 1, job-specific log files and print data are retained even after they are sucessfully printed.
Key: "KeepRestoreFile"
Default: 0
Other values: 1
Effect: If the value is 0: After the restart, the system deletes the files in which the service saves the print jobs that are to be restarted again. They are retained if the value is 1. You must only set this option when requested by SAP Support for troubleshooting. (as of SAPSprint Version 1020)
Key: "KeepJobSequence"
Default: 0
Other values: 1
Effect: In rare cases, the sequence may be mixed up during receipt if sequential request processing is set for the printers with the jobs. Setting this option serializes the receipt of jobs. The problem does not occur if you set this option. You should set this option only if you require sequential processing because it slows down the receiving process. (as of SAPSprint Version 1023)
Key: SAPUserAsOwner
Default: 0
Other values: 1
Effect: If the parameter is set, the SAP user is displayed in the Windows printer queue (instead of the Windows user). (as of SAPSprint Version 1011) This is no longer supported as of Windows Vista and Windows Server 2008 (see Note 1276591).
Key: ProcessingMode
Default: 0  as of Version 1018: 1
Other values: 1
Effect: If the value is 0, a new thread is started for each print order; this thread is deleted again after processing. If the value is 1, a permanent work thread is started for each printer; this thread processes the jobs for this printer sequentially in accordance with the FIFO (First In, First Out) principle. (as of SAPSprint Version 1014)
Key: RestartAfterJobs
Default: 0
Other values: any number
Effect: The SAPSprint service restarts automatically after the specified number of print jobs. This mainly reduces the probability of the CreateDC problem described in Note 1069483 occuring. If the default value is set to 0, the service does not restart. (as of SAPSprint Version 1018)
Key: NoJobRestore
Default: 0
Other values: 1
Effect: As of SAPSprint Version 1018, all print jobs that already exist are restarted again when the service is restarted. You can prevent this behavior by setting the parameter to value 1. (as of SAPSprint Version 1018)
Key: NoPrinterLogging
Default: 0
Other values: 1
Effect: This prevents the printers that are installed from writing at the beginning of the log file. If many network printers are installed on a printer server, the service may not start if individual printers cannot be reached because a time limit was exceeded. (as of SAPSprint Version 1020)
Key: IgnoreDCError
Default: 0
Other values: 1
Effect: As of SAPSprint Version 1018, the service automatically restarts if the CreateDC problem described in Note 1069483 occurs. You can prevent this behavior by setting the parameter to value 1. (as of SAPSprint Version 1018)
Key: NoStatus [printer-specific]
Default: 0
Other values: 1
Effect: As of SAPSprint Version 1018, the job status of unrequested requests is retained when the service is restarted. If you deactivate the status request in the SAP system, this parameter should be set to 1 so that status information is not saved unnecessarily. (as of SAPSprint Version 1018)
Key: UseOldTitle
Default: 1
Other values: 0
Effect: With the value 1, the job name in the Windows printer queue corresponds to the old SAPLPD conventions. (as of SAPSprint Version 1018) Default is 1 as of SAPSprint Version 1023 (see Note 1276591).
Key: "PortraitOnly" [printer-specific]
Default: 0
Other values: 1
Effect: If the value is 1, you can only print in SAPSprint in portrait mode. This is useful to avoid printing in landscape mode on printers where landscape mode is very slow.

Key: "ColorMode"
Default: 1
Other values: 0, 2
Effect:
0 = use color only if supported by the printer
1 = always use color, even if the printer is b/w. Important: As a result, the printout may be unreadable.
2 = do not use colored print even if the printer supports color.

Key: "SWBackground" [printer-specific]
Default: 1
Other values: 0
Effect:
1 = if the color is deactivated (see "ColorMode"), then gray backgrounds or hatches are printed if a colored list is displayed.
0 = background is always white.

Key: "ColorBackgound" [printer-specific]
Default: 1
Other values: 0
Effect:
1 = if color is activated, print colored background (see "ColorMode")
0 = background is always white

Key: "GraphRahmenMode" [printer-specific]
Default: 0
Other values: 1, 2
Effect:
0 = print frame as lines
1 = print frame as (substitute) characters (+,-,|)
2 = do not print frame

Key: "WinCharSet"
Default: 0 (ANSI)
Other values: (you must enter the relevant number, and not the symbolic value, in the profile)
1 (DEFAULT): Derive font from font names. (for example, for OCR typefaces)
2 (SYMBOL): Use symbol character set
128 (SHIFTJIS): Japanese
129 (HANGEUL):
130 (JOHAB):
134 (GB2312):
136 (CHINESEBIG5):
161 (GREEK):
162 (TURKISH):
163 (VIETNAMESE):
177 (HEBREW):
178 (ARABIC):
204 (RUSSIAN):
222 (THAI):
238 (EASTEUROPE):

Key: "Language"
Default: "E",
Other values. "D"
Effect: Display all log messages in the selected language.

Key: "IconMode" [printer-specific]
Default: "IconsAsGraphics"
Other values: "IconsAsFont"
Effect:
"IconAsGraphic": All icons are printed as (colored) Bitmap (as in GUI)
"IconAsFont": The printable icons are taken from the "SAPIcons normal" font. Other icons are printed as '#'.

Key: "SAPDings_charset"
Default: SYMBOL_CHARSET (see "WinCharSet")

Key: "SAPIcons_charset"
Default: SYMBOL_CHARSET (see "WinCharSet")

Key: "use_old_fontsize" [printer-specific]
Default: 0
Other values: 1, 2, 3
Effect:
0 = use new calculation type for the font sizes (this is the same for Win3.1, Win95 and NT). In addition, this mode is compatible with other device types such as HPLJ4 and Postscript.
1, 3 = use previous (incorrect) calculation type so that you do not have to redefine SAPscript layout sets.
2, 3 = use old (incorrect) calculation type for font sizes that are derived from the horizontal DBI value. However, it is correct to use the vertical DPI value.

Key: "enable_phys_margins"
Default: 1
Other values: 0, 2
Effect:
1 = if required by the user, the physical paper boundaries are used for printing (see SAPWIN commands).
0 = the printable area of the relevant printer is always used even if you activate physical positioning for each command.
2 = physical positioning is always activated even if the command "logical" is required. The default remains "logical" (important for lists). Therefore, you must ensure that you make a switch. The switch also occurs if you use the "Baseline" command (eOCb).

Key: "no_empty_pages" [printer-specific]
Default: 1
Other values: 0
Effect:
1 = blank pages are not printed
0 = blank pages are also output.

Key: "NiReadTimeout"
Default: -1
Other values: -1, > 100
Effect:
-1 = the process is blocked until data arrives or a communication error is reported.
x = the maximum waiting period for the data is x. * 0.01 seconds. Other messages are then processed. Reading is repeated later (see "NiReadLoopBreak").

Key: "NiReadLoopBreak"
Default: -1
Other values: > 0
Effect:
-1 = the reading loop is not terminated until data arrives.
x = if no data has arrived, the reading loop (see "NiReadTimeout") is terminated with an error after x runs. Therefore, you have to wait "NiReadLoopBreak" * "NiReadTimeout" *0.01 seconds. After the system terminates, SAPsprint tries to reinitialise in order to reestablish connections.

Key: "NiWriteTimeout"
Default: 100 (bis 2.42) -1
Other values: -1, > 100
Effect:
-1 = no action until all data has been written.
x = if the writing process takes longer than x. * 0.01 seconds, the process terminates with an error.

Key: "NiAcceptTimeout"
Default: -1
Other values: > 0
Effect:
-1 = blocked until a connection has been reestablished.
x = waits x * 0.01 seconds to check whether there is a link or not. Then it continues processing print requests and returns to ACCEPT (see "NiReadLoopBreak").

Key: "ll_restart"
Default: 0
Other values: 1
Effect:
0 = no restart after read error
1 = SAPSprint restart after read error

Key: "NiSpinReadTime"
Default: 100
Other values: > 0
Effect:
Time in which you actively poll whether data arrived. You use "NiReadTimeout" to read data according to flow time.

Key: "report_unknown_status"
Default: 1
Other values: 0
Effect:
1 = unknown requests are confirmed as being incorrect. Requests are not recognized if SAPSprint was terminated before the status of the request was confirmed.
0 = report requests as finished.

Key: "s_packet_size"
Default: 15000
Other values: 20...15000
Effect: Size of the accepted data packets forcoupling method 'S'. (The system accepts packets with up to double the size.)

Key: "compress1"
Default: 1
Other values: 0
Effect:
1 = compression method '1' (run length coding) is supported. However, this is only used if you do not request a log of the data stream at the same time.
0 = use no compression.

Key: "compress2"
Default: 1
Other values: 0
Effect:
1 = compression method '2' (like SAPGUI) is supported (considerably better than method '1' ). However, it is only used if you do not request a log of the data stream at the same time. If method '1' and '2' are supported, SAP uses method 2 as of Release 3.0.
0 = Do not use method '2'.

Key: "crypt1"
Default: 1
Other values: 0
Effect:
1 = Data encryption is supported
0 = No encryption possible

Key: "COLXY" with X = 0..7, Y = {N,H,V [printer-specific]
           in accordance with the ABAP colors
           (N=normal, H=highlight/intensified, V=inverse)
Default:
COL0N=400,0,0,0,255,0
COLOH=700,0,0,0,255,0
COL0V=700,0,0,255,0,0 /* with activated background */
COL0V=700,0,0,0,255,0 /* with activated background */
COL1N=400,0,0,0,255,0
COL1H=700,0,0,0,240,0
COL1V=700,0,1,0,255,0
COL2N=400,0,0,0,255,0
COL2H=700,0,0,0,250,0
COL2V=700,0,0,0,255,0
COL3N=400,0,0,0,255,0
COL3H=700,0,0,0,255,0
COL3V=700,0,0,0,255,0
COL4N=400,0,0,0,250,0
COL4H=700,0,0,0,250,0
COL4V=700,0,0,0,255,0
COL5N=400,0,0,0,255,4
COL5H=700,0,0,0,255,4
COL5V=700,0,0,0,255,4
COL6N=400,0,0,0,255,6
COL6H=700,0,0,0,255,6
COL6V=700,0,0,0,255,6
COL7N=400,0,0,0,240,0
COL7H=400,1,0,0,240,0
COL7V=700,0,0,0,255,0
Other values: 0..999,0/1,0/1,0..255,0..255,0..6
Meaning: <Bold>,<Italic>,<Underline>,<Text>,<Background>,<Hatch>
<Bold> (0..999) typeface level (400 = normal, 700 = bold)
<Italic> (0/1) italic typeface
<Underline> (0/1) Underline
<Text> (0..255) grey tone for typeface (0 = black  255 = white)
<Background> (0..255) grey tone for background (0 = black, 255 = white)
<Hatch> (0..6) hatch for background
0 = no hatch
1 = /* - - - */
2 = /* ||||| */
3 = /* \\ */
4 = /* ///// */
5 = /* +++++ */
6 = /* xxxxx */

Key: "send_with_null" [port-specific]
Default: 1
Other values: 0
Effect:
0: Use the UNIX format for status responses. This is required for remote printer. With old SAP kernels, problems may occur with job requests.
1: Old format that is understood by all SAP releases but not UNIX.
The port-specific setting is made by adding <Portnummer> as the prefix:

Key: "transparent_bitmaps"
Default: 1
Other values: 0
Effect:
1: When you print TIFF graphics, white is interpreted as translucent. Because of this, the printing is compatible with other device types (for example, HPLJ4).
0: The graphic overwrites a background that may be available.
Icons are always printed as non-transparent, regardless of how the parameter is set.
For some printer types, graphics are either only black and white (no gradation) or completely unreadable. In this case, set the value to 0.

Key: "DcAllFields" [printer-specific]
Default: 0
Important: This parameter is required for some other settings. Therefore, as of SAPSprint Version 1007, the default value is set to 1.
Other values: 1
Effect:
If this parameter is set to 1, ALL settings that the relevant printer understands are re-sent after each change.

Key: "DcMode" [printer-specific]
Default: 0x0800
Other values: (Nearly) all, see below
Effect:
This parameter determines WHEN to send the control of
a) orientation portrait/landscape
b) paper size
c) duplex
d) tray
to the printer and WHICH commands will have to be repeated together with other commands.
The parameter is a 16-bit figure in the following format:
ttttaaabbbcccddd
The t-bits determine the sending time of the control commands. There are two procedures:
1. Only send a command when a parameter changes or always send it.
2. Send command immediately if changes occur or collect all commands and send them together at the next page break.
tttt = 0000    (former operation)
      0010    (only in case of parameter change + direct output)
       0100    (send always + direct)
       1000    (only in case of change + collect until page break)
       1100    (send always + collect until page break)
In each case, the following bits determine which commands must be repeated together with others (a-d see above). The 3 a-bits determine whether size (b) Bit 1, duplex (c) Bit 2, tray (d) Bit 3 are sent when setting the orientation.
For example: 0x0900 = 0000100100000000 (t=0000,a=100,b=100,c=000,d=000) means that, as opposed to the default setting (b=000), with the b=page size command, the a=Orientation command is always repeated as well.

Key: "print_spaces" [printer-specific]
Default: 0
Other values: 1
Effect:
If the value is 1, spaces are underlined for the default of a CPI value (single character positioning).

Key: "barcode_yshift"
Default: 50
Other values: all
Effect:
The barcode_yshift pixels shift the print position for barcodes down.

Key: "use_copies" [printer-specific]
Default: 0
Important: The default value was set to 1 from SAPSprint Version 1007 to 1022. Since this caused too many problems, the default value is set to 0 again as of Version 1023.
Other values: 1
Effect:
If the value is 1, the system transfers only one print output and the copy counter to the spool system rather than transferring a certain number of individual print outputs.

 

Key: "space_comp"
Default: 0
Other values: 1
Effect:
For a value of 1, characters that are double the width are issued in ABAP lists under Unicode and, if possible, many empty lines are subsequently suppressed so that a list appears as it did before.

Key: "snc_mode"
Default: 0
Other values: 1, 2
Effect:
0 = no security
1 = both
2 = only saved connections

Key: "snc_min_qop",
Default: 3
Other values: 1..2
Effect: minimal security level is set.
1 = auth
2 = signed
3 = sealed

Key: "snc_cmdmax"
Default: 10
Other values: 1..9
Effect: Number of commands that are allowed to be sent before the connection has to be secured.

Key: "NumAuth"
Default: 0
Other values: > 0
Effect: Number of entries in "AuthX"

Key: "AuthX"    X > 0
Default: ""
Other values: Name of partner who is to be accepted
Effect: If conn_aa = 0, only connections of partners who are listed here are accepted.

Key: "conn_aa"
Default: 0
Other values: 1
Effect:
0 = Only Partners stated with AuthX are accepted.
1 = Connections of all partners are accepted.

 

 


×