Hewlett-Packard IP/IPX Printer Gateway for NDPS Version 3.00B

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. UPDATE SUMMARY

HP IP/IPX Printer Gateway for NDPS (the HP Printer Gateway), version 3.00b, is a NetWare Loadable Module (NLM) for NetWare 5.x, 6.0 and 6.5 that allows you to enable printing, configure gateway settings, configure printers, and view statistics for HP printers connected through HP JetDirect print servers in the Novell Distributed Print Services (NDPS) environments. You can download the HP Printer Gateway on the HP web site. For the latest version, go to http://www.hp.com/go/hpgate_sw then perform the following steps: 1. Select the appropriate NetWare OS version. 2. Click DOWNLOAD.

For additional details on the HP Printer Gateway, or to download the HP Printer Gateway User's Guide or this readme file (both in PDF format): 1. Scroll down and click on the following link in the name column: HP IP/IPX Printer Gateway for NDPS – For Installation from a Win 9x, NT4.0, 2000, or XP Client 2. Click Manuals. 3. Select the document of your choice.

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. • The input field of NDPS Manager in the HPGateUpdateTtcj.exe program now accepts up to 254 characters.

The HP Printer Gateway 3.00a includes the following changes:

• Added support for Novell's latest clients. • An hpgerror.log file is created in the sys\etc directory when errors\warnings occur. The hpgerror.log file is limited to 1MB. As additional errors are logged, the oldest entry is deleted to keep the file size at 1MB. Writing to hpgerror.log can be disabled by setting “Enable error log” to 0 in the hpndps.ini file. • Banner page options have been enhanced in postscript and PCL formats. These can be configured in the hpndps.ini (on sys\system) file under "Banner Option" and "Banner Justification." Setting “Banner Option” to 0 will cause the HP NDPS banner page to be printed in default mode (if banners are enabled). Setting “Banner Option” to 1 will cause the HP NDPS banner page to be printed in a QMS (NDS/Bindery) format. In addition to this, the Job Owner Name information can be right or left justified on Novell’s NDPS banner page. See Section F. CONFIGURATION AND LOGGING FILES for more details. • Banner page options have been enhanced. Job Owner Name justification has been added to HP’s NDPS banner page. Users can now choose the Job Owner Name value. See Section F. CONFIGURATION AND LOGGING FILES for more details. • Banner page selections now display correctly. • Cancel Job requests now function properly. • Console display errors were corrected. HP Printer Gateway statistics now display properly. • Corrected "Toner Out" reporting defect. • Host name resolution has been improved to align with the functionality of the Ping.nlm. If the HP Printer Gateway DNS issues still occur, the error message displayed on the console will include the associated Printer Agent to help pinpoint the problem. • 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. • The configuration snap-in interface for Windows clients now allows easier entry of IP addresses, host names, and IPX addresses. • The DNS name length has been increased to a maximum of 254 characters. • The printer agent “not bound” issue has been fixed under the following situations:

1. The Service Thread shuts down a printer agent prematurely when the HP Printer Gateway attempts to connect to the device and receives a connection refused or connection aborted message. An administrator may set the “Job retry timeout” entry to zero in the hpndps.ini file to eliminate this “not bound” situation.

2. The Job Monitor Thread shuts down a printer agent prematurely if the printer does not respond in a timely manner when queried for the PML index of the current job. An administrator may set the “Job monitor timeout” entry to zero in the hpndps.ini file to eliminate this “not bound” situation.

3. A print job is canceled before the HP Printer Gateway has a chance to open it. This returns a –811 error and the printer agent becomes “not bound”.

• HP Printer Gateway networking communication was converted from the NetWare TLI (Transport Level Interface) API (Application Program Interface) to the NetWare Winsock API.

• A control access printer can be created with a non-existing host name in the DNS table. This enables administrators to pre-configure printer agents prior to rolling into a production environment.

• Shutting down the HP Printer Gateway on a large network now does not hang the Gateway while it is running public access printer discovery.

