Using Laser Escape Sequences(SR D500-158345, SR D500-158352) [ HP ALLBASE/BRW Software Update Notice (A.01.50) ] MPE/iX 5.0 Documentation
HP ALLBASE/BRW Software Update Notice (A.01.50)
Using Laser Escape Sequences(SR D500-158345, SR D500-158352)
Laser escape sequences let you format your BRW reports using standard
printer commands for your printer. These commands include (but are not
limited to) font changes, underlining, paper source, and paper
orientation.
This feature was not described in the HP ALLBASE/BRW Reference Manual
for MPE/XL or in the HP ALLBASE/BRW Tutorial.
Related information about positioning and editing of items and text is
located on pages 7-17 through 7-25 of the Reference Manual. The new
feature can be used in the tutorial lessons in place of the underlining
feature described on page 3-28 of the HP ALLBASE/BRW Tutorial.
To define escape sequences:
1. Start BRWSETUP.
2. At the Define Escape Sequence Items screen you assign a name for
the escape item (for instance, "BOLD"). Escape sequence names
have the same syntax rules as item names or parameter names. They
have a maximum length of 19 characters.
_________________________________________________________________
The Define Escape Sequence Items screen is a new screen.
Information about this screen could be added near page 17-20 in
the HP ALLBASE/BRW Reference Manual.
_________________________________________________________________
3. Associate the item name with a value for the printer escape
sequence you want to use:
Enter special symbols by using the listed text:
Text Description
ESC escape code
SI shift in
SO shift out
# a place holder for a numeric code
To find the correct escape sequences for your printer, look in the
printer reference manual. For instance, for escape sequences for
the HP LaserJet III, see the LaserJet III Printer Technical
Reference Manual.
After defining the escape sequences in the Define Escape Sequence Items
screen, you can use them in any BRW report.
Setup and Reset Sequences
You can also assign escape sequences for the setup sequence and for the
reset sequence. The setup sequence is used before printing the first
line of the report (for instance, to change the page orientation). The
reset sequence is used after printing the last line of the report (for
instance, to return the page orientation to the default for other print
jobs).
To use escape sequences in a report:
1. Type the escape sequence name in the Item column of the Define
Lines screen. Prefix the name by an ampersand (&) as shown in the
example below:
_________________________________________________________________
The Define Lines screen is described on page 16-6 of the HP
ALLBASE/4GL Reference Manual. Using escape sequences in the
Item column is a new feature.
_________________________________________________________________
2. If you use an escape sequence that was defined with a # as a place
holder for a number, you supply the correct number in parentheses
as part of the item name in the Define Lines screen.
When you define a report, you can use different values for # by
adding a numeric parameter in parentheses in the Define Lines
screen.
In the following example, notice the item name, &TYPEFACE(6):
In the above example, the number 6 replaces the wildcard (#) in
the escape sequence TYPEFACE (ESC '(s#T').
3. Give the escape code a position, line, and length setting that
covers the text or item you want to affect by the code. In the
previous example, for instance, &TYPEFACE(6) and &BOLD are placed
so that they affect the title, CUSTOMER REPORT, on line 2. Escape
codes are designed so they can overlap other text or items.
After defining the escape sequences in the Define Escape Sequence Items
screen, you can use them in any BRW report.
Page Control Options
There are now three page control options for printing available on the
Request Report screen or the Define Selection screen.
CCTL Prints HP 3000 carriage control (CCTL) codes.
NO Does not print CCTL codes. If you choose this
option, BRW inserts an empty line in the printfile
for every line that must be skipped. The position
of a footer at the end of the page may be
unpredictable when you are mixing font and
character sizes.
LASER Best choice for printing to a laser printer. BRW
includes the ASCII code for Forms Feed (Hex 0cH) to
mark a new page. If a report has a page footer,
BRW pads the page with blank lines. However, if
the page has variable height lines, the number of
blank lines would vary and absolute placement of
the footer may be difficult.
To use the LASER option:
1. When you request the report, change the CCTL/NO/LASER field to
LASER by pressing the Prev Values or Next Values function keys.
2. Press Start Report.
This screen is described on page 16-65 of the HP ALLBASE/BRW Reference
Manual for MPE/XL. The functions described here are new.
MPE/iX 5.0 Documentation