PTF#:

SF24138 - OPERATING SYSTEM/400

Licensed Program:

5763SS1

APAR Fixed:

SA44298

Release:

310

Abstract

AFP-OSP-PSF-TCPIP ADD TCP/IP SUPPORT TO PSF/400

Pre/Co-Requisite PTF / Fix List


   REQ   LICENSED  PTF/FIX
   TYPE  PROGRAM   NUMBER   LICENSED PROGRAM DESCRIPTION
   ----  --------  -------  -----------------------------------------------
   PRE   5763999   MF09268  OPERATING SYSTEM/400
   PRE   5763SS1   SF20877  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   SF24140  OPERATING SYSTEM/400
   CO    5763SS1   SF24139  OPERATING SYSTEM/400
   CO    5763SS1   SF21489  OPERATING SYSTEM/400


APAR Error Description / Circumvention


DESCRIPTION OF PROBLEM FIXED FOR APAR SA44298 :
-----------------------------------------------
   Add TCP/IP support for the IBM Print Services Facility for
   OS/400.
 
 
CORRECTION FOR APAR SA44298 :
-----------------------------
   See the special instructions section of this cover letter for
   details.
 
CIRCUMVENTION FOR APAR SA44298 :
--------------------------------
 
   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


      Install this PTF if you use or are planning to use
      Print Services Facility/400 (PSF/400) and want to attach
      IBM's IPDS printers on a TCP/IP Token Ring or Ethernet LAN.
 
      This cover letter provides the following information:
 
        1. Printers supported on a TCP/IP connection
        2. How to configure PSF/400 for a TCP/IP connection
        3. What to do before printing
        4. Important notes
        5. Problem Determination
 
 
      1. Printers supported on a TCP/IP connection
      --------------------------------------------
        a. Any printer which uses the IBM AFCCU (Advanced Function
           Common Control Unit):
 
           - 3130 using microcode level 2.35 or greater.
           - 3935 using microcode level 3.11 or greater.
           - 3900-0W1 using microcode level 6.1 or greater.
           - 3900 0W3 using microcode level 6.1 or greater.
           - 3900 Duplex D01/D02 using microcode level 6.1 or greater.
           - 3900 Wide Duplex DW1/DW2 using microcode level 6.1 or
             greater.
 
          These printers can be attached to AS/400 using either Token
          Ring or Ethernet connections.
 
          Performance is a consideration when attaching a 3900.
          The combination of AS/400 hardware and your application
          needs are factors to be considered when evaluating the
          ability of your AS/400 to take advantage of the high
          printing speeds available with a 3900. Information on
          performance will be available later from your IBM Printing
          Systems Company representative or AS/400 remarketer.
 
        b. Any IPDS printer which can be attached using the i-data
           7913 Printer LAN Attachment:
 
           - 3112
           - 3116
           - 3812
           - 3816
           - 3912
           - 3916
           - 3930
           - 4028
           - 4230
 
          Both the Twinaxial and Coaxial versions of these printers
          are supported.
 
          The 7913 may be attached using either Token Ring or Ethernet
          connections.
 
          The 7913 requires the use of a BOOTP server in order that
          it may be configured and receive microcode updates. AS/400
          does not provide the BOOTP function. This means that either:
 
            - Your network must have a BOOTP server, or
            - You configure the 7913 in a network outside your AS/400
              network for use within your AS/400 network.
 
          The Installation Guide for the 7913 contains the necessary
          configuration information for configuring a 7913 either
          within your network or outside of your network.
 
          When this cover letter uses the term printer, that refers
          to either an AFCCU printer or a printer attached to the
          7913 Printer LAN Attachment.
 
 
      2. How to configure PSF/400 for a TCP/IP connection
      ---------------------------------------------------
         In order to configure PSF/400 for TCP/IP, the PTF for APAR
         SA44304 must be applied. The cover letter for that PTF
         discusses CL command WRKAFP2, which lets you provide TCP/IP
         configuration information for use by PSF/400. Please read
         that cover letter before installing this PTF.
 
         Described below are the steps required for using the TCP/IP
         support provided by PSF/400.
 
         1. Create a Token Ring (CRTLINTRN) or Ethernet (CRTLINETH)
            line description, if you do not already have one defined
            on your system.
 
         2. Create a TCP/IP interface (ADDTCPIFC) for the line
            description, if you do not already have one defined.
 
            For information on configuring AS/400 for TCP/IP, please
            refer to "AS/400 TCP/IP Configuration and Reference",
            SC41-3420.
 
         3. Create a printer device description. Shown below is an
            example. Comments on some of the parameters are
            discussed after the example.
 
            CRTDEVPRT DEVD(PRT3130)
                      DEVCLS(*RMT)
                      TYPE(*IPDS)
                      MODEL(0)
                      AFP(*YES)
                      AFPATTACH(*APPC)
                      FONT(11)
                      FORMFEED(*AUTOCUT)
                      RMTLOCNAME(TCPIP)
                      TEXT('Using TCP/IP support')
 
            DEVCLS     - *RMT is required
            TYPE       - *IPDS is required
            MODEL      - 0 is required
            AFP        - *YES is required
            AFPATTACH  - *APPC is required
            FONT       - A value appropriate for your environment
                         is required.
            FORMFEED   - A value appropriate for your printer is
                         required.
            RMTLOCNAME - Use any name that will not be used as a
                         remote location name in your network.
 
            Note that you are configuring a printer device
            description as if an APPC attachment is to be used. The
            next step shows how to specify the TCP/IP-required
            configuration information for use by PSF/400.
 
         4. Use WRKAFP2 to create a data area which contains TCP/IP
            configuration values. Shown below is an example which may
            be used for an AFCCU printer (3130, 3900 or 3935) or a
            7913.
 
            Configuration Example
            ---------------------

 
            WRKAFP2 DEVD(PRT3130)
                    TCPIP(*YES)
                    RMTSYS('9.99.25.128')
                    PORT(5001)
                    ACTTMR(170)
                    INACTTMR(*NOMAX)
 
            DEVD     - This value must match DEVD in the printer
                       device description.
 
            TCPIP    - This value must be set to *YES.
 
            RMTSYS   - An IP address or a host name may be used
                       for this parameter. In this example, an IP
                       address is used.
 
                       If you are using an AFCCU printer, the
                       printer requires an IP address for its IP
                       address parameter. The IP address specified
                       in WRKAFP2's RMTSYS parameter, or the IP
                       address represented by the host name, must
                       match that specified at the printer.
 
                       If you are using a 7913, the device requires an
                       IP address for the ip parameter in the BOOTPTAB
                       file. The IP address specified in WRKAFP2's
                       RMTSYS parameter, or the IP address represented
                       by the host name, must match that specified in
                       the BOOTPTAB file.
 
            PORT     - If you are using an AFCCU printer, this value
                       must match the value used for the AFCCU's TCP
                       port parameter.
 
                       If you are using a 7913, this value must be
                       set to 5001. The 7913 cannot be configured for
                       a different port number.
 
            ACTTMR   - This value specifies the number of seconds
                       PSF/400 will wait for the AFCCU to respond to
                       an activation request. (An activation request
                       occurs when PSF attempts to make a connection
                       with the printer.) If the printer does not
                       respond within this time, PSF/400 terminates.
 
                       If you wish to have more than one AS/400 share
                       a printer, then set this value to *NOMAX.
                       ACTTMR(*NOMAX) means that PSF/400 will wait
                       as long as possible to establish a connection
                       with a printer. The printer may not be
                       available because another PSF/400, PSF/2 or
                       PSF/6000 may be using the printer.
 
            INACTTMR - This value specifies the length of time PSF/400
                       will maintain a session with the printer
                       while there are no spooled files with a status
                       of RDY. A value of *NOMAX means PSF/400 will
                       not release the connection to the printer until
                       you enter ENDWTR. If you wish to have PSF/400
                       share this printer with another PSF/400, PSF/2
                       or PSF/6000, use a value that is appropriate
                       for your environment.
 
         5. Configure the printer. If a 7913 is being used, make
            certain it has been configured for your use in your
            network.
 
 
      3. What to do before printing
      -----------------------------
      This section describes the steps to verify that PSF/400 will be
      able to connect to the printer.
 
        1. Vary on the line description, VRYCFG CFGTYPE(*LIN), to be
           used, if it is not already varied on.
        2. Vary on the printer device description,
           VRYCFG CFGTYPE(*DEV), to be used, if it is not already
           active.
        3. Make the TCP/IP interface to be used active, if it is not
           already active.
        4. If you are using an AFCCU printer, make it ready.
           If you are using a 7913, make certain it has been
           successfully booted and that the printer attached to it
           is ready.
        5. Issue the PING command to verify that the printer or 7913
           can be contacted from your AS/400. Using the IP address
           from the above example, you would enter
               PING RMTSYS('9.99.12.128')
           If the device cannot be PINGed, then you may have a
           configuration error, a network problem (such as a
           duplicate IP address) or a hardware error (cable, etc.).
        6. After the device has been successfully PINGed, you may
           start PSF/400 using the STRPRTWTR command.
 
      If you are using a 7913, test the connection between the 7913
      and the printer. You do this after the printer has been
      configured, cabled to the 7913 and made ready. Press the TEST
      key on the 7913. A test page containing 7913 configuration
      information will print out on the printer if the connection is
      good.
 
 
      4. Important notes
      ------------------
        a. If your environment has a need to make certain that a
           TCP/IP-attached device has not been powered off, you may
           use the TCP keep alive parameter in CHGTCPA. The value
           used for this parameter determines how long PSF/400 will
           wait for a response from a device before terminating.
 
        b. If you are using a 3900 with the AFCCU, you must set
           PRTRQSTMR in the printer device description to a value

           other than *NOMAX. PRTRQSTMR(*NOMAX) can prevent PSF/400
           from detecting that the last spooled file processed has
           printed. PSF/400 will not release a connection if a file
           has not printed, unless you execute ENDWTR *IMMED or
           perform an NPRO (Non Process Run Out) at the printer.
 
        c. Printer sharing.
           PSF/400 may share an AFCCU printer with PSF/2 and PSF/6000.
           AFCCU printers permit a maximum of 3 PSFs to share a
           printer when TCP/IP is used. You may have 3 AS/400s
           sharing an AFCCU printer.
 
           PSF/400 may share a 7913-attached printer with PSF/2 and
           PSF/6000. A 7913 permits a maximum of 2 PSFs to share the
           device. You may have 2 AS/400s sharing a 7913-attached
           printer.
 
        d. PSF/400 will automatically update message file
           QSYS/QPQMSGF and alert table QSYS/QPQMSGF with new
           messages. Messages will be updated with English text and be
           in upper case. New inquiry messages will require a reply in
           upper case.
 
        e. Are you connecting a Twinaxial printer to an i-data 7913
           Printer LAN Attachment? If so, please take note of the
           following:
 
           1. The printer must be configured for station address 0.
 
           2. The printer's CANCEL button is ignored by the 7913. This
              means that you cannot cancel the printing of a spooled
              file at the printer. You can hold a spooled file if it
              has a status of PND or WTR. All pages in the printer's
              buffer will be printed.
 
              This restriction does not apply to Coaxial printers.
 
           3. Specific notification for conditions requiring operator
              assistance is not supported by the i-data 7913 for
              Twinaxial printers. Instead, PSF/400 will issue
              informational message PQT3825: Operator action is
              required on device nnn. These conditions include end of
              forms and paper jam.
 
              This condition does not apply to Coaxial printers.
 
        f. For performance purposes, PSF/400 uses the setsockopt
           socket function to set the size of the TCP send buffer
           used by PSF to 32768. This value is not configurable.
 
        g. MTU sizes.
           When configuring for a printer using the AFCCU, best
           performance is obtained by configuring both AS/400 and the
           printer for as large an MTU as possible. Configure the
           printer for an MTU of 4096. If you are using a 4M Token
           Ring line, configure the MAXFRAME parameter in the line
           description and the MTU in the corresponding TCP/IP
           interface for 4060. If you are using a 16M Token Ring line,
           you may set the MAXFRAME and MTU for 4096.
 
           If you are using an Ethernet line, the largest MTU
           configurable is 1496. You may configure the printer's MTU
           for this size or larger. The smaller of the two values
           is used by TCP/IP.
 
           The 7913 supports a maximum MTU of 1440. This value cannot
           be modified. If the TCP/IP interface for your AS/400 is
           configured for an MTU greater than 1440, TCP/IP uses the
           smaller of the two values.
 
           If data from your AS/400 goes through one or more routers
           to get to a printer, OS/400 TCP support will use an MTU of
           576. An MTU of this size may negatively impact printer
           performance.
 
        h. If you power a 7913 off and then on, you must also power
           the attached printer off and then on. The printer may be
           powered off and on without the 7913 being powered off and
           on.
 
        i. Twinaxial printers attached with a local workstation
           controller can be powered off and then on while a writer
           is in-between spooled files. You may not do this when a
           Twinaxial or Coaxial printer is attached to a 7913. If you
           must power off the printer, end PSF/400 (ENDWTR) before
           powering off the printer.
 
 
      5. Problem determination
      ------------------------
      This section describes some error situations that may occur
      when you are preparing to use PSF/400's TCP/IP support. This
      section does not describe all the possible error situations
      that may occur. When necessary, please refer to the
      appropriate publications or IBM support for additional
      assistance.
 
         a. Cannot PING an AFCCU printer
            1. The TCP/IP support for either Token Ring or Ethernet
               is not enabled at the printer.
            2. You are PINGing the wrong IP address.
            3. The printer has the same IP address as another device
               device in your network.
            4. The printer is configured to reside in the wrong
               subnetwork. This can happen if your AS/400 is
               configured to have more than one TCP/IP interface.
               You must verify the printer's IP address. You may
               also have to verify the subnet masks used for each
               TCP/IP interface defined on your AS/400.
 
         b. Cannot PING a 7913
            1. The 7913 is not powered on.
            2. You are PINGing the wrong IP address.
            3. The printer has the same IP address as another device

               device in your network.
            4. The 7913 has not received its configuration
               information through use of BOOTP. This can happen
               if an IP router in your network does not permit
               BOOTP to flow through it. The solution is to
               either correct the problem at the router or
               use the Enhanced Configuration Option of the 7913.
               Please refer to the Installation Guide for the 7913
               for additional information.
            5. The 7913 is configured to reside in the wrong
               subnetwork. This can happen if your AS/400 is
               configured to have more than one TCP/IP interface.
               You must verify the printer's IP address. You may
               also have to verify the subnet masks used for each
               TCP/IP interface defined on your AS/400.
 
         c. Cannot print a test page from the 7913.
            1. You are using a Twinaxial printer which is not
               configured with address 0.
            2. The cable between the 7913 and the printer is not
               connected properly.
            3. The cable between the 7913 and the printer is damaged.
               Use another cable.
            4. The printer is not ready.
 
         d. AS/400 PING command does not work
            1. The AS/400 TCP/IP support has not been started. Issue
               the STRTCP CL command to start AS/400 TCP/IP support.
            2. The TCP/IP interface for your line description has not
               been started. Use the STRTCPIFC CL command, or work
               your way through the menu provided by using the CFGTCP
               CL command, to start the TCP/IP interface for the
               Token Ring or Ethernet line description you are using.
 
         e. PSF/400 fails to start. Message CPF5379 is logged.
            1. You did not configure PSF/400 for TCP/IP support. Use
               the WRKAFP2 command to configure PSF/400 for TCP/IP.


Default Instructions


   THIS PTF CAN BE APPLIED IMMEDIATE OR DELAYED.

Supersedes


PTF/FIX NO(S).  APAR TITLE LINE
--------------  -----------------------------------------------------------
   SF23383      AFP-OSP IMAGE PERFORMANCE FIX, CONVERT TO IO REP. & TRIM
   SF23188      AFP-PRT-APPC CANNOT START SESSION WITH PSF/2 OR PSF/6000
   SF23185      OSP-PSF-MSGPQT3630-MSGPQT3675 WHEN TRYING TO PRINT AFTER
   SF21509      AFP D/T AFCCU 3900 RESIDENT FONT SUPPORT
   SF21217      AFP INTERNAL SYSTEM FAILURE PRINTING A BARCODE JOB
   SF21217      AFP INCORRECT PRTR INFO PROCESSING ON D/T 3900 (NOT MODEL 1)
   SF21217      AFP MSG PQT2776 NOT PRODUCED FOR OUTBIN LEVEL 31845

Summary Information

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



IBM disclaims all warranties, whether express or implied, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose. By furnishing this document, IBM grants no licenses to any related patents or copyrights. Copyright (c) 1994, 1995, 1996 IBM Corporation. Any trademarks and product or brand names referenced in this document are the property of their respective owners. Consult your product manuals for complete trademark information.