• All IP-based printer agents with a “Timeout to close job” value of 50 seconds will be updated to a new default value of 3 seconds during the 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. However, some of these older print servers must be upgraded or replaced.

TCP/IP

To print through TCP/IP, this protocol must be supported on the HP Jetdirect print server. Most of the HP Jetdirect print servers support TCP/IP, with the exception of the HP Jetdirect 150X (HP product number J2592A) and some older single-protocol HP Jetdirect print servers.

To find out if IPX or TCP/IP is supported on an HP Jetdirect print server, print its configuration page.

D. NETWARE OPERATING SYSTEM AND CLIENT SUPPORTED BY THE HP PRINTER GATEWAY

The HP Printer Gateway supports the following Novell NetWare versions:

• NetWare 5.1 with support pack 6 or later • NetWare 6.0 with support pack 3 or later • NetWare 6.5

The HP Printer Gateway supports the following Novell Client software:

• Novell Client v3.32 with support pack 1 or later for Windows 95/98 • Novell Client v4.83 with support pack 1 or later for Windows NT, 2000 and XP

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. Otherwise, you may encounter an error similar to the following:

1. From a Windows 9x, NT 4.0, 2000, or XP client, log in as Administrator to the server.

2. Download/copy the appropriate installation file (hpgw300b_en.exe) to the hard drive of the client.

3. Run the installation file (hpgw300b_en.exe) to begin the installation process.

4. Click Next after reading the Welcome dialog box.

5. Click Yes to agree with the Software License Agreement.

6. Click OK for the warning about shutting down NWADMN32.EXE before continuing.

7. In the Path To Server dialog box, click Browse to select the path to the server (and to the Root directory of the Sys volume) on which you want to install this software. For the installation process to continue, the directories NDPS, PUBLIC, and SYSTEM must exist below the selected path.

8. Click YES to update the default value of “Timeout to Close Job” for the IP- based printer agents. - 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. In the Setup Complete dialog box, note the directory where this readme file and other support documents have been copied: Sys:\Public\hpgwdoc. Be sure to check for the latest updates and documentation on the HP website at http://www.hp.com/go/hpgate_sw.

12. Click Finish. This completes the installation process.

13. If the HP Printer Gateway NLM (HPGATE) and NDPS Manager NLM (NDPSM) are already loaded at the server, unload both: • unload ndpsm • unload hpgate

14. Load the NDPS Manager and HP Printer Gateway NLMs: • load ndpsm • load hpgate FILES PLACED ON THE NETWARE 5.x or 6.x SERVER

Default Path Description

Readme file for the HP Printer \Public\Hpgwdoc\Readhpgw.pdf Gateway (this file) HP Printer Gateway configuration \Public\Win32\Confighp.pd2 snap-in for the NetWare Administrator HP Printer Control snap-in for the \Public\Win32\Hpsnap.pc2 NetWare Administrator

\Public\Win32\Nls\English\Confighp.hlp Help file for Confighp.pd2

\Public\Win32\Nls\English\Hppcw32.dll Resource DLL file for Hpsnap.pc2

\Public\Win32\Nls\English\Hprwin32.dll Resource DLL file for Confighp.pd2

Configuration file (created after \Public\Win32\Nls\English\Confighp.ini configuring the HP Printer gateway) Windows program for update \Public\Win32\Hpgateupdatettcj.exe “Timeout to Close Job” value on multiple printer agents

\System\Hpgate.nlm HP Printer Gateway NLM

HP Printer Gateway configuration \System\Hpgconfg.pd0 snap-in for the NDPS Manager Configuration file (created after \System\Hpndps.ini configuring the HP Printer gateway)

\System\Nls\4\Hpgate.hlp Help file for Hpgate.nlm

Message file for Hpgate.nlm and \System\Nls\4\Hpgate.msg Hpgconfg.pd0 Error log for the HP Printer Gateway \Etc\Hpgerror.log (created by the HP Printer Gateway)

NOTE: No files are placed on the client during this installation process.

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.

Acceptable Default INI Section INI Entry Explanation Notes Values Values

