A banner exit is an installation-written NCL procedure. The banner exit allows you to tailor the banner page printed at the front of the output for a print request. The banner exit is executed by the system before printing the output for a request.
It is passed information regarding the print request, and can pass back to the system the information that is to be printed on the banner page.
The variables passed to the banner exit by the system are as follows:
The user ID of the user who generated the print request.
The number of the print request.
The date the print request was generated in the format DD-MMM-YYYY.
The time the print request was generated in the format HH.MM.SS.
The variables the banner exit can set are as follows:
Must be set to the number of &$PSDATAn variables containing text that is to be printed on the banner page. The range is 1 to 999.
May be set to the line of text to be printed on the banner page. n must be in the range 1 to 999.
Indicates the number of lines to be advanced before printing the line of text specified in the corresponding &$PSDATAn variable. Valid values are 0, 1, 2, 3. The default is 1. n must be in the range 1 to 999.
Indicates whether the text specified in the corresponding &$PSDATAn variable is to be underlined. n must be in the range 1 to 999. Valid values are 1 and 2, where 1 specifies text excluding blanks between words is underlined, and 2 specifies the text including blanks between words is underlined.
Indicates where text specified in the corresponding &$PSDATAn variable is to be aligned. The variable n must be in the range 1 to 999. Valid values for this variable are LEFT, RIGHT, and CENTER. The line length used to align text is the value defined in the Columns per Page field (width), for the printer.
Indicates whether text specified in the corresponding &$PSDATAn variable is to be bolded. The variable n must be in the range 1 to 999. Valid values for this variable are NO and YES. The default is NO.
| Copyright © 2009 CA. All rights reserved. |
|