Host Print Transform Can Now Be Configured by SNA Server

Last reviewed: March 19, 1998
Article ID: Q169892

The information in this article applies to:

Microsoft SNA Server version 3.0 Service Pack 1 (SP1)

SUMMARY

The existing 5250 print service only supports 5224 print devices. This article discusses several ways that you can use more advanced printing features, including the new functionality in Microsoft SNA Server version 3.0 Service Pack 2 (SP2).

MORE INFORMATION

If a print application requires more advanced printing features, (such as those supported by a 3812 printer) the AS/400 administrator can manually configure the printer device for Host Print Transform (HPT) on the AS/400. Because a 3812 device has more functionality than a 5224 device, some AS/400 applications that rely on 3812 functionality may experience reduction of functionality or even be unable to exercise any print function through a 5224 device.

Microsoft has extended the print server functionality to 3812 devices by enabling HPT through the startup of a passthrough session. In this case, SNA Print Service is relying on the AS/400 to format the print data. For an AS/400 system with V2R3 or a later OS, there is an additional field Q (0xd8) in the Program Initialization Parameters (PIP) that can be used to enable HPT support automatically. The Q field also allows you to configure a number of features that you can take advantage of in Microsoft SNA Server.

There is now a way for SNA Server Print Service to automatically enable and configure various Host Print Transform parameters using an updated version of the SNA Server 3.0 (post-sp1) command line utility Snacfg.exe. This is enabled by using the Q field (0xD8) in the PIP data inside the FMH-5 Attach message.

NOTE: Refer to the "Host Print Service and AS/400 Configuration" section of the SNA Server Service Pack 1 Release Notes if you want to manually enable Host Print Transform on the AS/400.

To see all of the Host Print Transform options, type:

   C:> SNACFG PRINTSESSIONONAPPC /?

The syntax of this command is:

   SNACFG PRINTSESSIONAPPC /LIST
   SNACFG PRINTSESSIONAPPC printsessionappcname
   SNACFG PRINTSESSIONAPPC printsessionappcname /PRINT
   SNACFG PRINTSESSIONAPPC printsessionappcname /ADD [options]
   SNACFG PRINTSESSIONAPPC printsessionappcname [options]
   SNACFG PRINTSESSIONAPPC printsessionappcname /DELETE

Available options are: ...

   <other options>

...

   /HOSTPRINTTRANSFORM:{ Yes | No }
   /FONTID:text
   /MSGQNAME:text
   /MSGLIBNAME:text
   /FORMFEED:{ Continuous | Cut | AutoCut }
   /HOSTPRINTERTYPE:text
   /PAPERSRC1:{ Default | Letter | Legal | Executive | A4 | A5 | B5 |
      CONT80 | CONT132 | None }
   /PAPERSRC2:{ Default | Letter | Legal | Executive | A4 | A5 | B5 | None
      }
   /ENVELOPESRC:{ Default | Monarch | NUM9 | NUM10 | B5 | C5 | DL | None }
   /CODEPAGE899:{ Yes | No }
   /SPECIALOBJ:text
   /SPECIALLIB:text
   /DEVICETYPE:{ 5224 | 3812 }

Features Supported by Additional Field Q in PIP Data

There are a number of features you can control through the Q field of the PIP, as listed below:

Host Print Transform - Enable Host Print Transform. The default is: YES.
Font ID - specify the Font Identifier used by 3812, 3816, and 5219, and IPDS printers. It can be 3-, 4-, and 5- digits. The user must check with the printer manual for this font number. The default is: 11.
Message Queue Name - Specify the name of the message queue to which device operational messages are sent. The default is: QSYSOPR.
Message Lib Name: Specify the name of the library where the message queue is located. The default is: *LIBL.
Form Feed - Specify Form Feed method. The default is: Continuous.
Printer Type and Model - The type and model of the printer driver rendering the job.
Paper Source 1 - Specify the size of the paper in Paper Source 1. The default is: 0x01 Letter.
Paper Source 2 - Specify the size of the paper in Paper Source 2. The default is: 0x01 Letter.
Envelope Source - Specify the size of the envelope. The default is: 0x0a (NUMBER10)
ASCII Code Page 899 Support - Specify whether the printer has Code Page 899 Installed. The default is: NO.
-. Customizing Library Name - This field is blank if a manufacturer Printer Type and Model are specified. The default is: BLANK.
Customizing Object Name - This field is blank if a manufacturer Printer Type and Model are specified. The default is: BLANK.
Device Type - The default is: 3812.

Configuration Parameters

Possible Values for Font ID: 1- 299

Possible values for Printer Type are found using the CHGDEVPRT command on the AS/400. An example would be *HP560C.

