Readme File for Hewlett-Packard IP/IPX Printer Gateway For NDPS Version 3.00b TABLE OF CONTENTS A. UPDATE SUMMARY B. NEW FEATURES AND FIXES C. HARDWARE REQUIREMENTS D. NETWARE OPERATING SYSTEM AND CLIENT SUPPORTED BY THE HP PRINTER GATEWAY E. INSTALLING THE SOFTWARE F. CONFIGURATION AND LOGGING FILES G. SPECIAL NOTES H. RUNNING HPGATEUPDATETTCJ.EXE I. ERROR MESSAGES IN HPGERROR.LOG J. SOFTWARE LICENSE AGREEMENT K. TRADEMARKS A.
B. NEW FEATURES AND FIXES The HP Printer Gateway 3.00b includes the following changes: • The HP Printer Gateway server abends when printing to a printer that is configured by Novell’s iPrint technology with banner enabled on Windows 9x, NT, 2000 or XP. This issue has been resolved. • The HP Printer Gateway snap-in causes NWAdmin to crash when accessing a NDPS object if the user does not has write permission for the public\win32\nls\English folder. This issue has been resolved.
• Printing multiple copies of one document works properly. • Job monitoring can now be enabled or disabled. See Section F. CONFIGURATION AND LOGGING FILES for more details. • Context help has been updated for the CONFIG_PRNTR_GATE_DEFAULTS and CONFIG_PRNTR_GATE_PARM menus. • The LOAD HPGATE.NLM DEBUG load string works when the NLM is not already loaded. • Abend related to dplsv386.nlm has been fixed.
HP Printer Gateway upgrade/installation unless the user chooses not to do so. All other values will not be changed. 50 seconds is the default value in version 2.10a, and 3 seconds is the default value in this version. The new default value of 3 seconds for “Timeout to Close Job” minimizes the delay between print jobs. This version of the HP Printer Gateway supersedes previous versions. C. HARDWARE REQUIREMENTS HP Jetdirect Print Servers IPX The HP Printer Gateway supports most HP Jetdirect print servers.
E. INSTALLING THE SOFTWARE Hpgw300b_en.exe is a self-extracting file that installs all the necessary files on the designated NetWare 5.x or 6.x server. Installing the HP Printer Gateway Software (see SECTION G. SPECIAL NOTES for how to extract the HP Printer Gateway files without actual installation) Warning: It is strongly recommended that you exit all local Windows programs before running the installation program. You should also exit NWADMIN on remote machines before installation.
- OR Click NO to leave the default value unchanged and go to step #10. You may run the HPGateUpdateTtcj.exe to change the value at a later time. See section H. RUNNING HPGATEUPDATETTCJ.EXE for more details. 9. Enter the NDS Tree name and the fully qualified NDPS Manager name that contains the printer agents that you want to update. 10. Click Next. The HP Printer Gateway files will be copied to the server. 11.
FILES PLACED ON THE NETWARE 5.x or 6.x SERVER Default Path Description \Public\Hpgwdoc\Readhpgw.pdf Readme file for the HP Printer Gateway (this file) \Public\Win32\Confighp.pd2 HP Printer Gateway configuration snap-in for the NetWare Administrator \Public\Win32\Hpsnap.pc2 HP Printer Control snap-in for the NetWare Administrator \Public\Win32\Nls\English\Confighp.hlp Help file for Confighp.pd2 \Public\Win32\Nls\English\Hppcw32.dll Resource DLL file for Hpsnap.
F. CONFIGURATION AND LOGGING FILES Hpndps.ini Parameters For setting up specific functionality in the HP Printer Gateway, the administrator can set up the following parameters in the hpndps.ini file, located in the \System directory.
INI Section INI Entry Gateway Configuration Enable Error Log Explanation Sets error logging to the hpgerror.log file to on or off. Acceptable Values Default Values 0, 1 1 0 - disable error logging 1 - enable error logging Notes Public Access Printing Configuration Search Method Specifies which search method to use when searching for PAPs (Public Access Printers).
INI Section Printer Gateway Defaults INI Entry Explanation Specifies how long the job monitor Job monitor timeout thread in HP NDPS Gateway should (in seconds) wait before shutting down the printer agent. Printer Gateway Defaults Enable job monitor Printer Gateway Defaults SAP Handler Default Turns job monitor on or off. Speeds up printing when disabled, however, this does not reflect the true state reports by the printer device. Specifies how to handle SAP'ing with the printers.
INI Section Printer Gateway Defaults Specified Network Addresses INI Entry Explanation Banner Ownername Specifies how the job owner name is Option displayed on a banner. Entry_%X Specifies the IPX network numbers that should be searched when looking for PAPs, given in hexadecimal. Acceptable Values Default Values Notes 0-2 0 0 – default value of ,, 1 - , 2 - ,.
Sample hpndps.
• For IPX and IP printing using the HP Printer Gateway, we recommended using a Status Update Time Not Printing value of 15 seconds (or greater). In certain situations, setting this parameter to a value less than 15 may cause a lockup in the printer and prevent it from resetting to a Ready state after correcting an error condition (e.g., door open). To recover from this situation, power-cycle the printer. • If partial print jobs are seen on NetWare 5.
H. RUNNING HPGATEUPDATETTCJ.EXE Purpose: To update the “Timeout to Close Job” (TTCJ) value on multiple printer agents. Location: The HpGateUpdateTtcj.exe can be found on the Novell NetWare server under sys:\Public\win32 directory after the installation of HP Printer Gateway. Platforms: The HpGateUpdateTtcj.exe is a Windows program and can be run under Windows 98, Windows NT 4.0, Windows 2000 or Windows XP. Requirements: An existing NDS Tree and an existing NDPS manager.
How-To: 1. In the NDPS Manager box, type in the name of a fully qualified NDPS Manager. 2. In the NDS Tree Name box, type in the name of the NDS Tree. 3. Click the Attach button. This will display a list of existing HP Gateway Printer Agents. 4. You may filter the list of Printer Agents by protocol in the Protocol Filter section. To see a list of IP-based Printer Agents, check the IP box only. To see a list of IPX-based Printer Agents, check the IPX box only. 5.
I. ERROR MESSAGES IN HPGERROR.LOG 1) Sending data failed with unknown error of 10055 on Explanation – The HP Printer Gateway fails to open an IPX socket. According to the Microsoft documentation, this error message (10055 is WSAENOBUFS) is defined as follows: “No buffer space is available. The socket cannot be created.” What to do – Restart the server and the HP Printer Gateway. 2) Job canceling failed with no job on .
8) Unknown error of 53 from processing handler on Explanation – The HP Printer Gateway attempts to send data to the device when it encounters the printer agent being shutdown. 53 is equivalent to HPGATE_CCODE_SHUTDOWN which defines as a signal to shutdown the printer agent. What to do − Restart the printer agent. 9) hpGateJobState_Monitor EnQ of MonitorQ node failed for PA Explanation - All job data has been sent to the device that supports job monitoring.
15) Default case reached in hpGateJPMErrorHandler returnCode = 803 cmdCode = 106 PA Name Explanation - 803 is invalid object and 106 is SET_ATTRIBUTE_SET. The HP Printer Gateway attempts to set an attribute value in the Managed Object Database, but is unable to determine whether the attribute is a job attribute or printer agent attribute. What to do – Record all steps necessary to accurately reproduce this problem. Then contact Technical Support.
) Job Monitor failed, shutting down Explanation - If the device supports job monitor and the job monitor functionality fails, then it signals a shutdown of the given printer agent. This is the main cause of the “Not Bound” problem. What to do - Check previous messages to see if the Job Monitor reached timeout. Determine the possible cause by means of a network trace of the job processing. Determine how the device responds to the SNMP packets.
28) GetJobPMLIndex Jobinfo attr tree getnext returned error status 2008 for Explanation - 2008 is ERR_NORESP. This is due to the printer not responding in time to an SNMP request. During the Job Monitor phase, the HP Printer Gateway requests the PML index from the printer agent. However, the printer does not respond in time, which may cause the printer agent goes into “Not Bound”. This typically occurs on extremely busy networks or on older devices.
34) Job State Aborted failed on PA Explanation - User attempted to abort a job and failed. What to do - Restart the printer agent. 35) hpGateJobState_Aborted close doc job failed on Explanation - User attempted to abort a job and failed. What to do - Restart the printer agent. 36) GetJobPMLIndex get next for JobAttr Info Tree returned error status 1005 for Explanation - 1005 is ERR_OTHER.
42) Job Monitor get job state failed with 2008 on Explanation - 2008 is ERR_NORESP, which means the device does not respond in time to an SNMP request. During the Job Monitor phase, the HP Printer Gateway requested the PML index from the printer agent. However, the printer does not respond in time, which results in a “Not Bound” situation. What to do - Record all steps necessary to accurately reproduce this problem. Then contact Technical Support.
49) hpGateJPMCall received when PA: shutting down or NLM unloading. Explanation - The hpGateJPMCall is the interface into the NDPSM. Disabling calls to this function (usually because the printer agent is shutting down) results in this error message. What to do - Restart the printer agent. 50) hpGateJobState_Error aborting job on with error code 2. Explanation - The HP Printer Gateway attempts to abort a job on the given printer agent but fails with an error.
57) Open DRM failed with no free connections on Explanation - The HP Printer Gateway attempts to establish a Direct Request Mode connection with the device, which responds with “No free connections available.” What to do - Investigate why a free connection is unavailable. For example, the printing device may be sharing with other processes, such as a process from a Windows operating system.
rights in the Software. HP's third party suppliers may protect their rights in the event of any violation of these License Terms. Copies and Adaptations. You may only make copies or adaptations of the Software for archival purposes or when copying or adaptation is an essential step in the authorized Use of the Software. You must reproduce all copyright notices in the original Software on all copies or adaptations. You may not copy the Software onto any public network. No Disassembly or Decryption.
ATTENTION ANY PARTY INSTALLING THIS SOFTWARE FOR USE BY PARTIES OTHER THAN THEMSELVES (e.g. VARs, RESELLERS, SYSTEM INTEGRATORS, etc.): ANY PERSON TO WHOM THIS SOFTWARE IS TRANSFERRED SHOULD BE AWARE THAT USE OF THE SOFTWARE IS SUBJECT TO ANY HP SOFTWARE LICENSE TERMS DISTRIBUTED WITH THE SOFTWARE. USE OF THE SOFTWARE INDICATES ACCEPTANCE OF THESE TERMS. IF THE USER DOES NOT ACCEPT THESE TERMS, THE SOFTWARE SHOULD BE RETURNED. I.