0 - PA name (Printer Agent name) 1 - IPX network card address Gateway Printer List Sort Specifies which order to sort the 2 - IPX network number 0 - 5 0 Configuration Method printer agents for display purposes. 3 - IPX socket number 4 - IP address 5 - IP port Specifies which order to sort the Gateway Network List Sort 0 - # of hops network address numbers for display 0 - 1 0 Configuration Method 1 - network address number purposes. Specifies the maximum number of Gateway Max Service This value should never be less than the Min processes (threads) created to 1 - infinity 10 Configuration Processes Service Processes. process jobs. Specifies the minimum number of Gateway Min Service This value should never be more than the processes (threads) created to 1 - infinity 3 Configuration Processes Max Service Processes. process jobs. If the server performs many non-printing- related activities and few printing-related activities, a small timeout (1 minute) is a good estimate. If the server performs few non-printing activities and few printing-related Specifies the timeout (in minutes) that Service Thread Idle activities, then longer timeout values are Gateway job processes wait in an idle state Timeout (in 0 - infinity 60 better. If the server performs few non- Configuration before ending, until the Min Service minutes) printing-related activities and many printing- Processes number is reached. related activities, then larger timeout values (10 minutes) are preferred. If the server performs many non-printing-related activities and many printing-related activities, smaller timeout values are better. Acceptable Default INI Section INI Entry Explanation Notes Values Values

Gateway Sets error logging to the hpgerror.log 0 - disable error logging Enable Error Log 0, 1 1 Configuration file to on or off. 1 - enable error logging

1 - invalid option 2 - search all networks when requested by the user Public Access Specifies which search method to use 3 - search all networks on startup or when Printing Search Method when searching for PAPs (Public 2 - 5 4 requested by the user Configuration Access Printers). 4 - search only specified networks when requested by the user 5 - search only specified networks on startup or when requested by the user Public Access Specifies the search interval in Printing Interval seconds to wait between searches for 0 - infinity 0 None. Configuration PAPs. Specifies whether or not JetDirect Public Access Include Non DM devices that do not support Direct Printing Any number 0 0 - false, any other number - true. JetDirects Mode should be included when Configuration searching for PAPs. Specifies the timeout value given to Printer Gateway Socket timeout 0 - do not time out, and invalidates the sockets for read and write 0 - infinity 10 Defaults (in seconds) Socket retry count option. communication, given in seconds.

Printer Gateway Specifies the number of times to retry Socket retry count 0 - infinity 5 None. Defaults socket communication when it fails.

Printer Gateway Specifies the number of times to retry When all retries have failed, the printer agent Job retry count 0 - infinity 0 Defaults the processing of a job when it fails. will be shut down.

Specifies how long a job will be retried before shutting down the printer agent. The retry interval starts at two seconds and increases incrementally by Printer Gateway Job retry timeout 0 - retry indefinitely, the printer agent will not doubling the previous value until the 0 - infinity 900 Defaults (in seconds) resulting value is greater than or equal be shut down by the service thread. to the "Job retry timeout" value.

Acceptable Default INI Section INI Entry Explanation Notes Values Values

Specifies how long the job monitor 0 - the Job monitor will wait indefinitely, i.e. Printer Gateway Job monitor timeout thread in HP NDPS Gateway should 0 - infinity 900 the printer agent will not be shut down by the Defaults (in seconds) wait before shutting down the printer Job Monitor Thread. agent. Turns job monitor on or off. Speeds up Printer Gateway printing when disabled, however, this 0 – disable Enable job monitor 0, 1 0 Defaults does not reflect the true state reports 1 – enable by the printer device. 0 - nothing, Printer Gateway SAP Handler Specifies how to handle SAP'ing with 1 - turn sapping off on startup, 0 - 3 0 Defaults Default the printers. 2 - turn sapping on on shutdown, 3 - both 1 and 2. Specifies how often to check the Printer Gateway Status Update Time 900 seconds = 15 minutes, this time value printer status when not printing (with 0 - infinity 900 Defaults Not Printing Default will not be exact. SNMP) in seconds Specifies how often to check the Printer Gateway Status Update Time printer status when printing (with 0 - infinity 10 10 seconds, this time value will not be exact. Defaults Printing Default SNMP) in seconds Specifies the time of day to update the 0 - no update, Printer Gateway MOD Update Time MOD (managed object database) in 0 - 1440 1440 1 - 12:01 AM, 720 - 12:00 Noon, 1440 - Defaults Default minutes 12:00 Midnight, etc. The higher this number is, the lower the Specifies the maximum number of Printer Gateway Max Startup performance on a single CPU machine. A threads to use when starting more 1 - infinity 5 Defaults Threads good estimate is 5 times the number of than 1 gateway. CPUs. 0 - default HP banner page with Job Owner Printer Gateway Name and Job Name. Banner Option Specifies which banner option to use. 0 - 1 0 Defaults 1 - HP banner page with modified Job Owner Name, Job Name, and port option.

