DOCUMENT:Q169892 13-JUN-2001 [sna] TITLE :Host Print Transform Can Now Be Configured by SNA Server PRODUCT :Microsoft SNA Server PROD/VER:WINDOWS:3.0 SP1 OPER/SYS: KEYWORDS:kbnetwork ====================================================================== ------------------------------------------------------------------------------- The information in this article applies to: - Microsoft SNA Server, version 3.0 SP1 ------------------------------------------------------------------------------- SYMPTOMS ======== 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). STATUS ====== Microsoft has confirmed this to be a problem in the Microsoft products that are listed at the beginning of this article. 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 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 /?" (without the quotation marks) 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: ... ... /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. Additional query words: ====================================================================== Keywords : kbnetwork Technology : kbAudDeveloper kbSNAServSearch kbSNAServ300SP1 Version : WINDOWS:3.0 SP1 Issue type : kbbug Solution Type : kbfix ============================================================================= 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. Copyright Microsoft Corporation 2001.