NEW-PAGE PRINT

NEW-PAGE

Additions:

7. ... PRINT ON ...
... DESTINATION dest
... COPIES cop
... LIST NAME name
... LIST DATASET dsn
... COVER TEXT text
... LIST AUTHORITY auth
... IMMEDIATELY flag
... KEEP IN SPOOL flag
... NEW LIST IDENTIFICATION flag
... DATASET EXPIRATION days
... LINE-COUNT line
... LINE-SIZE col
... LAYOUT layout
... SAP COVER PAGE mode
... RECEIVER rec
... DEPARTMENT dep
... ARCHIVE MODE armode
... ARCHIVE PARAMETERS arparams
... NEW-SECTION
... NO DIALOG

8. ... PRINT ON ...
... PARAMETERS params
... ARCHIVE PARAMETERS arparams
... NEW-SECTION
... NO DIALOG

9. ... PRINT OFF


... DESTINATION dest (Output device)
... COPIES cop (Number of copies printed)
... LIST NAME name (Name of the list)
... LIST DATASET dsn (Name of the spool dataset)
... COVER TEXT text (Title of the spool request)
... LIST AUTHORITY auth (Authorization required
for display)
... IMMEDIATELY flag (Print immediately?)
... KEEP IN SPOOL flag (Keep list after
printing?)
... NEW LIST IDENTIFICATION flag (New spool request?)
... DATASET EXPIRATION days (Keep the list for
days days)
... LINE-COUNT line (line lines per
page)
... LINE-SIZE col (col columns
per line)
... LAYOUT layout (Print layout)
... SAP COVER PAGE mode (Print SAP cover sheet?)
... RECEIVER user (SAP user name of
recipient)
... DEPARTMENT dep (Name of department)
... ARCHIVE MODE armode (Archiving mode)
... ARCHIVE PARAMETERS arparams (Structure with achiving
parameters)
... NEW-SECTION (Start of a new section)
... NO DIALOG (Omit print control screen)

In the case of the IMMEDIATELY, KEEP IN SPOOL and NEW LIST IDENTIFICATION parameters, the flag must be a literal or character field of length 1. If the flag contains a blank value, the parameter is switched off. Any other character switches the parameter on. Any of the sub-parameters for PRINT ON can be omitted. The specification mode for SAP COVER PAGE can take any of the values ' ', 'X' and 'D'. These values have the following meanings:

' ' : Do not output cover sheet.
'X' : Output cover sheet.
'D' : Printer setting determines whether cover sheet is printed.

The specification armode for ARCHIVE MODE can take any of the values '1', '2' and '3'. These values have the following meanings:

'1' : Print only.
'2' : Archive only.
'3' : Print and archive.

The specification arparams for ARCHIVE PARAMETERS must have the structure of ARC_PARAMS . This parameter should be edited only using the function module GET_PRINT_PARAMETERS.


All WRITE statements (similarly SKIP, ULINE, ...) from the new page onwards are interpreted as printer instructions (see Printing in ABAP). Before the first page is printed, the user sees a screen for determining the print parameters, provided NO DIALOG was not specified. The values defined in NEW-PAGE PRINT ON for LINE-SIZE and LINE-COUNT are used by this screen. Default values are also available if no others exist. The specifications for LINE-COUNT and LINE-SIZE in the report header have no meaning here. The various print parameters can be used to propose or (in the case of NO DIALOG) determine the other additions. If you use NEW-SECTION, the page numbering is set back to 1. If printing is currently in progress, the current spool request is closed. If the newly specified print parameters are compatible with the previously specified print parameters, the new spool request is added to the end of the request just closed.

Records cannot be placed in the spool across events (AT LINE-SELECTION, AT PFx, AT USER-COMMAND)! In this case, a new NEW-PAGE PRINT OFF statement (see addition 8) is executed, even if it is not programmed!


... PARAMETERS params (Structure with print
parameters)
... ARCHIVE PARAMETERS arparams (Structure with archiving
parameters)
... NEW-SECTION (Start of a new section)
... NO DIALOG (Omits print control
screen)