Supported AS/400 printers include the following:

   Compaq PageMaker 15 (HP Mode)
   Compaq PageMaker 20 (HP Mode)
   Epson ActionPrinter 2250
   Epson ActionPrinter 3250
   Epson ActionPrinter 5000
   Epson ActionPrinter 5500
   Epson DFX-5000
   Epson DFX-8000
   Epson FX-850
   Epson FX-870
   Epson FX-1170
   Epson LX-810
   Epson LQ-510
   Epson LQ-570
   Epson LQ-860
   Epson LQ-870
   Epson LQ-1070
   Epson LQ-1170
   Epson LQ-2550
   Epson SQ-870
   Epson SQ-1170
   Epson EPL-7000
   Epson EPL-8000
   HP LaserJet Series II
   HP LaserJet IID
   HP LaserJet IIP
   HP LaserJet III
   HP LaserJet IIID
   HP LaserJet IIIP
   HP LaserJet IIISI
   HP LaserJet 4
   HP LaserJet 310 (Black Printer Only)
   HP LaserJet 500
   HP LaserJet 520
   HP LaserJet 550C
   HP LaserJet 560C
   HP PaintJet
   HP PaintJet XL
   HP PaintJet XL 300
   IBM 2380 Personal Printer Series II
   IBM 2381 Personal Printer Series II
   IBM 2390 Personal Printer Series II
   IBM 2391 Personal Printer Series II
   IBM 3812 Pageprinter
   IBM 3816 Pageprinter
   IBM 3812 Page Printer (HP Mode)
   IBM 3816 Page Printer (HP Mode)
   IBM 39302 IBM 3930-02S Page Printer
   IBM 39302 IBM 3930-02D Page Printer
   IBM 39303 IBM 3930-03S Page Printer
   IBM 39303 IBM 3930-03D Page Printer
   IBM 4019 LaserPrinter
   IBM 4019 LaserPrinter (HP Mode)
   IBM 4019E LaserPrinter E
   IBM 4019E LaserPrinter E(HP Mode)
   IBM 4029-010 LaserPrinter 5E
   IBM 4029-010 LaserPrinter 5E(HP Mode)
   IBM 4029-020 LaserPrinter 6
   IBM 4029-020 LaserPrinter 6 (HP Mode)
   IBM 4029-030 LaserPrinter 10
   IBM 4029-030 LaserPrinter 10(HP Mode)
   IBM 4029-040 LaserPrinter 10L
   IBM 4029-040 LaserPrinter 10L(HP Mode)
   IBM 4037 5E Printer
   IBM  LaserPrinter 4039-10D (HP Mode)
   IBM  LaserPrinter 4039-10D Plus (HP Mode)
   IBM  LaserPrinter 4039-10R (HP Mode)
   IBM  LaserPrinter 4039-10R Plus(HP Mode)
   IBM  LaserPrinter 4039-12R (HP Mode)
   IBM  LaserPrinter 4039-12R Plus(HP Mode)
   IBM  LaserPrinter 4039-12L(HP Mode)
   IBM  LaserPrinter 4039-12L Plus(HP Mode)
   IBM  LaserPrinter 4039-16L(HP Mode)
   IBM  LaserPrinter 4039-16L Plus(HP Mode)
   IBM  4070 IJ
   IBM  4070 IJ(Epson Mode)
   IBM  4072 Execjet
   IBM  4072 Execjet* II Printer(HP Mode)
   IBM 4201-1 Proprinter
   IBM 4201-2 Proprinter II
   IBM 4201-3 Proprinter III
   IBM 4202-1 Proprinter Printer XL
   IBM 4202-2 Proprinter II XL
   IBM 4202-3 Proprinter III XL
   IBM 4207-1 Proprinter X24
   IBM 4207-2 Proprinter X24E
   IBM 4208-1 Proprinter XL24
   IBM 4208-2 Proprinter XL24E
   IBM 4212 Proprinter 24P
   IBM 4216-10 Personal  Pageprinter
   IBM 4226-302 Printer
   IBM 4230-4S3 Printer(IBM Mode)
   IBM 4230-413 Printer(IBM Mode)
   IBM 4232-302 Printer(IBM Mode)
   IBM 4712-1 Transaction Printer
   IBM 4712-2 Transaction Printer
   IBM 4722-1 Docoument Printer
   IBM 4712-2 Docoument Printer
   IBM 4770 InkJet Transaction Printer
   IBM 5152 Graphics Printer
   IBM 5201-2 QuietWriter
   IBM 5202-1 QuietWriter III
   IBM 5204-1 QuietWriter
   IBM 5216 WheelPrinter
   IBM 6408-A00 Printer (IBM Mode)
   IBM 6408-CTA Printer (IBM Mode)
   IBM 6412-A00 Printer (IBM Mode)
   IBM 6412-CTA Printer (IBM Mode)
   NEC P2 PinWriter
   NEC P2200 PinWriter
   NEC P2200XE PinWriter
   NEC P5200 PinWriter
   NEC P5300 PinWriter
   NEC P6200 PinWriter
   NEC P6300 PinWriter
   Okidata Microline 184 Turbo (IBM Mode)
   Okidata Microline 320 (IBM Mode)
   Okidata Microline 321 (IBM Mode)
   Okidata Microline 390 Plus (IBM Mode)
   Okidata Microline 391 Plus (IBM Mode)
   Okidata Microline 393 Plus (IBM Mode)
   Okidata Microline 590 (IBM Mode)
   Okidata Microline 591 (IBM Mode)
   Okidata OL400 LED Page Printer
   Okidata OL800 LED Page Printer
   Okidata OL810 LED Page Printer
   Okidata OL820 LED Page Printer
   Okidata Pace mark 3410
   Panasonic KX-P1123(Epson Mode)
   Panasonic KX-P1124(Epson Mode)
   Panasonic KX-P1124i(Epson Mode)
   Panasonic KX-P1180(Epson Mode)
   Panasonic KX-P1180i(Epson Mode)
   Panasonic KX-P1191(Epson Mode)
   Panasonic KX-P1624(Epson Mode)
   Panasonic KX-P1654(Epson Mode)
   Panasonic KX-P1695(Epson Mode)
   Panasonic KX-P2123(Epson Mode)
   Panasonic KX-P2124(Epson Mode)
   Panasonic KX-P2180(Epson Mode)
   Panasonic KX-P2624(Epson Mode)
   Panasonic KX-P4410(Epson Mode)
   Panasonic KX-P4420(Epson Mode)
   Panasonic KX-P4430(Epson Mode)
   Panasonic KX-P4450i(Epson Mode)
   Panasonic KX-P4451(Epson Mode)
   Xerox 4215/MRP(HP Mode)
   Xerox 4219/MRP(HP Mode)
   Xerox 4220/MRP(HP Mode)
   Xerox 4235 Laser Printing (HP Mode)
   Xerox 4700 II Color Document Printer (HP Mode)
   Select Customized Object
   Customizing Object  QWPDEFAULT
   Customizing Library  *LIBL

