IBM Support

Configuration Settings and Error Messages for *LAN 3812 IPP Device Descriptions

Troubleshooting


Problem

This document contains information on configuration settings and error messages for *LAN 3812 IPP device descriptions, which use the Internet Print Protocol (IPP).

Resolving The Problem

Support for *LAN 3812 IPP device descriptions is available in the base code for the R520 operating system. This is an alternative to using Remote Output Queues (RMTOUTQs), as well as *LAN 3812 PJL and SNMP device descriptions. *LAN 3812 IPP device descriptions use the IPP Print Driver and fully support the page range function. For information on configuration and limitations of *LAN 3812 IPP device descriptions, you should refer to the following Rochester Support Center knowledgebase document:

Configuring a *LAN 3812 IPP Device Description

The success of this connection is dependent on the configuration settings at both ends, the operating system and the network interface card (NIC) or print server. The TCP/IP network will also have some bearing on performance and starting of the printer writer. The following suggestions are intended to make this transition smooth and different roles in its success. Because the HP, Lexmark, and IBM printers are the most common, the examples will only include these printers. This configuration should work with any type of printer as long as the network interface card (NIC) or print server supports Internet Print Protocol (IPP).

This document contains the following sections:

1Hardware Requirements for *LAN 3812 IPP Device Descriptions discusses the hardware requirements that must be met by the printer, and the internal network interface card (NIC) or external print server.
2Timeout Settings on the Print Server discusses the timeout settings in the print server hardware.
3Timeout Settings on the Printer discusses the timeout settings in the printer hardware.
4Recommended Timeout Settings for IBM, HP and Lexmark Print Servers lists the recommended timeout settings for certain IBM, HP and Lexmark print servers.
5Timeout Settings in the Operating System Printer Device Description discusses some settings in the printer device configuration in the operating system that can cause writers to end.
6TCP/IP Keep-Alive Value on the Operating System discusses setting the TCP/IP Keep Alive value by using the CHGTCPA command on the system.
7Error Messages for *LAN IPP Device Descriptions contains the messages that are associated with remote output queue printing. These messages are found in the writer job log.
8Getting the Latest Print-Related TCP Fixes and Print-Related Fixes contains links to the latest PTF lists for TCP/IP printing.
9Checking and Changing the Size of the *SPOOL Pool contains information about how to determine the size of the *SPOOL pool and how to adjust the size.
This document was last updated on 6 January 2014.
    • - Hardware Requirements for *LAN 3812 IPP Device Descriptions



      There is no guarantee that printers that support Remote Output Queues (RMTOUTQs) will also support IPP (or vice versa). For a *LAN IPP device description to work, the following hardware requirements must be met:

      1The internal network interface card (NIC) or external print server must support the Internet Print Protocol (IPP).
      2The internal network interface card (NIC) or external print server must support IPP Chunking, since the printer writer will attempt to make a connection before Host Print Transform (HPT) has completely converted the spooled file to an ASCII printer data stream.
      3The internal network interface card (NIC) or external print server must be at a firmware or microcode level that supports IPP printing.
      4If the printer is connected to an external network adapter, it must be connected using an IEEE 1284, bi-directional printer cable, and the print server must be in BITRONICS, BI-DIRECTIONAL, or ECP/MLC mode.
      A number of printers and printer servers from a variety of manufacturers support IPP, including certain models of IBM® Infoprint printers, HP JetDirect print servers, and Lexmark Marknet printer servers.

      Note: If it is unclear if the network interface card (NIC) or print server supports IPP, contact the manufacturer.

      • - Timeout Settings on the Print Server



        The print server, sometimes called a LAN adapter or Network Interface (NIC) card (internal or external), has a timeout setting in the hardware configuration. A timeout is the amount of time that the print server waits for data before the print job is canceled. When this timeout expires, the adapter releases the printer so that other print jobs can be started. These other print jobs can be from another protocol, another interface, or another host. This function provides a safety net. If a host fails to send a complete print job, the print server waits for the specified time and then moves on to the next job. If a file is released to print and the timeout expires before a complete OS/400 or i5/OS spooled file is sent to the printer or the timeout expires between the sending of buffers, the printer writer ends with message CPD337C, The session with device &1 ended abnormally, and the OS/400 or i5/OS spooled file is set to HLD or RDY status.

        The timeout can be configured from the printer panel or through a network utility (for example, the HP JetAdmin utility for internal and external HP JetDirect print servers and the Lexmark MarkVision utility for Lexmark Marknet print servers). For printer panel configuration, the timeout is found under some network option -- under the IO and MIO Menus for HP printers, under the Network Menu for Lexmark printers, and under the Ethernet or Token-Ring Menu for IBM printers.

        • - Timeout Settings on the Printer



          On the printer, the processor timer (sometimes called a job timeout or a wait timeout) should be disabled or set to maximum (usually 300 seconds) because individual pages might have a delay in transmitting to the printer due to transforming considerations. This timer controls the amount of time in seconds (5 to 300) the printer waits before printing the last page that does not end with a command to print the page. This timer should not affect the execution of this print driver because each page is terminated with a form feed. We could have a case where a partial page is sent to the printer's buffer while complex transforming is taking place during which this timer expires and, therefore, ejects an incomplete page.

          • - Recommended Timeout Settings for IBM, HP and Lexmark Print Servers



            IBM Network Printer and InfoPrint printers:

            Set the Port Timeout to 300 (5 minutes). Setting this timeout to 0 does not disable the Port Timeout. IBM does not have an external adapter that supports this configuration at this time. The port timeout can be set through the control panel on the printer.

            IBM Infoprint 1100, 1200, 1300 and 1400 Series Printers:

            Disable the Job Timeout by setting it to 0. The Job Timeout can typically be set through the control panel on the printer, or it can be set using the Lexmark MarkVision Utility. The Lexmark MarkVision Utility can be downloaded from Lexmark's Web site, http://www.lexmark.com/.

            HP JetDirect cards/print servers:

            Set the IO Timeout (or Job Timeout) to 300 seconds (5 minutes) and set the Idle Timeout to somewhere between 900 seconds (15 minutes) and 3600 seconds (1 hour). Setting the IO Timeout (or Job Timeout) and Idle Timeout to 0 does not disable them. It causes the printer and/or print server to timeout immediately. The IO Timeout can typically be set through the control panel on the printer, or it can be set using the HP JetAdmin Utility. The Idle Timeout can be set by TELNETing to the TCP/IP address for the printer, or it can be set using the HP JetAdmin Utility. The HP JetAdmin Utility can be downloaded from HP's Web site, http://www.hp.com/.

            Lexmark MarkNet cards/print servers:

            Disable the End of Job Timeout or Job Timeout by setting it to 0. If the printer has a Network Job Timeout then that should also be disabled by setting it to 0. These timeout values can typically be set through the control panel on the printer, or by using the Lexmark MarkVision Utility. The Lexmark MarkVision Utility can be downloaded from Lexmark's Web site, www.lexmark.com/.

            • - Timeout Settings in the Operating System Printer Device Description



              Settings in the printer device configuration in operating system that can cause writers to end are the Inactivity timer and Activation timer.

              The recommended setting for Inactivity timer should be set at some value other than *NOMAX so that the connection will be closed during periods of no activity. Even if not sharing on the network, *NOMAX can cause problems with the writer connection.

              The Activation timer should be set to a value large enough to prevent posting of intervention errors due to TCP/IP transmission delays and printer processing delays. The default setting of 170 seconds is usually large enough to accomplish this unless you send large files to a printer with a slow processor that has a lot of memory. Increasing the activation time will prevent unwanted intervention errors but that time will have to pass before you will get a desired intervention error. Note that intervention errors do not stop the print process. If the Printer Error Message parameter in the Device Description for the writer was set to *INQ, then the intervention will require an operator input to retry or to cancel the writer. (At R370, the Printer Error message is not recognized on ASCII printers. Change the User defined options parameter to ERRMSGINFO). If the parameter was set to *INFO, then the driver will continue to retry until the connection has been established or the TCP/IP has closed the socket or, in the case of a slow printer processor, the proper response is obtained which is either the printer is on-line or that the printer has received all the data. If the connection was eventually successful, the intervention message will be attempted to be removed from the message queue, and process will continue.

              • - TCP/IP Keep-Alive Value on the Operating System



                The printer will close the socket if the printer has not processed any communication from the host within the timeout limit for the LAN adapter, which is discussed in the section entitled Timeout Settings on the Print Server. This can happen if the printer has a large buffer and it is filled with data to print. To prevent this from happening, the TCP/IP Keep-Alive value on the operating system should be set to a value less than the timeout value for the print server. The TCP/IP Keep-Alive value can be changed using the Change TCP/IP Attributes (CHGTCPA) command. This causes a poll to be sent to the printer before the printer times out. We want this timeout value to be as large as possible to prevent unnecessary network traffic. Increasing the TCP keep alive (TCPKEEPALV) parameter to 50 minutes may help if printing large spooled files.

                • - Error Messages for *LAN IPP Device Descriptions



                  CPD6F83 "Could not establish Internet Print Protocol (IPP) communications with device &1"

                  This indicates that the printer writer was not able to establish IPP communications with the device. Reason code 1 (RC1) means that a connection was established with the device, but the device did not respond with an IPP response. Reason code 2 (RC2) means that a connection was established with the device, but the IPP request was not understood by the device.

                  Verify that the printer and the internal network interface card (NIC) or external print server fully support IPP and that the correct port and path are specified. Port 631 is the well known port for the Internet Print Protocol.

                  Note: The internal network interface card (NIC) or external print server must support IPP Chunking in addition to having general IPP support for the *LAN 3812 IPP device description to work.

                  CPD6F84 "Could not establish secure connection with device &1"

                  This indicates that the printer writer was not able to establish a Secure Socket Layer (SLL) connection with the device. Verify that the device can support secure connections and that the device is configured to accept SSL connections.

                  CPD6F85 "Could not satisfy authentication request from device &1"

                  This indicates that the printer writer was not able to satisfy the authentication request from the device&1.

                  Reason code 1 (RC1) indicates that the validation list was not configured in the printer device description on the iSeries system. Change the printer device description to specify a validation list.

                  Reason code 2 (RC2) indicates that the device did not accept the validation list authentication information. Verify that the Validation list contains a userid and password that the device will accept.

                  Reason code 3 (RC3) indicates that the client certificate was not associated with a user profile. The device is configured for SSL, but verify that a client certificate is associated with the user profile of the user that owns the spooled file.

                  Reason code 4 (RC4) indicates that the device did not accept the client certificate. Verify that the device is configured to accept a client certificate from the user that owns the spooled file.

                  CPD338D "An error occurred while receiving data"
                  The LAN adapter timeout value has expired and the writer has ended. Refer to section Recommended Timeout Settings for IBM, HP and Lexmark Print Servers at the top of this document for information on changing the timeout settings.

                  CPD337C "The session with device &1 ended abnormally"
                  This means that the connection cannot make the socket connection. Make sure the port value is correct for the LAN adapter or printer. If a firewall or SOCKS server is set up, or going through a router, make sure the port is not blocked. Check with the network administrator on the port that you are using to see if the firewall, SOCKS server, or router is blocking the port. This error message can also be caused by disabling bidirectional communications on either the printer or the print server/network interface card (NIC).

                  If message CPD337C is received when printing to an IBM Infoprint 1000, 1200, 1300, 1400 or 1500 Series printer or a Lexmark Optra printer, it could indicate that the Job Timeout in the printer hardware is set too low. If this is the case, disabling the Job Timeout by setting it to 0 should resolve the problem. Refer to the section Recommended Timeout Settings for IBM, HP and Lexmark Print Servers at the top of this document for information on changing the timeout settings.

                  Dot matrix and line matrix printers, such as the IBM 6400, IBM 4247 and IBM Infoprint 6500 printers, typically do not have timeout settings that can be changed. However, if message CPD337C is received when printing to a dot matrix or line matrix printer, then installing the latest firmware for the printer or network interface card (NIC) hardware might resolve the problem.

                  If message CPD337C is received when printing a large spooled file with the Starting page portion of the Page range to print (PAGERANGE) parameter in the spooled file attributes set to a large number, it could indicate that the timeout settings in the printer hardware are set too low. This has been seen with a *LAN 3812 SNMP device description when printing a 22000-page spooled file that had PAGERANGE(15000 15002) specified to an HP LaserJet printer that had the Idle Timeout set to 90 seconds. The SNMP print driver code had a performance issue, which was reported by APAR SE25841 OSP-LOOP-PRT SNMP DRIVER HANGS NO PRINTING SPOOLED FILE and fixed by R530 PTF SI24372 and R540 PTF SI25703. However, even after the problem was fixed by a PTF it took almost 90 seconds to process the spooled file, so the same thing could happen with either the IBM SNMP print driver code or the HP PJL print driver code if it had taken a little longer to process the spooled file (for instance if the system had been very busy at the time). Therefore, it is recommended to increase the Idle Timeout from the default value of 90 seconds to somewhere between 300 seconds (15 minutes) and 3600 seconds (1 hour), even after applying the PTF. Refer to the section Recommended Timeout Settings for IBM, HP and Lexmark Print Servers at the top of this document for information on changing the timeout settings.

                  If message CPD337C is received when printing to IBM 4049, Lexmark Optra R, Optra L, or Optra Lx printers, ensure the setting Advanced Status is turned on. This setting is found under the printer's Parallel Menu. According to the user's guide for the Lexmark Optra R, Optra L, and Optra Lx printers (which are equivalent to the IBM 4049 LaserPrinter), "if Advanced Status is set On, bidirectional communications is enabled through the parallel interface." The factory default is On, so normally bidirectional communications is enabled for these printers. The *LAN 3812 PJL OS/400 device descriptions require bidirectional communications, so turning the Advanced Status off would cause the *LAN 3812 PJL operating system device description to fail. Refer to the User's Guide for Lexmark Optra R, Optra L, and Optra Lx printers.

                  Message CPD337C can also be caused by having the Network Job Timeout set too low in a Lexmark printer. Setting the Network Job Timeout to the maximum value of 255 may still be too low, so this timeout should also be disabled by setting it to 0. The Network Job Timeout can typically be set through the control panel on the printer, or by using the Lexmark MarkVision Utility. The Lexmark MarkVision Utility can be downloaded from Lexmark's Web site, www.lexmark.com/.

                  CPF3330 "Necessary resource not available"
                  This indicates that a resource is not available and the writer appears to hang. A good circumvention is to change the default wait timeout on the writer. This can be changed through the CHGCLS command, then restart the writer. An example is CHGCLS CLS(QSPL) DFTWAIT(120), to be entered at the command line.

                  CPD337F "Remote device rejected an attempt by the writer to open a connection"
                  This error may have occurred for the following reasons.

                  1An incorrect port number or Internet address was specified in the printer device description.
                  2The remote device, if it is a printer, may be busy printing from another host.
                  3The remote device, if it is a printer, may not be ready to print and may require operator intervention.
                  This is a common error issued if the writer is trying to send data to the printer and the printer is unable to receive. This is normal in some configurations and will not cause a problem unless the device description activation timer expires before the printer is ready to receive the data again. Refer to the section on Timeout Settings in the Operating System Printer Device Description for information on setting the activation timer.

                  Typical reasons for this error can include the following:

                  oThe printer buffer may be filling up because it is being sent spooled files faster than it can print them. When this occurs, the writer waits and issues message CPD337F. Sometimes adding more memory to the printer can alleviate this problem. It is recommended that you increase the Activation timer if this is causing the writer to end.
                  oThe printer is temporarily unavailable because it is out of forms, has a paper jam, is offline, is in power saver mode, and so on. There are some instances when the writer will not start because of the power saver, though getting the latest PTFs should resolve this problem. Refer to section Getting the Latest Print-Related TCP Fixes and IPP Driver Fixes at the bottom of this document for information on getting the latest PTFs. Otherwise, you should be able to get the writer to start by disabling power save mode on the printer.
                  oIf using an external print server, the printer may be connected to the print server using the wrong type of parallel cable or the parallel port on the print server may not be configured correctly. Make sure the parallel cable is a bi-directional, IEEE 1284 printer cable and set the parallel mode on the print server to BiTronics, Bi-Directional or ECP/MLC.
                  oThe network interface card (NIC) or print server does not support Internet Print Protocol (IPP). Examples include all dot matrix printers, all line printers, all ink jet printers, or older laser printers (anything compatible with an HP LaserJet III or earlier). If the printer supports HP PCL5e or HP PCL6, there is a good chance, but no guarantee, that it will work using a *LAN 3812 IPP device description.
                  oThe Remote location (RMTLOCNAME) parameter may not be set to the proper URL for the IPP Server on network interface card (NIC) or print server. For a complete list of values for the RMTLOCNAME parameter for various print servers, please refer to the following document:

                  N1019376: Recommended Remote Location (RMTLOCNAME) Values for *LAN 3812 IPP Device Descriptions
                  CPF6DF9 "Transformed data buffer too small"
                  This can be caused from using an incorrect Manufacturer type and model value in the printer device description. The value has to be a *LAN supported laser printer. For instance, since an HP500 printer cannot be configured as a *LAN printer device, using this value can cause this error message and end the writer.

                  CPA403D "Operator action required on device &4 (C R)"
                  This indicates that user intervention is requested on the printer (such as out of forms, paper jam, and so on). For the R410 operating system and above, change the printer device description so the Printer error message (PRTERRMSG) parameter is set to *INFO instead of *INQ. For the R370 operating system, change the printer device description so the first User-Defined Options (USRDFNOPT) parameter is set to ERRMSGINFO.

                  This will cause message CPD337F "Remote device rejected an attempt by the writer to open a connection" to be issued as an informational message rather than getting CPA403D as an inquiry message. Since you will no longer be getting an inquiry message whenever user intervention is requested on the printer, you will not have to answer a message operating system to get printing to continue once the error condition on the printer has been resolved. Also, the writer should not end while waiting for the printer to become available.

                  Getting the latest PTFs may help with this problem. Refer to section Getting the Latest Print-Related TCP Fixes and Print-Related Fixes at the bottom of this document for information on getting the latest PTFs.

                  CPD337A "An error occurred while printing on device &1"
                  This error message indicates that the writer has ended unexpectedly. If this is occurring, check the following:

                  oDisplay the printer device description and verify that the Port number (PORT) parameter is not set to 0. This should typically be set to 2501 for most IBM Network Printer and Infoprint printers, 9100 for HP LaserJet with internal HP JetDirect cards (9100, 9101 or 9102 for multi-port external HP JetDirect print servers), and 9100 for Lexmark Optra printers with internal Lexmark Marknet cards (9100, 9101 or 9102 for multi-port external Lexmark Marknet print servers).

                  For a complete list of values for the RMTLOCNAME parameter for various print servers, please refer to the following document:

                  Recommended Remote Location (RMTLOCNAME) Values for *LAN 3812 IPP Device Descriptions
                  oDisplay the printer device description and verify that the Inactivity timer (INACTTMR) parameter is not set to *NOMAX. This should typically be set to *SEC15, which means that the writer will end the connection to the printer 15 seconds after all RDY spooled files have been processed.

                  Setting this to *NOMAX will cause the writer to attempt to keep a permanent connection to the printer. This could prevent printing from other hosts on the LAN/WAN (including PCs, NT Servers and other iSeries family systems) and could cause the writer to end if the connection is lost. Setting this to a large number, such as 10 - 30 minutes, could have similar results.
                  oVerify that the timeout settings in the printer and print server hardware are not set too low. Refer to section Recommended Timeout Settings for IBM, HP and Lexmark Print Servers at the top of this document for information on changing the timeout settings.
                  oGetting the latest PTFs may help resolve this problem. Refer to section Getting the Latest Print-Related TCP Fixes and Print-Related Fixes at the bottom of this document for information on getting the latest PTFs.
                  oUse the Configure TCP/IP (CFGTCP) command and take Option 4 (Work with TCP/IP port restrictions) to verify that there are no port restrictions blocking the port number specified in the Port number (PORT) parameter in the *LAN 3812 IPP DEVD. If there are, remove the port restriction, then end and restart the printer writer.

                  MCH3601 "Pointer not set for location referenced"
                  You should not get this message. Getting the latest PTFs should resolve this problem. Refer to section Getting the Latest Print-Related TCP Fixes and Print-Related Driver Fixes at the bottom of this document for information on getting the latest PTFs.

                  • - Recommended PTF Levels



                    There are no required PTFs in order to print using a *LAN 3812 IPP device description, but getting the latest Print Group PTF will typically help you avoid problems:

                    PTF NumberLicensed ProgramVersionDescription
                    SF993565761SS1V6R1M0610 Print Group PTF for V6R1M0
                    SF993475722SS1V5R4M0540 Print Group PTF for V5R4M0
                    SF993465722SS1V5R3M0530 Print Group PTF for V5R3M0
                    SF993455722SS1V5R2M0520 Print Group PTF for V5R2M0

                    Otherwise for a list of the latest PTFs, including PTFs that are not yet included in the latest Print Group PTF, contact the Rochester Support Center or refer to the Recommended Fixes data base at the following Web site:

                    http://www-912.ibm.com/s_dir/slkbase.nsf/recommendedfixes

                    • - Checking and Changing the Size of the *SPOOL Pool



                      The amount of memory allocated to the *SPOOL pool and the maximum number of active jobs can have an affect on whether a writer is able to print, or how quickly a writer is able to print, to a network attached printer. To check and change the size of the *SPOOL, do the following:

                      1Use the Work with System Status (WRKSYSSTS) command and press the F11 Key twice to display the pool data, including the pool names. Note both the Pool Size and the Max Active settings for the *SPOOL pool. Starting in the V4R5 operating system, the pool size is specified in megabytes (M). Prior to the V4R5 operating system, the pool size was specified in kilobytes (KB).
                      2Check the *SPOOL pool and estimate if it is an acceptable size for the system's printing needs:

                      Refer to the Pool Configuration information in the Work Management Guide (SC41-4306) for a list of the suggested values. When using remote output queue printing, in most cases, Host Print Transform is also being used which increases the requirement for the *SPOOL pool. A good suggestion to start with is 5000K. The Printing V IBM® Redbooks™ recommends a minimum of 6 MB. If the system has many, many writers, this should be higher. Contact Work Management or Performance for additional help if needed.
                      3Use the following Display System Value (DSPSYSVAL) command to display the current setting of the QPFRADJ (Performance adjustment) system value:

                      DSPSYSVAL SYSVAL(QPFRADJ)
                      4If the QPFRADJ system value is set to 0 (No adjustment), then proceed to the next step to set the size of the *SPOOL pool. If the QPFRADJ system value is set to 1 (Adjustment at IPL), 2 (Adjustment at IPL and automatic adjustment), or 3 (Automatic adjustment), then use the Work with Shared Storage Pools (WRKSHRPOOL) command to first set a minimum percentage for the *SPOOL pool.
                      5To change the size of the *SPOOL pool, use the WRKSYSSTS command and press the F11 Key twice, as was done in Step 1 above. Type over the existing values for the Pool Size and Max Active settings and press the Enter key to change the settings. Any additional memory allocated to the *SPOOL pool will be taken from the *BASE pool.

                      Note: If the minimum percentage for the *SPOOL pool is not increased and Performance Adjustment is used, then the pool size will gradually be reduced by Performance Adjustment until it matches the minimum percentage, at which time it will no longer be at an acceptable size for the system's printing needs. For further assistance with adjusting the system's performance, contact a Technical Support representative in the Performance (PERF) queue.

                    [{"Type":"MASTER","Line of Business":{"code":"LOB57","label":"Power"},"Business Unit":{"code":"BU058","label":"IBM Infrastructure w\/TPS"},"Product":{"code":"SWG60","label":"IBM i"},"Platform":[{"code":"PF012","label":"IBM i"}],"Version":"6.1.0"}]

                    Historical Number

                    27295239

                    Document Information

                    Modified date:
                    18 December 2019

                    UID

                    nas8N1019374