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