Possible Values for Paper Source 1

   Default    (0x00)
   Letter (8.5 x 11 inches)  (0x01)
   Legal (8.5 x 14 inches)  (0x02)
   Executive( 7.25 X 10.5 inches) (0x03)
   A4 (210 x 297 mm)  (0x04)
   A5 (148 x 210 mm)  (0x05)
   B5 (182 x 257 mm)  (0x06)
   Continuous Form ( 8.0 inches) (0x07)
   Continuous Form (13.2 inches) (0x08)
   None    (0xff)

Possible Values for Paper Source 2

   Default    (0x00)
   Letter (8.5 x 11 inches)  (0x01)
   Legal (8.5 x 14 inches)  (0x02)
   Executive( 7.25 X 10.5 inches) (0x03)
   A4 (210 x 297 mm)  (0x04)
   A5 (148 x 210 mm)  (0x05)
   B5 (182 x 257 mm)  (0x06)
   None    (0xff)

Possible Values for Envelope Source

   Default    (0x00)
   Monarch (3.875 x 7.5 inches) (0x06)
   Number 9 ( 3.875 x 8.875 inches) (0x09)
   Number 10 (4.125 x 9.5 inches) (0x0a)
   B5 (176 x 250 mm)  (0x0b)
   C5 (162 x 229 mm)  (0x0c)
   DL (110 x 220 mm)  (0x0d)
   None    (0xff)

Error Handling:

If the AS/400 target system is unable to supported the Q Field in the PIP data, or there is any error in the parameters, the 5250 print service will generate an event log and indicates inactive state for the corresponding service.

STATUS

This problem has been added in the latest SNA Server version 3.0 U.S. Service Pack. For information on obtaining this Service Pack, query on the following word in the Microsoft Knowledge Base (without the spaces):

   S E R V P A C K

Keywords          : prodsna kbfix3.00.sp2 kbnetwork
Version           : 3.0
Platform          : WINDOWS

================================================================================

THE INFORMATION PROVIDED IN THE MICROSOFT KNOWLEDGE BASE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. MICROSOFT DISCLAIMS ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL MICROSOFT CORPORATION OR ITS SUPPLIERS BE LIABLE FOR ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL, CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF MICROSOFT CORPORATION OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. SOME STATES DO NOT ALLOW THE EXCLUSION OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES SO THE FOREGOING LIMITATION MAY NOT APPLY.

Last reviewed: March 19, 1998
© 1998 Microsoft Corporation. All rights reserved. Terms of Use.