Adding Banner Definitions
Reports can be printed with additional banners, which can be called dynamically by referring to the .BANNER property in the Report code.
The banner information can be customized by editing the Banner file. The Banner file to use can be set by using the comscript commands AddBannerIdFile or AddDefaultBanner of the Job Interface.
| The functions AddDefaultBanner, GetDefaultBanner, and SetDefaultPrintBanner are required to be configured altogether in order for a banner to display. |
When no Banner file has been set, the default Banner file should be named Banner.dat and should be placed in the root
of the Print Output folder as set in the Control Center.
When no Banner.dat is available, the banner will be filled through the default banner settings.
To create a custom banner file there are options available as listed in the table below.
In the file, every print definition must be preceded by one of the following specifications:
- H: in case the text has to be added in the heading of the print output.
- F: in case the text has to be added in the footing of the print output.
- B: in case the text has to be added in both the footing and the heading.
The letter specification (H/F/B) must be followed by a specification of the text that must be added in the
format:
H:Header text with <Option1> and <Option2> included in the text.
The following options are available:
| Option | Description | Default availability |
| AMTVERSION | Adds the AMT version number. | * |
| APPLICATION | Adds the name of the application. | * |
| BANNERID | Text will be printed as normal characters on the banner page. | |
| BANNERTEXT | Text will be printed in Big Characters on the banner page. | |
| CR | Adds a Carriage Return. | * |
| DESCRIPTION | Adds a description for the report. | * |
| ENDTIME | Adds the time when the Print File is closed using FREEOUTPUT. | |
| FF | Adds a Form Feed. | * |
| INITIATOR | Adds a specification for the station or session through which the report has been started | * |
| JOBTEXT | Adds extra information for the job. | |
| LF | Adds a Line Feed. | * |
| MAXLINES | Adds the maximum number of lines that can be printed per page according to the paper setting for the printer. | * |
| ONPRINTER | Adds the name of the printer that is used. | * |
| PAPERKIND | Adds the kind of paper that is specified for the printer. | * |
| PRINTBACKUP | Adds the name and location of the print backup file. | * |
| PRINTOUTPUT | Adds the print output specification. | * |
| PROCESS_ID | Adds the process id that has been given to the print task. | * |
| REPORTNAME | Adds the name of the report. | * |
| STARTTIME | Adds the start time of the job. | * |
| USER | Adds the name of the user account under which the job was started. | * |