New RPM 7 is now available — see what’s new →

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:

  1. send the print job, a text file
  2. RPM creates the dynamic text banner ahead of the print job content
  3. RPM then converts to text markup and generates a PDF, which now has the text banner contents as page one
  4. 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.

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.

VariableReplaced 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.

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.