0 - right justification on the NDPS banner Printer Gateway Specifies which banner justification page, Banner Justification 0 - 1 0 Defaults option to use. 1 - left justification on the NDPS banner page. Acceptable Default INI Section INI Entry Explanation Notes Values Values

0 – default value of ,, Printer Gateway Banner Ownername Specifies how the job owner name is 0 - 2 0 1 - , Defaults Option displayed on a banner. 2 - ,. Specified Specifies the IPX network numbers 00000000 - %X is the entry number from 0 - infinity. The Network Entry_%X that should be searched when looking None FFFFFFFF entry number is also the search order. Addresses for PAPs, given in hexadecimal.

Sample hpndps.ini File:

[Gateway Configuration] Printer List Sort Method=5 Network List Sort Method=1 Max Service Processes=50

[Public Access Printing Configuration] Search Method=5 Interval=55

[Printer Gateway Defaults] SAP Handler Default=0 Status Update Time Not Printing Default=900 Status Update Time Printing Default=10 MOD Update Time Default=10 Banner Option=0 Banner Justification=1

[Specified Network Addresses] entry_0=5906fffe entry_1=00001045

HP Printer Gateway errors are logged in the file hpgerror.log, located in the \etc directory.

G. SPECIAL NOTES

• To extract the HP Printer Gateway files without installing on a Netware server: 1. Create a temporary directory, for example my_temphpg, on a client machine. 2. Next, create three directories called ndps, public, and system under the newly created temporary directory. 3. Execute the HP Printer Gateway installation program. 4. When asked to select a Destination Folder during the installation process, click the Browse button and choose the temporary directory that just created. 5. After the installation is completed, all the HP Printer Gateway files can be found under the newly created temporary directory tree, e.g. my_temphpg.

• 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.0, increase the Timeout to close job value on the printer agent. Increasing the timeout value will increase the delay between jobs and will ensure that complete jobs will be printed. The Timeout to close job value can be found on the HP Gateway Parameter console screen. This problem is due to a known issue in Novell’s Winsock implementation; please refer to Novell’s latest winsock patch. Note: Some customers have been successful at running the pre-release version of HP Printer Gateway 3.00a. However, NetWare 5.0 is not supported in HP Printer Gateway version 3.00a or greater.

• Job monitoring is a special feature that requires additional time to process each print job. It takes an additional 5 to 10 seconds for the job monitor thread to communicate with the printing device at the end of a job. To enable job monitoring, go to the Novell console and select the printer agent on the hp gateway screen. Edit the setting of the printer agent to enable job monitor. This modification is required for each printer agent.

• Not all HP printers support job monitoring, especially the low-end models, such as CP 1700. If a printer does not support job monitoring but job monitoring is enabled, one of the known symptoms will be print jobs stuck in the print queue.

• If you do not have Novell’s support pack 3 for NetWare 6.0 or support pack 6 for NetWare 5.1 installed on your system you might lose part of the print job. This incomplete-print job problem can be prevented by increasing the Timeout to close job value. From the Novell server console, select the printer agent on the HP gateway screen and edit the setting of the printer agent to increase the Timeout to close job value.