All WRITE statements (similarly SKIP, ULINE, ...) from the new page onwards are interpreted as printer instructions (see Printing in ABAP). Before the first page is printed, the user sees a screen for determining the print parameters, provided NO DIALOG was not specified. The print parameters are passed via the field string params which must have the same structure as PRI_PARAMS . The field string can be filled and modified with the function module GET_PRINT_PARAMETERS. The specification arparams for ARCHIVE PARAMETERS must have the same structure as ARC_PARAMS. This parameter should only be edited with the function module GET_PRINT_PARAMETERS. See addition 7 for information on the meaning of NEW-SECTION

Records cannot be placed in the spool across events (AT LINE-SELECTION, AT PFx, AT USER-COMMAND)! In this case, a new NEW-PAGE PRINT OFF statement (see addition 8) is be executed, even if it is not programmed!

Example

* Printing without archiving 
 
DATA PARAMS LIKE PRI_PARAMS. 
 
DATA: DAYS(1)  TYPE N VALUE 2, 
	COUNT(3) TYPE N VALUE 1, 
	VALID	TYPE C. 
 
CALL FUNCTION 'GET_PRINT_PARAMETERS' 
  EXPORTING DESTINATION		 = 'LT50' 
			COPIES				= COUNT 
			LIST_NAME			 = 'TEST' 
			LIST_TEXT			 = 'Test NEW-PAGE PRINT ON' 
			IMMEDIATELY		 = 'X' 
			RELEASE			 = 'X' 
			NEW_LIST_ID		 = 'X' 
			EXPIRATION			= DAYS 
			LINE_SIZE			 = 79 
			LINE_COUNT			= 23 
			LAYOUT				= 'X_PAPER' 
			SAP_COVER_PAGE		= 'X' 
			RECEIVER			= 'SAP*' 
			DEPARTMENT			= 'System' 
			NO_DIALOG			 = ' ' 
  IMPORTING OUT_PARAMETERS		= PARAMS 
			VALID				 = VALID. 
 
IF VALID <> SPACE. 
  NEW-PAGE PRINT ON PARAMETERS PARAMS NO DIALOG. 
 
  WRITE / 'First line'. 
ENDIF. 

Example

* Printing with archiving 
 
DATA: PARAMS   LIKE PRI_PARAMS, 
	ARPARAMS LIKE ARC_PARAMS, 
	DAYS(1)  TYPE N VALUE 2, 
	COUNT(3) TYPE N VALUE 1, 
	VALID	TYPE C. 
 
CALL FUNCTION 'GET_PRINT_PARAMETERS' 
  EXPORTING DESTINATION			= 'LT50' 
			COPIES				 = COUNT 
			LIST_NAME			= 'TEST' 
			LIST_TEXT			= 'Test NEW-PAGE PRINT ON' 
			IMMEDIATELY			= 'X' 
			RELEASE				= 'X' 
			NEW_LIST_ID			= 'X' 
			EXPIRATION			 = DAYS 
			LINE_SIZE			= 79 
			LINE_COUNT			 = 23 
			LAYOUT				 = 'X_PAPER' 
			SAP_COVER_PAGE		 = 'X' 
			RECEIVER			 = 'SAP*' 
			DEPARTMENT			 = 'System' 
			SAP_OBJECT			 = 'RS' 
			AR_OBJECT			= 'TEST' 
			ARCHIVE_ID			 = 'XX' 
			ARCHIVE_INFO		 = 'III' 
			ARCHIVE_TEXT		 = 'Description' 
			NO_DIALOG			= ' ' 
  IMPORTING OUT_PARAMETERS		 = PARAMS 
			OUT_ARCHIVE_PARAMETERS = ARPARAMS 
			VALID				= VALID. 
 
IF VALID <> SPACE. 
  NEW-PAGE PRINT ON PARAMETERS PARAMS 
					ARCHIVE PARAMETERS ARPARAMS 
		 NO DIALOG. 
  WRITE / 'First line'. 
ENDIF. 
 
From the new page onwards, all WRITE statements are again output to the screen. The completed page is output to the spool file.