Microsoft KB Archive/169892

= Host Print Transform Can Now Be Configured by SNA Server =

Article ID: 169892

Article Last Modified on 6/28/2004

-

APPLIES TO


 * Microsoft SNA Server 4.0

-



This article was previously published under Q169892





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 that this is 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 /?

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.

Keywords: kbbug kbfix kbnetwork KB169892

-

[mailto:TECHNET@MICROSOFT.COM Send feedback to Microsoft]

© Microsoft Corporation. All rights reserved.