• If you experience “not bound” issues, change the “job retry timeout” and the “job monitor timeout” values in the hpndps.ini file to zero.

• Some printers, such as Color Laserjet 4550, may not go into powersave mode after they are configured in the HP Printer Gateway. To work around this problem, change the monitoring update interval while not printing to 00:00:00 or to a value higher than the powersave timeout.

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. Select those Printer Agents, in which you wish to update the “Timeout to Close Job” value.

6. You may change the new “Timeout to Close Job” value by increasing or decreasing the New Timeout to Close Job Value. We recommend the default timeout value of 3 seconds to minimize delays between print jobs.

7. Click the Update Timeout Values button to update the values.

Bench Mark: It took 10 minutes to update 600 printer agents (one second per printer agent) on a 2.4 GHz single processor machine running NetWare 6.0 support pack 3.

Note: This program is run automatically during upgrade of HP Printer Gateway version 3.00a or greater. The previous default value of 50 seconds for the “Timeout to Close Job” will be updated to the new default value of 3 seconds for all IP-based printer agents unless the user chooses not to do so.

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 . Explanation – The HP Printer Gateway fails to cancel a job due to a NULL (non existent) job pointer. This results from shutting down the printer agent while the job is printing. What to do – Restart the printer agent.

3) Open DRM sending data failed with -1 on Explanation - The printer agent fails to transfer data to the given IPX address. Other messages that give a specific Winsock error code explaining why the HP Gateway fails usually accompany this message. What to do – Power cycle the printer and restart the printer agent.

4) Sending data failed with unknown error of 10057 on Explanation – The HP Printer Gateway fails to transfer data due to no socket connection. According to the Microsoft documentation, this error message (10057 is WSAENOTCONN) is defined as follows: “The socket is not connected (connection-oriented sockets only)”. What to do – Power cycle the printer and restart the printer agent.

5) Unknown error of -1 from request handler on Explanation – The HP Printer Gateway fails to request more data from the NDPSM. This results from shutting down the printer agent while it is printing a job. One or more messages usually accompany this message. What to do – Restart the printer agent.

6) Job aborting failed with no job on Explanation - The HP Printer Gateway attempts to abort a job but encounters a NULL (non existent) job pointer. What to do – Restart the printer agent.

7) hpGateJobState_RequestingDocData no job ptr on Explanation – It fails to retrieve additional data from the NDPSM because the HP Printer Gateway does not have a valid job pointer. What to do – Restart the printer agent.

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. At this time, the HP Printer Gateway attempts to transfer the job node from a job queue to the Job Monitor queue. The transfer of the node failed unexpectedly. What to do – Restart the HP Gateway.

10) hpGateEnQ - NULL job queue head. Explanation – The HP Printer Gateway fails to transfer a job node from the job node queue to some other queue (for example, the Job Monitor queue). What to do – Restart the HP Gateway.

11) Unknown return value from job monitor on with job state 16. Explanation – This problem results from unexpected circumstances occurring within the HP Printer Gateway. What to do – Record all steps necessary to accurately reproduce this problem. Then contact Technical Support.

12) Open DRM Open WS failed with -1 on Explanation – The HP Printer Gateway fails to establish a direct request mode connection with the given IPX address. Another specific WinSock error code message will typically precede this error message. What to do - Power cycle the printer and restart the printer agent.

13) IPX connect failed with 10061 on Explanation - The HP Printer Gateway fails to establish a connection to the device for one or more reasons. According to the Microsoft documentation, this error message (10061 is WSAECONNREFUSED) is defined as follows: “The attempt to connect was rejected”. What to do - Power cycle the printer and restart the printer agent.

14) Unknown return value from job monitor on with job state 26848. Explanation – This problem results from unexpected circumstances occurring within the HP Gateway. What to do - Record all steps necessary to accurately reproduce this problem. Then contact Technical Support.

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.

16) Processing doc data open ws connection failed with -1 on Explanation – The HP Printer Gateway fails to transfer data to the given printer agent. Another specific error message will typically precede this error message. What to do - Power cycle the printer and restart the printer agent.

