Tag Archives: winet

Types of Printing Used by Winet

Due to the variety of requirements in many user applications we provide various ways of handling the print job once it arrives in the Winet program on your PC. In most of our applications we support the following six methods of sending the print data to the Windows printer or another device:

  • GDIPrintingTypeGDI – Standard Windows printing
  • FilePrintingTypeFile – Redirect to a file and process
  • DirectPrintingTypeDirect – Print like DOS. Escape sequences possible.
  • LPRPrintingTypeLPR – Send to another PC or device running LPD
  • RTFPrintingTypeRTF – Data is a Rich Text Format file
  • Inet FormatPrintingTypeInet – Data contains Inet print sequences
  • MergePrintingTypeMerge – Use a template document (like mail merge)

GDIPrintingTypeGDI – Standard Windows printing

GDI (Graphics Device Interface/Independent) printing is the normal Windows printing. Inet sends the print data via the Windows printer driver for your selected printer to the Windows print spooler. If you use GDI printing you can select a font and a variety of properties like paper size, orientation, etc. if supported by your printer driver.

You are recommended to try GDI first. This is the method that should give the least problems. You may need to select a suitable font like Courier New with a size 8 to 10. You may manipulate large or stalledjobs from the Windows printer manager.

FilePrintingTypeFile – Redirect to a file and process

This method allows you to send data to a file on your disk. You may optionally specify an application to post-process the file immediately after it was received. (You may also redirect the data to a hardware port like LPT1 or COM2, but this is not recommended. Rather use the “Direct” method.)

Note for developers: File printing allows you to use any other (external third party) program to process print jobs.

DirectPrintingTypeDirect – Send to printer without changes made by printer driver

This is basically the same as old DOS printing. The printer’s default font will be used and no formatting is done in the PC. If you want to send your own printer escape sequences to the printer this is the recommended method. The data will go through the Windows spooler directly to the printer without modification as in the case with GDI printing.

Use this method if you want to send raw data to the printer. The format of the print job will depend on printer (physical device) – this is not Device Independent printing.
You may manipulate large or stalled jobs from the Windows printer manager.

Note: Some versions of the Generic Text printer driver do not give Windows enough control – especially when printing to a network printer. You may need to install a more intelligent driver even though you do not have such a printer.

Note: Some “host based” drivers for “Windows printers” do not allow old DOS printing. GDI and the other types of printing will work correctly, but for DirectPrintingTypeDirect you’ll need to find a driver that allows DOS printing directly to the printer port.

LPRPrintingTypeLPR – Send to another PC or device running LPD

If you do not have a local printer or if access to a shared Windows printer cause problems, you may use this option to redirect the printing to any other machine or network printer with an LPD print server. It is an effective method of redirecting print jobs with a very low impact on the network bandwidth. It also allows redirecting over multiple platforms or where the network shared printers fail work correctly.

RTFPrintingTypeRTF – Print the data as a Rich Text Format file

To enable you to print documents with rich formatted instructions from your mainframe, we support RTF. An RTF file must be generated by the mainframe application and sent as a print job. Inet will use a built-in RTF module to interpret the file and print it using standard Windows GDI printing like a word processor. You may also nominate MS Word (if installed) to handle the print job.

In the InetLPDHID_LPD_OVERVIEW print server you must define a new LPD printerLPDterms for RTF jobs and in the Inet3270 terminal emulator the settings for “RTF Host Printer” is used when a Natural file transfer is followed by a “PRINTRTF” commandFileTransNatural. (In Inet3270 the RTF printer settings are utilized when PRINTRTF is sent from the mainframe and with automated RTF detection for some of the 3287 data streams.)

