[ Previous | Next | Contents | Search ]
3270 Host Connection Program 2.1 and 1.3.3 for AIX: Guide and Reference

e789pr Command


Initiates an HCON printer session.


Previously Defined Printer Session

e789pr SessionName-D Filename ]

Non-SNA Printer Session

e789pr -ASeconds-D Filename ]

LU1 Printer Session

e789pr -L Position ] [ -P Length ] [ -p Characters ] [ -U ] [ -D Filename ]

LU3 Printer Session

e789pr -A Seconds ] [ -E ] [ -L Position ] [ -U ] [ -D Filename ]


The Host Connection Program (HCON) e789pr command initiates 3286/87 printer emulation sessions. The e789pr command allows connection to an System/370 or System/390 host using one or more adapters. This command can be repeated to start more than one printer session.

The e789pr command provides 3286/87 emulation support by operating system printers that support PC-ASCII data stream. Standard SNA character string (SCS) and 3270 compatibility mode printer emulation are supported. To print in a DBCS environment requires a printer with field outlining capability.

Printer emulation is supported under these environments:

The following 3286/87 printer capabilities are not supported:


  1. The session error information is logged on a per session basis in a file:
    where * is the session short name.
  2. For non-SNA DFT sessions, the 3270 Connection Adapter must be configured with the printer session address using SMIT or the chdev command.
  3. Only HCON users can own sessions and use the e789pr command, since only HCON users can own sessions.


-D FileName Debug mode. Creates an HCON trace in the file FileName.


SessionName Specifies the name of the session to be initiated. The name must be an alphabetic character. Uppercase characters are treated as lowercase. The session name must refer to a session that has been previously defined using SMIT or the mkhcons command.

Non-SNA Flag

-A Seconds Specifies the duration of inactivity (in seconds) that the e789pr command waits before sending the received data to the printer. The timer is started on the receipt of the first chain of data. As long as data is received from the host, the e789pr command buffers the data and restarts the timer. When the time-out value reaches 0 seconds, the e789pr command submits the received data as one print job to the system spooler. This flag is only valid for non-SNA and Standalone LU 3 printer sessions. The default value is 10 seconds.


LU1 bases itself off of SCS data stream. This SCS data stream can contain special SCS control codes that set up the characteristics for the job being printed. The characteristics are:

Each of the LU1 SCS Control Code printer setups begin with the EBCDIC characters 0x2B.

The LU1 printer bases a job on the receipt of an End Bracket from the Host. When an End Bracket is received from the Host it is considered the end of the job and HCON will print the data that has been received from the Host. If no data exists to print then HCON just ignores the end bracket. An example of this condition is in the case of an MVS/TSO Host,. It will sometimes send the SCS Control codes, containing the Set Horizontal Format and Set Vertical Format in a single chain containing the Begin and End Bracket. Since NO printable data was contained in the Bracketing sequence, the setup that was given is held on to and the job is not printed (NO data to print). MVS/TSO then follows this bracketing sequence with the REAL data to be printed.

Note: HCON LU1 will also print a job if data is left to be printed and an UNBIND is received from the Host.
Printer Characteristics Default Values
Maximum printer position 80
Maximum page length 66 (this is the number of lines per page)
Top margin 1 (we specify on the qprt command -t (top_margin - 1)
Bottom margin Maximum page length
Left margin 1
Right margin Maximum printer position
Characters per inch 10
Lines per inch 6
Print quality 1 (this flag is not specified if SCS control code NOT received from the Host)

LU1 Flags

-L Position Specifies the maximum printer position and right margin (only values between 132 and 264 are valid). Default is 80.
-P Length Specifies the maximum page length and bottom margin. Default is 66.
-p Characters Specifies the number of character per inch. Default is 10.
-U Specifies to only print a job upon the receipt of an UNBIND and to ignore the request to print when receiving an End Bracket.
Note: The order of setting up the LU1 printer characteristics are as follows: Any time a value is set up using the SCS Control Codes it is used NO MATTER what, this overrides the defaults set up by HCON and the values specified by the above flags. If SCS Control Code values are not specified for a specific printer characteristic and the printer characteristic is settable by a flag or parameter on the e789 or e789pr command then that value is used, else the default values are used.

SCS Specific Control Code Values

                          Sets the maximum print position (PP), the left margin (LM), the right margin (RM) and the horizontal tab stops (T1 ... Tn, where n can be max. print pos. NN stands for the number of bytes following, including NN. An NN of 1 means take the defaults.
                          Sets the maximum page length (PL), the top margin (TM), the bottom margin (BM) and the vertical tab stops (T1 ... Tn, where n could be max. page len.) NN stands for the number of bytes following, including NN. An NN of 1 means take the defaults.
* SET_LINE_DENSITY ( 2B C6 NN LD ) Sets the lines per inch (LPI) or line density (LD). Valid values for LPI are 3, 4, 6, and 8. NN stands for the number of bytes following, including NN. An NN of 1 means take the defaults.
* SET_PRINT_DENSITY ( 2B D2 NN 29 00 VV ) Sets the characters printed per inch (CPI) (VV). Valid values for CPI are 10, 12, 15, and 17. NN stands for the number of bytes following, including NN. An NN of 1 means take the defaults. The only other valid value for NN is 4 which sets the CPI.
* PAGE_PRESENTATION_MEDIA ( 2B D2 NN 48 00 00 FC SD 00 00 Q 00 00 00 )
                          Sets the form control type (FC), the source drawer (SD), and the print quality (Q). Settings for FC and SD are no-ops and not used. Valid values for Q are 0, 1, 2, 3 and 255. NN stands for the number of bytes following, including NN. The only valid values for NN are from 02 to 0C (12). Takes the default when Q is 0 or 255


LU3 bases itself off of regular 3270 data stream. It prints data stream much like LU2 displays the data stream on the screen (terminal). Because LU3 prints data stream, it is NOT advised to print files using LU3, because if a file is greater than the screen size and the Host were to send a 3270 command, where the number of bytes is greater than a screen size, HCON will display a program check and not print the data.

LU3 HCON can control printing in one of 2 ways.

Default values for the printer characteristics are those that are set up in the definitions for the printer as defined on the RS/6000.

LU3 Flags

-A Seconds Specifies the number of seconds for the alarm. Default is 10.
-E Ignores the alarm timer method of controlling the print stream and uses instead the stop print bit or end bracket eject method.
-L Position Specifies a value greater than 132 for the column length. Model 5 is (27 x 132).
-U Ignores the alarm timer and allows printing only upon an unbind.

To suppress form feeds, set the environment variable QPRTZFLAG before you start the e789pr session. For example, set the environment variable to QPRTZFLAG=dummy .

This sets the -Z flag of the qprt command, called by e3789pr, to Z!.


To start a printer session, use the SMIT control menu option or enter:

e789pr a

The printer session is established in the background if it has been previously defined using SMIT or the mkhcons command.


/usr/bin/e789pr Contains the e789 command.
$HOME/hconerrors Contains HCON error messages.

Related Information

The 3270 Emulator, HCON Sessions and Session Profiles, HCON Utility Program Overview, and List of HCON Commands.

[ Previous | Next | Contents | Search ]