17) Sending data failed with WSAETIMEDOUT and retry count of 5 met on Explanation – The HP Gateway fails to transfer data to a respective host and the WinSock connection times out. WSAETIMEDOUT is a WinSock error code with a value of 10060. What to do - Power cycle the printer and restart the printer agent.

18) Unknown return value from job monitor on with job state - 2400. Explanation – This problem results from unexpected circumstances occurring within the HP Printer Gateway. What to do - Record all steps necessary to accurately reproduce this problem. Then contact Technical Support.

19) Sending data failed with unknown error of 10053 on Explanation – The HP Printer Gateway fails to transfer data to a given printer agent. According to the Microsoft documentation, the error message (10053 is WSAECONNABORTED) is defined as follows: “The virtual circuit was terminated due to a time-out or other failure.” What to do - Power cycle the printer and restart the printer agent.

20) hpGateJPMCall received when JPM Calls disabled: idx, cmd, jpmptr = Explanation - The hpGateJPMCall is the HP Printer Gateway interface into the NDPS manager. Disabling calls to this function (usually because the printer agent is shutting down) results in this error message. Idx is the index into the array of the HP Printer Gateway pointers. cmd is the command code that HP Printer Gateway will pass to the NDPS manager. jpmptr is a pointer to a data structure that the HP Printer Gateway will pass to the NDPS manager. What to do – Restart the printer agent.

21) 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.

22) Job Monitor Get PML Index failure with -1 for 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.

23) Unknown return value from job monitor on with job state 1024. Explanation - This problem results from unexpected circumstances occurring within the HP Printer Gateway. What to do - Record all steps necessary to accurately reproduce this problem. Then contact Technical Support.

24) HPGATE: - 0 Severity:1 Explanation - 1 is an error number used in the code; it is also the SEVERITY_WARNING value. All errors associated with this message should be considered a WARNING. What to do - This format of a message is seen with every entry in the error log file. It can safely be ignored.

25) Open WS Connection Mode failed for with -1. Explanation - The HP Printer Gateway fails to open a socket connection to the printer agent. One or more error messages usually accompany this. What to do - Power cycle the printer and restart the printer agent.

26) HPGATE.NLM default case reached in hpGateJPMErrorHandler returnCode = - 812 Explanation - -812 is NDPS_E_OBJECT_NOT_FOUND. The HP Printer Gateway attempts to set a value in the Managed Objects Database for an attribute that is not registered with that particular printer agent. What to do – Record all steps necessary to accurately reproduce this problem. Then contact Technical Support.

27) IP connect failed with 10053 on Explanation - The HP Printer Gateway fails to establish a connection to the given host on the given port. According to the Microsoft documentation, the error message (10053 is WSAECONNABORTED) is defined as follows: “The virtual circuit was terminated due to a time-out or other failure.” What to do - Power cycle the printer and restart the printer agent.

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. What to do – Record all steps necessary to accurately reproduce this problem. Then contact Technical Support.

29) Command line argument "" unknown for PA: Explanation – The HP Printer Gateway does not parse the command line arguments (load string arguments) properly. What to do – Record all steps necessary to accurately reproduce this problem. Then contact Technical Support.

30) GetJobPMLIndex get next for JobAttr Info Tree 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 to go into “Not Bound”. This typically occurs on extremely busy networks or on older devices. What to do - Record all necessary steps that are required to accurately reproduce this problem then contact Technical Support.

31) Uknown return value from job monitor on with job state 32192. Explanation - This problem results from unexpected circumstances occurring within the HP Gateway. What to do - Record all steps necessary to accurately reproduce this problem. Then contact Technical Support.

32) HPGATE: - 0 Severity:3 Explanation - 0 is a code error number’; 3 is the SEVERITY_CRITICAL value. What to do - Pay attention to the error message after this line.

