Skip to content

ABAP Keyword Documentation →  ABAP - Reference →  User Dialogs →  Classic Lists →  Spooling Lists →  Spool Parameters 

Setting Program-Driven Spool Parameters

Spool and archiving parameters can only be set in a program using the following function module: GET_PRINT_PARAMETERS. If the corresponding structure is changed directly and then the parameters in question used in NEW-PAGE PRINT ON or SUBMIT TO SAP-SPOOL, a runtime error occurs. The GET_PRINT_PARAMETERS function module can be used to execute the following functions:

  • Creating a complete set of spool and archiving parameters.
  • Determining the spool parameters that are currently valid during spooling
  • Changing individual spool parameters
  • Interactive querying of the spool parameters in the spool dialog box

The interface parameters for the function module are listed in Overview of All Spool Parameters.

The spool dialog box is displayed by default and can be switched off using the NO_DIALOG parameter. The values passed to the function module are used as the default values in the spool dialog box and can be overwritten there.

The function module gets all parameters that have not been set from the system, taking some values from the user master record. Dependent parameters are set automatically. If the function module is unable to generate a record with valid spool and archiving parameters, it generates an exception. The generated records are either complete or empty. The VALID export parameter (if the spool dialog box is being used) indicates whether or a complete record could be generated.

Other versions: 7.31 | 7.40 | 7.54


Notes

  • For GET_PRINT_PARAMETERS, the completeness of the parameter records and the run capability of the spool request are of primary importance. The function module does not carry out a complete consistency test like the spool dialog box. Consistency is only established in cases where it is significant for the run capability of the spool request. Inconsistent entries are partly ignored, partly replaced. For example:

  • The LINE_SIZE parameter or LINE_COUNT parameter can be used to set values that are not compatible with the LAYOUT parameter and lead to truncated output. Such inconsistencies are recognized in the spool dialog box.

  • Even if invalid values are passed to DESTINATION, it is still possible to set IMMEDIATELY to "X". The function module replaces the output device with a standard value (LP01) and initializes IMMEDIATELY. This causes the spool system to store the request using the settings that go with the default printer.

  • The GET_PRINT_PARAMETERS function module can be called multiple times consecutively. For example, the spool dialog box can be called at the start of a program if the user enters the basic setting. When it is called again, the parameter records created in this way can be passed collectively to the PRI_PARAMS and ARC_PARAMS import parameters of the function module and overwritten there. This enables the spooling of wide lists in landscape format or narrow lists in portrait format with otherwise unchanged settings.