RPM Text Banner Transform
Screenshots in this article are from RPM 7.0.
Adds a banner page at the beginning of the print stream.
Purpose
When you use a text banner page, the RPM text banner transform will load the page into memory, and replace string values in the file with the actual value of the print job metadata. For instance, if your banner file includes the text %user% then this transform will replace that with the actual value in the job metadata. On my machine that would produce “Dave”
One law firm used this function with RPM to generate thousands of PDFs for a customer. They used this function to include the document name and date in a computer-generated page before the actual document contents.
They reported to us that they used the text banner to get precisely what they wanted, and saved the customer hundreds of man-hours of manual collating.
Their workflow sequence was something like this:
- send the print job, a text file
- RPM creates the dynamic text banner ahead of the print job content
- RPM then converts to text markup and generates a PDF, which now has the text banner contents as page one
- RPM finally converted to PDF and archive to a network folder
Setup
- Banner Template (optional) Click Browse to locate a customized text banner page, or Clear to remove it. If blank, the default banner page will be printed.
Banner template replacement

If you configure a banner template file, the text banner transform reads the file, then replaces each of these variables with the job’s data. Type them in lowercase, exactly as shown.
| Variable | Replaced with |
|---|---|
%id% | RPM job ID |
%user% | user sent in the control file |
%host% | hostname specified by the LPR client |
%queue% | name of the queue processing the job |
%sequence% | queue sequence number |
%source-path% | name of the source file |
%job-path% | job name from the control file |
%title-path% | title from the control file |
%banner% | banner from the control file |
%class% | class from the control file |
%email% | email field from the control file |
%copies% | number of copies |
%format% | file format from the control file |
%indent% | indent from the control file |
%width% | width from the control file |
%size% | size of the job, in bytes |
%create-time% | date and time the job was created |
%print-time% | date and time the banner was printed |
%user-data% | user data (USRDTA) of an IBM i spooled file |
%capture-1%, %capture-2% | Capture 1 and Capture 2 from a Data Extraction rule |
If the job doesn’t have a value, RPM prints a placeholder instead, such as “Class not supplied”. %sequence%, %user-data% and the two captures print nothing.
Banner insert
If the template file is not specified, the transform generates a line for each item the job has, such as “User: " followed by the user, plus the queue name and the time it printed.