33) GetJobPMLIndex Jobinfo attr tree getnext returned error status 1005 for Explanation - 1005 is ERR_OTHER. The printer responds with a value “other error” to the HP Printer Gateway’s SNMP request. During the Job Monitor phase, the HP Printer Gateway requests for the PML index from the printer. However, the printer does not respond with an expected result, which may cause the printer agent to go into “Not Bound”. What to do - Record all steps necessary to accurately reproduce this problem. Then contact Technical Support.

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. The printer responds with a value “other error” to the HP Printer Gateway’s SNMP request. During the Job Monitor phase, the HP Printer Gateway requests for the PML index from the printer. However, the printer does not respond with an expected result, which may cause the printer agent to go into “Not Bound”. What to do - Record all steps necessary to accurately reproduce this problem. Then contact Technical Support.

37) HPGATE: - 256 Severity:3 Explanation - 256 is a code error number; 3 is the SEVERITY_CRITICAL value. What to do - Pay attention to the error message after this line.

38) IP connect failed with 10054 on Explanation - The HP Printer Gateway attempts to open a connection to a given device on a given port, but the connection is reset during the process. According to Microsoft documentation, this error message (10054 is WSAECONNREST) is defined as: “The connection has been broken due to keep-alive activity detecting a failure while the operation was in progress.” What to do - Power cycle the printer and restart the printer agent.

39) Requesting doc data failed on request doc data for Explanation - The HP Printer Gateway fails to retrieve document data from the NDPSM. This is usually accompanied by another error message. What to do - Restart the printer agent.

40) Sending data failed with unknown error of 10054 on Explanation - The HP Printer Gateway attempts to send data to the given device on the given, but the connection is reset during the process. 10054 is WSAECONNREST, which the Microsoft documentation defines as: “The connection has been broken due to keep-alive activity detecting a failure while the operation was in progress.” What to do - Power cycle the printer and restart the printer agent.

41) hpGateJPMCmdProcessor - hpGateJobState_ProcessingDocData failed for Explanation - The HP Printer Gateway fails to send data to a given printer agent. This is usually accompanied by another error message. What to do - Restart the printer agent.

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.

43) GetJobState SNMPGet returned error status 2008 for 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.

44) Request Doc Data submit buffer returned -1 on Explanation - The HP Printer Gateway fails to transfer a data buffer to the NDPSM. This is usually accompanied by another error message. What to do - Restart the printer agent.

45) hpGateJobState_Aborting Unbound PA detected for Explanation - User attempts to abort a job on a given printer agent that is not bound to the NDPSM. What to do - Restart the printer agent.

46) Request Doc Data submit buffer returned -827 on Explanation - -827 is NDPSM_E_PSM_GOING_DOWN. The HP Printer Gateway requests document data from the NDPSM while it is shutting down. What to do - Restart the NDPSM.

47) hpGateGetPDEFbyPTYPE returned a failure status. Explanation – The HP Printer Gateway fails to locate a printer definition file based on some information (printer type) that it received from the command line or from the device. What to do - Record all steps necessary to accurately reproduce this problem. Then contact Technical Support.

48) IP connect failed with 11001 on Explanation - 11001 is WSAHOST_NOT_FOUND. The HP Printer Gateway fails to locate a hostname on a given host. What to do - Make sure the entry is in a DNS server that is accessible to the NetWare server. 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. What to do - Restart the printer agent.

51) hpGateJobState_ProcessingDocData - has connection problems. Explanation - The HP Printer Gateway fails to connect to a given printer agent. What to do - Power cycle the printer and restart the printer agent.

52) Command line argument unknown. Explanation - On startup the HP Printer Gateway receives an argument that does not parse properly. What to do - Record all steps necessary to accurately reproduce this problem. Then contact Technical Support.

53) HPGATE: - 89 Severity:3 Explanation - 89 is a code error number; 3 is the SEVERITY_CRITICAL value. What to do - Record all steps necessary to accurately reproduce this problem. Then contact Technical Support.

54) Open WS Connection failing with -1 socket for . Explanation - The HP Printer Gateway fails to establish a connection to a given printer agent. What to do - Power cycle the printer and restart the printer agent.

