Abstract

AFP-OSP-PSF ADD IPDS PASS THROUGH FUNCTION

Pre/Co-Requisite PTF / Fix List

   REQ   LICENSED  PTF/FIX
   TYPE  PROGRAM   NUMBER   LICENSED PROGRAM DESCRIPTION
   ----  --------  -------  -----------------------------------------------
   PRE   5763999   MF09268  OPERATING SYSTEM/400
   CO    5763SS1   SF24167  OPERATING SYSTEM/400
   CO    5763SS1   SF24144  OPERATING SYSTEM/400
   CO    5763SS1   SF24143  OPERATING SYSTEM/400
   CO    5763SS1   SF24142  OPERATING SYSTEM/400
   CO    5763SS1   SF24141  OPERATING SYSTEM/400
   CO    5763SS1   SF24139  OPERATING SYSTEM/400
   CO    5763SS1   SF24138  OPERATING SYSTEM/400
   CO    5763SS1   SF22115  OPERATING SYSTEM/400

APAR Error Description / Circumvention

DESCRIPTION OF PROBLEM FIXED FOR APAR SA44300 :
-----------------------------------------------
   Add IPDS Pass Through function.
 
 
CORRECTION FOR APAR SA44300 :
-----------------------------
 
    IPDS Pass Through is a performance enhancement be-
    ing added to PSF/400. Today, many appli-
    cations still generate an SCS or IPDS data stream
    when printing to an AFP printer. This is because:
 
    -   The customer is generating SCS or IPDS and
        they are a programmer-less shop or have a
        third party application and do not know which
        printer files to override or the printer file is
        already overridden within the application and
        is not easily changed.
 
    -   The customer is using an application such as
        OV/400, BGU, GDDM, or Virtual Print which does
        not support AFPDS.
 
    -   The customer has SCS and IPDS printers, but
        wants to continue to generate SCS to allow
        them to use their SCS printer as a backup in
        case the AFP printer is not available.  The
        OS/400 can do an SCS to IPDS to AFPDS trans-
        form but it can not do an AFPDS to SCS trans-
        form.
 
    The following describes the IPDS Pass Through sup-
    port:
 
    1.  Activation Instructions
 
        In order to configure PSF/400 for IPDS Pass
        Through, you will have to set the IPDSPASTHR
        value in a data area, following a specific
        format.  The PTF for APAR SA44304 supplies a program
        and CL command source which provides support for
        creating and modifying this data area.  Please
        read the cover letter for APAR SA44304 before in-
        stalling this PTF.  The CL command source
        code, which you can copy directly from the
        cover letter, is for a command called WRKAFP2.
        This cover letter will reference that command.
 
        The default for IPDS Pass Through is *NO.
 
    2.  When printing to an AFP printer, the following
        transforms are currently done:
 
        -   SCS data stream
 
            -   SCS to IPDS
 
            -   IPDS to AFPDS
 
            -   AFPDS to IPDS
 
        -   IPDS data stream
 
            -   IPDS to AFPDS
 
            -   AFPDS to IPDS
 
    3.  If IPDS Pass Through is specified by the user
        (at the device level via the WRKAFP2 command),
        then the following transforms would be done
        when printing to an AFP printer.
 
        -   SCS data stream
 
            - SCS to IPDS
 
        -   IPDS data stream
 
            - No transform done.
 
    4.  Not all SCS or IPDS spooled files are eligible for
        IPDS Pass Through.  They may contain special func-
        tions that require transform to AFPDS for cor-
        rect printing. Specifying IPDS Pass Through at
        the device level via the WRKAFP2 command al-
        lows only those spooled files eligible for IPDS
        Pass Through to bypass the extra transforms. Those
        spooled files not eligible for IPDS Pass Through will
        still undergo the transforms to AFPDS and back
        to IPDS.
 
        Spooled files that have the following data or
        print file attributes are not eligible for
        IPDS Pass Through.
 
        a.  SCS or IPDS data streams that contain IOCA
            or IM1 (image data).
 
        b.  For SCS or IPDS data streams, a front
            (FRONTOVL) or back (BACKOVL) overlay has
            been specified on the printer file..
 
        c.  For a SCS data stream, IGCDTA(*YES) has
            been specified on the printer file.
 
        d.  For SCS or IPDS data streams, you have
            specified multiup with TEXT(*NONE) on the
            printer file.
 
        If IPDS Pass Through is specified at the de-
        vice level via the WRKAFP2 command but the spooled
        file is not eligible for IPDS Pass Through, diag-
        nostic message PQT1011 will be issued and the
        spooled file will be transformed to AFPDS and
        back to IPDS.
 
    5.  IPDS Pass Through will not be valid for all
        PSF/400 supported printers. Any printer (or
        attachment) that does not support resident
        fonts can not support IPDS Pass Through. This
        is because the resident font references in the
        data stream must be mapped to host fonts which
        are downloaded to the printer. (The font mapping is
        only done during the AFPDS to IPDS conversion.) The
        following IPDS printers can support IPDS Pass Through
        (when AFP(*YES) is specified):
 
        -   3812 IPDS, 3816 IPDS, 3912, 3916, 3130
 
        -   3930, 3935, 4028, 4224, 4230, 4234, 4247
 
        -   6404, 6408, 6412
 
        -   3900-0W1 (PSF Direct and TCP/IP attachments)
 
        -   3900-Duplex Printing System (PSF Direct
            or TCP/IP attachments)
 
        -   3900-Wide Duplex Printing System (PSF Direct
            and TCP/IP attachments)
 
        The following IPDS printers can not support
        IPDS Pass Through (when AFP(*YES) is speci-
        fied):
 
        -   3820, 3825, 3827, 3828
 
        -   3829, 3831, 3835, 3900-001
 
        -   Any printer attached through PSF/2's DPF function
 
        When a print writer is started to an AFP(*YES)
        configured printer that does not support IPDS
        Pass Through and IPDSPASTHR(*YES) is specified
        at the device level via the WRKAFP2 command, a
        diagnostic message (PQT1010) will be issued
        stating that the IPDS Pass Through parameter
        is not supported for this printer and will be
        ignored.  The spooled file will be transformed
        to AFPDS and back to IPDS.
 
        Note:
 
           The PSF Direct function is available on PSF/2
           and PSF/6000.
 
           The Distributed Print Function (DPF) is
           provided by PSF/2.
 
    6.  The SCHEDULE(*IMMED) option on the printer file
        allows you to specify that the Print Writer
        (and PSF/400) should start processing an open
        spool file while your application is still
        processing and putting data into the spooled
        file.  Because all spooled files are not eligi-
        ble for IPDS Pass Through, OS/400 may not know
        at the start of a spooled file that has
        SCHEDULE(*IMMED) specified if it contains data
        that makes it ineligible for IPDS Pass
        Through.
 
        However SCHEDULE(*IMMED) along with Print
        While Convert and IPDS Pass Through are all
        performance enhancements. IPDS Pass Through
        will be valid for SCHEDULE(*IMMED) files.
        This allows you to get maximum benefit out of
        IPDS Pass Through. The draw back is that if
        the spooled file has image in it, the results
        will be unpredictable.  The results depend on the
        type of image and the printer's ability to handle
        that type of image.
 
    7.  Considerations for Printer Characteristics.
 
        The following describes the checking done be-
        tween printer functions supported and IPDS
        commands and values specified in the data
        stream.
 
        -   OS/400 checking
 
            -   Image processing. OS/400 will ensure
                that spooled files containing image are
                not eligible for IPDS Pass Through.
 
            -   DBCS spooled files. OS/400 will ensure
                that spooled files containing DBCS data
                are not eligible for IPDS Pass Through.
 
            -   Hardware multiup. OS/400 will ensure
                that spooled files that specify hardware
                multiup (MULTIUP and TEXT(*NONE)) are
                not eligible for IPDS pass through.
 
            -   Resident fonts. OS/400 will ensure
                that printers that do not support res-
                ident fonts are not eligible for IPDS
                Pass Through
 
        -   PSF/400 checking
 
            -   PSF/400 will not check if the follow-
                ing characteristics are supported by
                the printer. An error could be received
                from the printer if the IPDS Pass
                Through contained commands requesting
                this function and the printer does not
                support it. Note that the OS/400 will
                not generate this function themselves
                and the IPDS must have been generated
                by another application/system.
 
                --  Mark forms
 
            -   PSF/400 will check if the printer has
                disabled support for IPDS
                commands/values that the OS/400 does
                support.  A message will be issued by
                PSF/400 if the IPDS Pass Through con-
                tained commands requesting these func-
                tions and the printer has them
                disabled. The functions will be ignored
                or mapped to something that the
                printer supports.
 
                --  Jogging
                --  Duplex
                --  Input bins
 
            -   PSF/400 will not check to see if an
                input bin actually supports envelopes
                when an envelope bin is selected by
                the user.  If the printer supports the
                input bin number specified, the bin will
                be selected regardless of its attri-
                butes.
 
    If you encounter problems in this area, you must
    specify IPDSPASTHR(*NO).
 
    New / changed messages were added - these messages will print
    in upper case and in English only.
 