In some cases Winet can automatically distinguish between normal text data and RTF, allowing the mainframe applications to gradually add RTF to selected reports while sending all reports to the same printer queue. The Inet3270 terminal emulator and the socket print server, InetPrintServerHID_PRINTSERVER_OVERVIEW, will look at the first 5 characters of the data to decide whether it is an RTF file or not. RTF files start with “{\rtf”. The host printer in InetVTx00 looks for an EscLegendAscii R as the first 2 characters inserted directly before the RTF file in the data stream.
See detail at RTF notes for developers of formatted printingPrintRTFDevNotes.

Inet FormatPrintingTypeInet – Data contains Inet Format Print sequences

Use this method for data that contains Inet Format Print proprietary escape sequences to improve formatting of print jobs.

Instead of sending printer escape sequences in your data (which depends on the make and model of the physical printer, i.e. Device Dependent); you may replace them with Inet sequences that will work on all Windows printers (Device Independent). This vastly simplifies the development of formatted printing on your applications by not introducing the complexity of RTF. In many cases it is a simple as modifying printer translation tables in your applications and you have formatted Device Independent printing!

Inet Format allows you to:

– Start text on any position on a page
– Write test at any slope
– Specify fonts, sizes and type faces

See detail at Inet Format escape sequences for developers of formatted printing PrintInetDevNotes.

MergePrintingTypeMerge – Data is merged with a template document

This is the easiest method to specify the full formatting of a report using a PC word processor. Two merge methods are available. This is the generic method where every line of data indicates one field in the template document. The template document is specified on the PC. Each line of data is restricted to the same text format.

The advanced merge method is under construction (December 2004) and will allow full programmable control from your server/mainframe application to specify various templates and fields as required.

See detail at Merge printing for developers of formatted printing PrintMergeDevNotes.

See also: Developer’s notes on formatted printingPrintingDevNotes.

The setup dialog boxes are described at:

GDI setupHIDD_GDI_PRN_SETUP
File setup HIDD_FILE_PRN_SETUP
Direct setup HIDD_DIRECT_PRN_SETUP
LPR setup HIDD_LPR_PRN_SETUP
RTF setup HIDD_RTF_PRN_SETUP
Inet Format setup HIDD_SGDI_PRN_SETUP
Merge setup HIDD_MERGE_PRN_SETUP

More at: Printing general informationPrintingGenInf.

GDI printing – Standard Windows printing

Default type. Graphics Device Interface/Independent printing is the normal Windows printing. With GDI printing you can select a font and a variety of properties like paper size, orientation, etc. if supported by your printer driver. You may need to select a suitable font like Courier New with a size 8 to 10. More at: GDI setupHIDD_GDI_PRN_SETUP and Printing general informationPrintingGenInf.

File printing – Redirect to a file and process

Send print data to a file on your disk. You may optionally specify an application to post-process the file immediately after it was received. More at: File setup HIDD_FILE_PRN_SETUP and Printing general informationPrintingGenInf.

Direct printing – Send to printer without changes made by printer driver

This is basically the same as old DOS printing. The printer’s default font will be used and no formatting is done in the PC. If you want to send your own printer escape sequences to the printer this is the recommended method. The data will go through the Windows spooler directly to the printer without modification as in the case with GDI printing. More at: Direct setup HIDD_DIRECT_PRN_SETUP and Printing general informationPrintingGenInf.

LPR printing – Send to another PC or device running LPD

Redirect printing to another machine or network printer with an LPD print server. It is an effective method of redirecting print jobs with a very low impact on the network bandwidth. It also allows redirecting over multiple platforms or where the network shared printers fail work correctly. More at: LPR setup HIDD_LPR_PRN_SETUP and Printing general informationPrintingGenInf.

Merge printing – Data is printed via a template

A merge template document in RTF is required on the PC. Fields in the merge document are replaced by the print data received from the server. More at: Merge setup HIDD_MERGE_PRN_SETUP and Merge printing for developers of formatted printing PrintMergeDevNotes.

RTF printing – Print the data as a Rich Text Format word processor file

An RTF file must be generated by the mainframe application and sent as a print job. Inet will use a built-in RTF module to interpret the file and print it using standard Windows GDI printing like a word processor. You may also nominate MS Word (if installed) to handle the print job. More at: RTF setup HIDD_RTF_PRN_SETUP and RTF notes for developers of formatted printingPrintRTFDevNotes.

Inet Format printing – Data contains Inet Format Print sequences

Use this method for that data contains Inet Format Print proprietary escape sequences to improve formatting of print jobs. Inet sequences will work on all Windows printers (Device Independent). More at: Inet Format setup HIDD_SGDI_PRN_SETUP and Inet Format escape sequences for developers of formatted printing PrintInetDevNotes.

Multiple Printer Configurations

(Which printer do I have to set up?)

Most Winet programs support multiple simultaneous definitions for printers or printer configurations to be used. This allows you to print to different physical printers or locations, or just to print with various settings to the same printer.

Note: Don’t become confused by the two “RTF” options used for “printer” or “type of printingPrintingTypes”. The RTF type of printingPrintingTypeRTF can be selected for any printer configuration. And for the RTF printer configuration you may select any type of printing.

The Winet terminal programs (E.g. InetVTx00 or Inet3270) support 5 printer configurations:

1. 80 Column Screen PrinterHID_SCREEN_PRINTER_SETUP configuration for screen prints while the terminal is in 80 column mode

2. 132 Column Screen PrinterHID_132SCREEN_PRINTER_SETUP configuration for screen prints while the terminal is in any other mode

3. 80 Column Host PrinterHID_1ST_HOST_PRINTER_SETUP configuration for data from the server/host (primary or default jobs, a.k.a. “slave-printer” or “back-printer” or “host printer 1”)

4. 132 Column Host PrinterHID_2ND_HOST_PRINTER_SETUP configuration for data from the server/host (secondary or compressed jobs indicated by escape sequences or modes, a.k.a. “host printer 2”)

5. “RTF Host PrinterHID_RTF_HOST_PRINTER_SETUP configuration for data from the server/host when RTF data is detected.

The Winet (socket or IP) Print Server program supports 2 printer configurations:

1. PrinterHID_PRN_SERV_PRINTER configuration for all non-RTF jobs

2. RTF PrinterHID_PRN_SERV_RTF_PRINTER configuration when RTF data is detected.
An unlimited number of printer configurations are available by using multiple configurationsTermConfiguration of the Print Server listening on different port numbers. See Setting up multiple ports on the InetPrintServerMultiPortSocketPrintServer.

The Winet LPD print server program supports an unlimited number of printer configurations: Each LPD printerLPDterms (queue name) has its own configuration.

See also some hints on configuring your 3287 printer3287printer.

More at:

Printing general informationPrintingGenInf and Printing method used by mainframe print jobs (Where do I change my printer settings?)PrintingMethod.

Printing

Printing is one of Winet’s strongest points. We supply both robust printing methods and highly configurable options to accommodate the widest variety of needs expressed by our clients. The printing is not a case of “one size fits all”. Therefore it would be very valuable for a system administrator or support person to read through this whole section.

  • No printer installed
  • Stand alone print servers:
    • LPD/LPR – Popular printing method (from the Unix world)
    • Print Server (Socket printing) – a.k.a. IP printing
    • 3287 printer3287printer – for session bound printing from an IBM mainframe
  • Developer’s notes on formatted printing
    • Merge printing for developers of formatted printing
    • RTF notes for developers of formatted printing
    • Inet Format escape sequences for developers of formatted printing

Terminal Type and Configuration

Explanation of Terms

Winet comes with seven (7) terminal emulation programs: VTx00, 3270, 5250, T27, Uts60, HP, D211 (not all of them will be unlocked by your licence file). We like to call these the 7 different families of terminal emulators. Each program can be loaded with a configuration to specify some settings for this family to more closely emulate a certain old hardware terminal or to fit function key requirements of a specific application on the mainframe (or Unix server host).

E.g.: InetVTx00 comes with configurations to emulate VT100, VT220, VT300, ANSI, SCO-ANSI and a Linux console.

The title bar (top blue bar) of each emulator will display first the name of the Inet terminal emulation program and next the name of the active configuration.

Mostly when we talk of terminal type, we refer to the string (name) passed by telnet to the remote host (mainframe, server or Unix box), telling it which terminal you are using. This name will affect what type of instructions the host will send to your terminal and what it will expect of your terminal. The terminal type is a string that identifies the model of the terminal. The terminal type is one of the settings saved in a configuration and you may change it as required.

Depending on your Unix (or other) host, you might want to set the terminal type to something like vt220, VT100, ansi, ANSI or sco-ansi or whatever. (Unix is case sensitive.) A few popular options are listed in the drop down box under the Setup | Telnet | Terminal Type option in your terminal emulator, but you may also manually edit the strings as required.

You can easily create your own custom configurations by using the File | Save As option in your terminal emulator. You may have an unlimited number of configurations for each terminal emulator on your PC, connecting to the same or to different hosts (mainframes).

The configuration is used as a key in the registry to store all the settings for the emulator. The configuration to use is specified with the /t=configuration command line option in each short cut.

See also: