Initiates an HCON printer session.
e789pr SessionName [ -D Filename ]
e789pr -ASeconds [ -D Filename ]
e789pr [ -L Position ] [ -P Length ] [ -p Characters ] [ -U ] [ -D Filename ]
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:
hconprintlog.*where * is the session short name.
|-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.|
|-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|
|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)|
|-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.
|* SET_HORIZONTAL_FORMAT ( 2B C1 NN PP LM RM T1 ... Tn)|
|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.|
|* SET_VERTICAL_FORMAT ( 2B C2 NN PL TM BM T1 ... Tn )|
|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.
This means that HCON will set an alarm within the code that wakes up every specified amount of time (default is 10 seconds and is referred to as the "alarm" time) and checks the printer spool file for data. If data exists in the file (we have received printable data from the Host) HCON checks to see if the last time the file was written to is greater than the specified "alarm" time. If true then the job is printed, otherwise HCON will set the alarm back up again and wakes up after the specified time.
Default values for the printer characteristics are those that are set up in the definitions for the printer as defined on the RS/6000.
|-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:
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.|
The 3270 Emulator, HCON Sessions and Session Profiles, HCON Utility Program Overview, and List of HCON Commands.