CIRCUMVENTION FOR APAR SA44300 :
--------------------------------
 
   None.

Activation Instructions

   If this PTF is applied or removed as a "Delayed" PTF, which
   requires an IPL, no special consideration is necessary.  If this
   PTF is applied or removed "Immediate", you must first end all of
   the printer writers or end the QSPL subsystem.  The PTF will be
   effective when the writers are started up again.

Special Instructions

   None.

Default Instructions

   THIS PTF CAN BE APPLIED IMMEDIATE OR DELAYED.

Supersedes

PTF/FIX NO(S).  APAR TITLE LINE
--------------  -----------------------------------------------------------
   SF23868      AFP-OSP-PSF CAN'T SCALE FONTS
   SF23868      AFP-OSP-PSF FIX PROBLEM WITH CP & IMBEDDED OCA WITH AN MCF
   SF23868      AFP-OSP SKIP OCA PROCESSING IF PREPROCESSING FOR COND PR.
   SF23868      AFP-OSP FUNCTION CHECK MCH1210
   SF23868      OSP-PSF-MSGPQT0014 SPOOL WRITER AUTHORITY PROBLEM USING AFP
   SF23382      AFP-PSF-OSP IOCA REP & TRIM CODE NOT FREEING STORAGE
   SF23122      AFP-PRT-MSGMCH0601 DURING AFP PRINTING
   SF22368      AFP-MSGPQT2431 8 UP NOT SUPPORTED MESSAGE, PRINTING SIMPLEX
   SF22368      OSP-OTHER-INCORROUT-PRT-D/T3935 THE SEPARATOR PAGE FOR A SPO
   SF22039      OSP PSF400 DOES NOT PRINT THE SAME AS OTHER PSF CODE
   SF22039      OSP-AFP-PRT-MSGPQT3675-MSGPQT3630-F/QSPWTREH-D/T3935 NACK OC
   SF21218      OSP-PRT-AFP MCH0603 RECEIVED BY QPQRMGR IN PDJ JOB
   SF21218      OFC-OFCPRT-MSGPQT2066 WRONG FONT USED
   SF21218      OSP-INCORROUT 300 PEL PRINTERS SUCH AS D/T4028 D/T3916 PRIN
   SF21218      OSP-AFP-INCORROUT-PRT DOUBLE BOLD PRINTOUT WITH CHARACTER SE
   SF21218      AFP OW01992 IO TO IM CONVERSION PROBLEM
   SF21218      AFP ROLLUP APAR OY58384 PTR BH00076

Summary Information

System................. AS/400
Models................. *ALL
Release................ V3R1M0
Recompile.............. N
Library................ QSYS
MRI Feature............ NONE