55) WinsockInetAddr failed with 10060 on Explanation - WinsockInetAddr is the function that attempts to convert an Internet address to an IP address. If it fails, the function attempts to locate the address in the DNS server. 10060 is WSAETIMEDOUT (see previous entries for meaning). The HP Printer Gateway times out when attempting to locate the hostname in the DNS server. What to do – Make sure the DNS server is accessible and that the NetWare server can communicate with it.

56) Open DRM failed with DRM not supported on Explanation - The HP Printer Gateway attempts to open a Direct Request Mode connection with the device, which responds with “Direct request mode not supported.” What to do - HP Gateway only supports Direct Request Mode connections for IPX/SPX devices. Configure the JetDirect properly or change the JetDirect card to one that supports Direct Request Mode.

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. Because sharing among processes may not be the cause of this error, it may be helpful to use a network trace. For further assistance, contact Technical Support.

58) Open DRM failed with not accepting new connections on Explanation - The HP Printer Gateway attempts to establish a Direct Request Mode connection with the device, which responds with “Not accepting new connections.” What to do - Investigate why the device is not accepting new connections. For example, the printing device may be sharing with other processes, such as a process from a Windows operating system. Because sharing among processes may not be the cause of this error, it may be helpful to use a network trace. For further assistance, contact Technical Support.

59) Open DRM failed with on . Explanation - The HP Printer Gateway attempts to establish a Direct Request Mode connection with the device, which responds with an ambiguous error code. What to do - Record all steps necessary to accurately reproduce this problem. Then contact Technical Support.

I. SOFTWARE LICENSE AGREEMENT

HP Software License Terms

The following License Terms govern your use of the accompanying Software unless you have a separate signed agreement with HP:

License Grant. HP grants you a license to Use one copy of the Software. "Use" means storing, loading, installing, executing, or displaying the Software. You may not modify the Software or disable any licensing or control features of the Software. If the Software is licensed for "concurrent use", you may not allow more than the maximum number of authorized users to Use the Software concurrently.

Ownership. The Software is owned and copyrighted by HP or its third party suppliers. Your license confers no title to or ownership in the Software and is not a sale of any 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. You may not disassemble or decompile the Software unless HP's prior written consent is obtained. In some jurisdictions, HP's consent may not be required for limited disassembly or decompilation. Upon request, you will provide HP with reasonably detailed information regarding any disassembly or decompilation. You may not decrypt the Software unless decryption is a necessary part of the operation of the Software.

Transfer. Your license will automatically terminate upon any transfer of the Software. Upon transfer, you must deliver the Software, including any copies and related documentation, to the transferee. The transferee must accept these License Terms as a condition to the transfer.

Termination. HP may terminate your license upon notice for failure to comply with any of these License Terms. Upon termination, you must immediately destroy the Software, together with all copies, adaptations and merged portions in any form.

Export Requirements. You may not export or re-export the Software or any copy or Adaptation in violation of any applicable laws or regulations.

U.S. Government Restricted Rights. The Software and any accompanying documentation have been developed entirely at private expense. They are delivered and licensed as "commercial computer software" as defined in DFARS 252.227-7013 (Oct 1988), DFARS 252.211-7015 (May 1991) or DFARS 252.227-7014 (Jun 1995), as a "commercial item" as defined in FAR 2.101(a), or as "Restricted computer software" as defined in FAR 52.227-19 (Jun 1987) (or any equivalent agency regulation or contract clause), whichever is applicable. You have only those rights provided for such Software and any accompanying documentation by the applicable FAR or DFARS clause or the HP standard software agreement for the product involved.

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. TRADEMARKS

• Novell(R), NetWare(R), IPX(tm), NetWare Loadable Module(tm), NLM(tm), Novell Distributed Print Services(tm), NDPS(tm), and Novell Client(tm) are either registered trademarks or trademarks of Novell, Inc.

• Windows 95(R), Windows 98(R), Windows NT(R), Windows 2000(R), Windows XP(R) and Windows(R) are U.S. registered trademarks of Microsoft Corp.