Download  Print this page

Xerox DocuPrint N4025 User Manual

Enterprise printer platform for windows nt and windows 95/98
Hide thumbs


Xerox PrinterMap
Enterprise Printer Platform
Version 1.3
User Guide for Windows NT and Windows


Table of Contents

  Related Manuals for Xerox DocuPrint N4025

  Summary of Contents for Xerox DocuPrint N4025

  • Page 1 Xerox PrinterMap Enterprise Printer Platform Version 1.3 User Guide for Windows NT and Windows 95/98...
  • Page 2 XEROX, The Document Company, the stylized X, and CentreWare DP, are trademarks of Xerox Corporation or its subsidiaries. Lexmark and MarkVision are trademarks of Lexmark International, Inc. HP and JetAdmin are trademarks of Hewlett-Packard Company. Microsoft, Microsoft Windows, Windows NT, Windows 95/98, MS, and MS-DOS are trademarks of Microsoft Corporation.
  • Page 3: Table Of Contents

    Contents Contents List of Figures ... vi List of Tables ... ix Preface ...x Chapter Overview ... xi Who should Use this Guide ... xi Conventions Guide ... xi Mouse Conventions... xii Related Reading ... xii Workstation Requirements ... xii Hardware ...
  • Page 4 Discover Configuration ... 22 IP... 23 IPX ... 24 Community Strings... 25 Operation ... 27 Advanced Configuration Issues... 30 Supported Vendors and Printer Models ... 30 Chapter 4 User Interface ... 3 Topology Overview... 35 Menu Bar Items... 36 File... 36 Topology ...
  • Page 5 Adding and Deleting Managed Printers... 51 Adding Printers to PrinterMap... 51 Deleting Printers from PrinterMap... 51 Right-Click Menus ... 51 Printer Icon Right-Click Menu ... 51 Topology Right-Click Menu... 54 Additional Functionality ... 55 Adding Printers to Groups through Drag and Drop ... 55 Selecting Multiple Printers...
  • Page 6 Status / Alarm Problems ... 81 Icons Not Changing Color According to Status: ... 81 Alarms Not Being Received in Alarm Log Window ... 81 Alarm Reads “Invalid Alarm Value from Printer”... 81 No Pop-ups or Application Launches Occurring ... 81 Reporting Problems... 82 Standard Reporting Reports ...
  • Page 7: List Of Figures

    Figure 28 Edit Serial Number window ... 50 Figure 29 Printer Icon Right-click Menu ... 51 Figure 30 Generate Report sub-menu... 52 Figure 31 Add Printer(s) to Group dialog ... 54 Figure 32 Remove Printer dialog... 54 Figure 33 Topology Right-Click menu ... 55 Figure 34 Group Right-Click menu ...
  • Page 8 Figure 41 Impending Loss of Information window ... 70 Figure 42 Upcoming Loss of Information – Details window... 70 Figure 43 Individual Printer Alarms window ... 73 Figure 44 Alarm Log window ... 75 Figure 45 Alarm log – Acknowledge window ... 76...
  • Page 9: List Of Tables

    Table 5 Attribute List ... 44 Table 6 Predefined Groups ... 46 Table 7 Printer Icons ... 47 Table 8 Printer Status to Icon Color Mapping... 48 Table 9 Printer Status to Icon Color Mapping... 60 Table 10 Alarm Condition to Status Color Mapping... 74 Table 11 Processes Eligible for Debug ...
  • Page 10: Preface

    Preface This user guide details the installation, configuration, administration, and operation of Xerox PrinterMap. Working knowledge of your network environment, infrastructure, and the operating system of the client workstation (Windows95 or NT) is assumed. PrinterMap User Guide...
  • Page 11: Chapter Overview

    Chapter Overview Chapter 1 Chapter 2 Chapter 3 Chapter 4 Chapter 5 Chapter 6 Chapter 7 Who should Use this Guide This guide is designed as a tool for the following personnel: • System Administrators • Network Technical Support Personnel Conventions Guide The following table explains the typographic conventions used in this guide.
  • Page 12: Mouse Conventions

    2. Press indicates you must keep the button pressed until the desired action is achieved. Related Reading To gain a broader understanding of topics covered in this guide, the user should be familiar with material relating to the following printer management applications. 1. Xerox CentreWare DP 2. HP JetAdmin 3. Lexmark MarkVision 4.
  • Page 13: Projecting Discover Time

    Each managed printer requires a static amount of reporting and status information. Reporting Allow for an additional 412Kb per managed printer to support reporting data. Option This covers a rolling two-year span of data. Please note that this space is Enabled allocated for each printer when it is discovered.
  • Page 14 100 SNMP queries for ifPhysAddress MIB value (MAC address) Final Poll: What else can we find out about this printer? 40 SNMP queries of the Xerox printers for xcmiHrDevInfoSerialNumber MIB value (Serial Number) 100 SNMP queries for hrDeviceStatus MIB value (Device Status)
  • Page 15: Conclusion

    100 SNMP queries for prtMarkerCounterUnit MIB value (Impression Count Units) 100 SNMP queries for prtMarkerLifeCount MIB value (Lifetime Impression Count) 400 SNMP queries for prtMarkerSuppliesSupplyUnit MIB value (Toner level units) 400 SNMP queries for prtMarkerSuppliesMaxCapacity MIB value (Toner level max) 400 SNMP queries for prtMarkerSuppliesLevel MIB value (Current supply/toner level) 400 SNMP queries for prtInputCapacityUnit MIB value (Paper level units)
  • Page 16 Based on this scenario, if you were to support 100 printers with 1 hour status and reporting intervals you can expect approximately 640 kb of traffic per hour on your network from PrinterMap. This traffic can be more than offset by proactively fixing parameters before several users send multiple jobs to non-functioning printers.
  • Page 17: Chapter 1 Overview

    Chapter 1 Overview Xerox PrinterMap is an administrative and management software platform providing access to a heterogeneous printer environment at the enterprise level. PrinterMap delivers expanded capacity for network personnel by giving the operator a graphical topology, and granting easy access to status and report information for every SNMP-enabled enterprise network printer.
  • Page 18 Reconfigure specific printers Single tool for the network administrator to view the SNMP based printer fleet Single point focus for managing SNMP based Xerox, HP, Lexmark, Tektronix, Olivetti and generic network printers Network administrators are proactive in managing enterprise printer environment...
  • Page 19: How It All Works

    Detected alarms may be logged, triggered by a notification Pop-up window or launched by another application. Reporting data is used to generate printer reports. Generated reports are printed or exported to comma-delimited format files for later import into third party database or spreadsheet software packages.
  • Page 20: Printermap Components

    PrinterMap Discover finds the SNMP enabled network printers within the Discover configured discover scope and builds a printer information database. This database is used by PrinterMap for displaying printers and printer status in the main topology window. PrinterMap’ s Report function configures how often printer report data is collected.
  • Page 21 There is an interface to launch any managed printer management application. PrinterMap’ s Status function allows configuration of how often printer status and Status alarm information is collected. It also polls printers for status and alarm information at the configured interval, carries out automated alarm responses, and triggers PrinterMap Topology status refreshes.
  • Page 22: Chapter 2 Getting Started

    Chapter 2 Getting Started This chapter covers the following topics: • Installing PrinterMap • Starting PrinterMap • Configuring PrinterMap • Running the PrinterMap discover process for the first time • Shutting down PrinterMap. PrinterMap User Guide...
  • Page 23: Printermap Installation

    • Uninstalling PrinterMap NOTE: Installation on a Windows NT machine requires administrator authority Loading PrinterMap Files The PrinterMap Windows (95, NT) software is available on the Xerox DocuPrint Services PRINTMAP.EXE. Follow the steps below to run PrinterMap’ s installation program:...
  • Page 24 Uninstall PrinterMap Under Windows NT, the Status and Reporting services are registered as NT services and therefore do not appear in the Xerox PrinterMap program group. The Setup Complete screen is displayed. At this point PrinterMap installation is complete. By default the “View Readme file now” and “Launch PrinterMap now”...
  • Page 25: Printermap Re-Installation

    Programs >Xerox PrinterMap > Uninstall PrinterMap. The uninstall program may also be launched by selecting Add/Remove Programs from the Control Panel and choosing Xerox PrinterMap. On an NT 3.51 machine, double-click the PrinterMap uninstall icon located in the PrinterMap program group.
  • Page 26: Running Printermap For The First Time

    By default, the install program starts the PrinterMap user interface (Topology window). Selecting PrinterMap from the Xerox PrinterMap program group is another way to get started. The first time the PrinterMap Topology window is started a welcome screen is Welcome displayed.
  • Page 27: Figure 3 Discovery Required Window

    Select the OK button or Apply and Cancel buttons to apply any configuration modifications and exit the PrinterMap Configuration window. Following configuration, PrinterMap displays the Discovery Required window. Discovery Running the Discover process is a prerequisite to managing network printers. Required Window Figure 3 Discovery Required window...
  • Page 28: Configuring Printermap

    Configuring PrinterMap PrinterMap can set a variety of parameters to customize its behavior. Additionally, several parameters, such as those related to discovery, must be set before performing certain functions. PrinterMap’ s Configuration window provides an intuitive interface for setting these parameters. To access the PrinterMap Configuration window, select File >...
  • Page 29: Configuration Window Panels

    NOTE: After PrinterMap is installed for the first time a Welcome screen is Figure 4 PrinterMap Configuration window Configuration Window Panels This section contains Configuration window panel descriptions. Discover The Discover Configuration window provides an interface for customizing PrinterMap’ s discover process. Refer to “Discover Configuration” in Chapter 3 for information on configuring PrinterMap’...
  • Page 30: Alarm

    The Alarms Configuration window allows PrinterMap customizing for handling detected printer alarms. PrinterMap can be configured to log the alarm. It can also launch a Pop-up window notification, or launch an executable. More than one action can be configured for a single alarm.
  • Page 31: Figure 6 Alarm Notification Pop-Up Window

    Pop-up window when the specified condition occurs. Figure 6 Alarm Notification Pop-up window The alarm notification Pop-up window describes when an alarm occurred, which printer issued the alarm and the alarm type. Select the window. NOTE: When configuring PrinterMap be certain to generate alarm pop-up...
  • Page 32: Status

    Check the corresponding box and slide the bar to adjust the polling interval for Minutes (1 - 59), Hours (1 - 23), Days (1-31), or None. If none is selected, the topology icon colors and attribute values cannot represent current printer state. Changing status polling frequency in the Configuration window Status panel assures change takes place immediately.
  • Page 33: Figure 8 Application Configuration Window

    Properties window As such, the option normally available off the right-click menu Launch Application for a printer is not available, nor is it available from the main menu Tools Pulldown. Figure 8 Application Configuration window PrinterMap User Guide...
  • Page 34: Reporting

    The Reporting Configuration window allows customizing of how often printers are queried for reporting information and what information is included when generating printer reports. PrinterMap’ s reporting function may also be disabled. Figure 9 Reporting Configuration window A disable button is located at the very top of the Reporting Configuration window.
  • Page 35: Figure 10 Select Report Attributes Window

    NOTE: Selecting None for the Standard or Custom Report Polling Interval The Report Attributes button accesses the Select Report Attributes window. This Report is where the content of a Printer report may be modified. Name and Lifetime Attributes Impression Count are standard on every report. Information shown in the window below may also be included.
  • Page 36: Printermap Shutdown

    Make selections, then select the After all Reporting parameters are specified, select OK to apply the settings and close the window. Select Apply to apply the settings and continue displaying the window. Select Cancel to nullify settings and close the Reporting Configuration window.
  • Page 37: Chapter 3 Discover Process

    Chapter 3 Discover Process This chapter describes PrinterMap’ s discover process in detail. The discover process collects information from the SNMP enabled network printer’ s on the user’ s network. This chapter covers configuring the discover process and the discover process operation.
  • Page 38: Overview

    PrinterMap gathers configuration and status information via SNMP, adding it to the topology map with an appropriate icon. Depending on the support level of the discovered printer, PrinterMap associates the printer with an icon indicating its status, vendor and model type.
  • Page 39 Names more than the MIB II system name value, this box should be checked. After the discover process, PrinterMap resolves each discovered printer's IP address into its equivalent host name value. Choosing the Routers button retrieves another IP discover configuration window Routers with further choices for discovery via network routers.
  • Page 40: Ipx

    Server Name field. During discovery, PrinterMap identifies all Server NetWare printer objects on that server, confirms them to be network printers supported by PrinterMap, and adds them to the PrinterMap topology. The user may define additional NetWare server names, however PrinterMap only discovers PrinterMap User Guide cache.
  • Page 41: Community Strings

    PrinterMap then compares the Hops value associated with the NetWare server and if the printer’ s network number is farther away than the Hops value the printer is not discovered. The minimum hop count is 1 and the maximum is 15. By default the Hops value is set to the maximum value of 15.
  • Page 42: Figure 13 Community Strings Window

    Status and Reporting services in order to communicate and retrieve information from managed printers. The discover process updates the community string stored for each managed printer as well as discover any new printers as a result of community string additions. After changes...
  • Page 43: Operation

    Operation If the PrinterMap reporting feature is enabled, PrinterMap displays the Available Disk Space window at the beginning of the discover process. This window indicates how many printers can be discovered given the amount of disk space available. This window also indicates the total number of printers currently managed by PrinterMap and the amount of disk space consumed by the reporting data files.
  • Page 44: Figure 16 Not Enough Disk Space Notification Window

    Figure 16 Not Enough Disk Space Notification window During the discover process, PrinterMap displays an activity meter as well as the current state of the discover, such as the IP address range it is currently querying. The discover process may be cancelled at any time. The application window can be minimized for the duration of the discovery process by selecting the minimize button on the progress window.
  • Page 45: Figure 17 Discover Progress Window

    This occurs at the time of the next status poll to reflect the change in status. If PrinterMap is unable to determine the status of a network printer, the printer is added to the topology as a blue (unknown status) icon.
  • Page 46: Advanced Configuration Issues

    PrinterMap is shipped with a default set of printer models associated with each supported vendor. These vendor and model associations are defined in PrinterMap’ s Mib.ini file. Xerox printer model to icon associations are defined in PrinterMap’ s Pmap.ini file. The content of both of these files is loaded during PrinterMap initialization and are located in the PrinterMap install directory ([Drive]:\[Install Directory]).
  • Page 47 Each vendor section within the Mib.ini file follows the format shown in the sample Format text above. In this case the Xerox vendor has 5 valid MIB II System Object Identifiers (SysObjIDs) associated with it. Concatenated to the SysObjID is an integer value delimited by a colon (‘...
  • Page 48 Xerox-Generic icon is displayed. Models are mapped to icons based on the MIB II System Object Identifier. The Pmap.ini file is found in the [Drive]:\[Install Directory]\ directory. The [xerox_models] section of a sample Pmap.ini file follows.
  • Page 49: Table 3 Default Snmp Time-Out Values

    To edit the Pmap.ini file the user needs the System Object Identifier of the Xerox printer model being added and the name of the 5 icon files being used by PrinterMap to display the various printer status conditions.
  • Page 50 Chapter 4 User Interface This chapter covers PrinterMap’ s user interface. The PrinterMap Topology window provides a graphical representation of the user’ s network printers and access to a variety of useful information for managing those printers. This chapter takes a detailed look at the PrinterMap Topology window. PrinterMap User Guide...
  • Page 51: Topology Overview

    PrinterMap uses the MIB II sysName (system Name) value as the printer’ s display name. This can be changed so a printer's IP host name is used. Please refer to item 10 of this list (Default Display Name) for more information on changing the default display name setting.
  • Page 52: Menu Bar Items

    The possible values for default display names are System Name and Host Name. System name refers to the MIB II system name of the printer. Host name refers to the IP host name of the printer ( typically administered via DNS).
  • Page 53: Figure 20 Add Printer Window

    To add a printer, select Topology > Add Printer from the main menu and enter the printer’ s IP or IPX address in the Add Printer text box. After selecting the OK button, PrinterMap attempts discovering the printer at the specified address by issuing SNMP queries.
  • Page 54: Figure 21 Update Printer Information Window

    If a printer’ s system object id is found under one supported vendor in the Mib.ini file the printer is converted from Generic to the appropriate vendor type.
  • Page 55: Group

    PrinterMap has several pre-defined groups based on the supported vendor list (i.e., Create Group Xerox, HP, Lexmark, etc… )and the All Printers group. PrinterMap also supports creating user-defined groups. User-defined groups can be created by selecting printers from any existing group and selecting this menu item. The Create Group window prompts for the new group name.
  • Page 56: Figure 23 Delete Group Confirmation Dialog

    PrinterMap User Guide Only user-defined groups may be deleted. Pre-defined groups (All Printer, Xerox Only, etc… ) cannot be deleted. This menu item is grayed out when the focus if the printers cannot be added to a user defined group.
  • Page 57: Report

    All Printers group completely removes the printer from PrinterMap. The printer is removed from all groups where it is a member and any reporting data stored for this printer is deleted. Do not remove a printer from the All Printers group unless intending to remove it completely from PrinterMap.
  • Page 58: Tools

    The default management application for each vendor may be configured for any desired executable through the Application Paths Configuration window. Xerox CentreWare DP CentreWare DP is the default printer management application for Xerox printers. HP JetAdmin JetAdmin is the default printer management application for HP printers. Lexmark MarkVision MarkVision is the default printer management application for Lexmark printers.
  • Page 59: Help

    (depressed - default) or disabled (not depressed) icon sorting based on the attribute selected from the attributes list. Add printer manually - Selecting this button allows manual printer addition to the All group. Alarm log - Selecting this button displays the Alarm Log.
  • Page 60: Topology Viewing Areas

    The Topology is a map of discovered network printers represented as icons. Topology Printer specific actions are launched from the PrinterMap Topology window. The status, vendor and in some cases printer model are ascertained from the Topology window. NOTE: The Attributes list box allows printer attribute selection which is displayed Attributes beneath all printer icons in the topology area.
  • Page 61 Therefore, toner levels are displayed as “some”, indicating the printer knows that the toner cartridge is not empty, or “— “, indicating the printer doesn’ t know how much toner is remaining. For example, a printer having three toner cartridges may have a toner level string displayed as “21%, 76%,...
  • Page 62: Viewing Printer Information

    Status values include Running, Warning, Down, and Unknown. Printer’ s serial number. PrinterMap only supports this attribute for Xerox printers. A value of “N/A” is displayed for non Xerox printers or Xerox printers which do not support this attribute.
  • Page 63: Printer Groups

    Xerox Printers - Printers manufactured by Xerox are represented by a model specific icon image if PrinterMap has an icon for that model. If not, a generic Xerox icon is used. The DocuPrint N32 icon is shown here as an example of a model specific icon.
  • Page 64: Printer Status

    For example, if a printer is low on paper (a warning condition) and is also out of toner (a critical condition) the printer icon’ s color is set to Red. If the printer is low on both paper and toner the printer icon’...
  • Page 65: Printer Properties Window

    Vendor, Model, Impressions Count and Status. A printer’ s system name can be modified in this section. From the second window section, a printer’ s paper and toner level information is accessible. The Paper Level and Toner Level buttons displays this information in bar chart, percentage and unit count formats (when available).
  • Page 66: Figure 28 Edit Serial Number Window

    Properties window. Select Cancel to dismiss the window without making any changes. NOTE: Serial numbers and serial number manipulation are available only for Xerox Refer to “Launch Application” in Chapter 4 for more information on launching configured management applications.
  • Page 67: Adding And Deleting Managed Printers

    PrinterMap application by deletion from the All Printers group. If a printer is removed from the All Printers group, it is removed from all printer groups and all the printer’ s associated data (attribute information and reporting data files) are deleted.
  • Page 68: Figure 30 Generate Report Sub-Menu

    Status Configuration panel. NOTE: If the currently selected printer attribute is Status and the printer Selecting this menu item displays the alarms for the selected printer. This popup Show Printer window displays a printers’ detected alarms from the most recent PrinterMap Alarms status poll.
  • Page 69 If so, PrinterMap adds the appropriate management application path to the printer’ s management applications list (if the printer is not HTTP enabled or the printer’ s IP address is not available then this path becomes the printer’ s active management application).
  • Page 70: Topology Right-Click Menu

    In addition, the printer remains a member of the All Printer group as well as any other pre-defined groups it belongs to. If however a printer is removed from the All Printer group, the printer is removed from all printer groups where it is a member and all its associated data (attribute information and reporting data files) is deleted.
  • Page 71: Additional Functionality

    Printer Name Selecting this menu option brings up the default printer name selection sub-menu. The user may select either Host Name or System Name as the source for the PrinterMap default printer name. The default selection is System Name.
  • Page 72: Selecting Multiple Printers

    Holding down the Ctrl key, left-click on several printers, one at a time, until all desired printers are selected. Holding down the Shift key, left click on a printer then left click on another printer. All rectangular shaped printers in between are selected.
  • Page 73: Service Overview

    The Status and Reporting Service tasks run behind the scenes and periodically query printers via SNMP for current status and reporting information. Following a reboot the Status and Report polling services starts automatically. Printer information collected is stored in data files. These files are accessed by the PrinterMap Topology window and report generation processes.
  • Page 74: Figure 35 Service Control Window

    The Status and Reporting service icons only appear in the service tray if they are currently active. If neither service is currently running, select PrinterMap Services from the Start > Programs > Xerox PrinterMap menu to access the Service Control window.
  • Page 75: Status Function

    This information is viewed in the main Topology printer window. The Status Service detects and records printer alarms, and takes action on alarms as defined in the Configuration window Alarm panel. Refer to “Alarms” in Cahpter 6 for alarm information and configuring action(s) taken by PrinterMap when specific alarm conditions are detected.
  • Page 76: Icon Colors

    Red, Yellow, Green, and Blue, depending on the status of individual printers. If the status of a printer changes from one polling period to the next, the screen icon color changes to reflect the new status. The colors used are listed in the table...
  • Page 77: Reporting Service

    Reporting Service The PrinterMap report polling service (Reporting Service) periodically queries all managed printers on the network. Each printer provides information toner levels and lifetime impression count. This information is written to data files and used to generate reports.
  • Page 78: Figure 36 Reporting Configuration Window

    Figure 36 Reporting Configuration window Selecting the Disable button located at the top of this window accesses the Verify Disabling Reporting window. Figure 37 Verify Disabling Reporting Option window This window informs about the consequences of disabling the reporting function. After confirmation, PrinterMap no longer collects reporting data for managed printers.
  • Page 79: Enabling Reporting

    Generating Reports Single and Printer Group reporting can be accessed from Report > Generate [Custom or Standard] Report > [Selected Printer or Selected Group]. All reports filter out empty data arrays. For example, if generating a report from...
  • Page 80: Standard Reports

    When selecting Standard or Custom reports, specify reporting parameters on a window similar to the one shown. Select a printer or group for generating a report and the type of generated report. Respond to prompting by specifying the From and To time period for the generated report.
  • Page 81: Figure 38 Reporting Parameters Window

    Window time period (From and To values of the Reporting Parameters window). The report heading for single printer reports also contains the printer’ s name, model, and serial number (if applicable). Below is an example of a user generated standard report for the All Printers pre-defined group.
  • Page 82: Figure 39 Example Group Standard Report Window

    NOTE: Microsoft Excel may remove leading zeros from the serial number field Printing Reports Generated reports may be printed to any accessible local or network printer. By default, reports are printed in landscape format. The type of information contained in generated reports is highly configurable. The Report Attributes Content window is a sub-window of the Reporting Configuration window.
  • Page 83: Figure 40 Report Attributes Window

    Period Impressions This attribute displays the number of printer impressions created from one report entry to the next. A report’ s first Period Impression for a printer is always zero. Toner Level This attribute displays the toner percentage remaining in each toner cartridge. A printer may not provide enough information for PrinterMap to display a toner percentage.
  • Page 84 MAC Address This attribute displays the printer’ s MAC address. Model This attribute displays the model number of the printer and is only optional for group reports. Vendor Name This attribute displays the name of the printer’ s manufacturer and is only optional for group reports.
  • Page 85: Reporting Data Custodial Procedures

    Serial Number This attribute displays the Serial Number assigned to the selected printer. This is only applicable to Xerox printers and is only optional for group reports. A brief description of attributes that appear on all printed reports follows. Name This attribute assigns a name to the printer.
  • Page 86: Figure 41 Impending Loss Of Information Window

    Figure 41 Impending Loss of Information window After acknowledging this window, it reappears every seven days leading up to December 31 unless the Keep Showing This Warning box is unselected. The Details button accesses a window providing details about the impending data deletion.
  • Page 87 PrinterMap User Guide...
  • Page 88: Chapter 6 Alarms

    Chapter 6 Alarms This chapter provides information on how PrinterMap detects printer alarms, the conditions that constitute a printer alarm, how to view alarms for a particular printer or the alarm log, and how to configure automatic responses to alarms.
  • Page 89: Alarm Detection

    The PrinterMap Status Service periodically queries printers for current status and alarm information. The polling interval of the Status Service is configured through the Status panel of the Configuration window. When a printer reports an alarm condition the alarm information is recorded. Automated actions are launched when configured through the Configuration window Alarms panel.
  • Page 90: Table 10 Alarm Condition To Status Color Mapping

    PrinterMap is dependent on the printer notification implementation for severity indicators accuracy. For example, this occurs on the Xerox 4517 printer, where “No Paper” in the envelope feeder results in status indication of warning/yellow displayed on the topology map. The logged alarms are critical/red due to an open door.
  • Page 91: Figure 44 Alarm Log Window

    To display the alarm history log, select Tools > Display Alarm Log from the main menu. Figure 44 Alarm Log window Close Alarm Log Buttons Closes the Alarm Log window. Changes made to the alarm entries are saved. Export Saves the alarm log data into a comma-delimited file (*.csv). Default save directory for these files is [Drive]:\[Install Directory]\reports.
  • Page 92: Figure 45 Alarm Log – Acknowledge Window

    Figure 45 Alarm log – Acknowledge window This window prompts for a brief comment related to the resolution or acknowledgment of the selected alarm. All comments are displayed in the Comment column accompanied by a time stamp. Adding text is not required. In this case only the date and time stamp is displayed under the Comment heading.
  • Page 93: Chapter 7 Troubleshooting

    Chapter 7 Troubleshooting Consult this chapter for basic troubleshooting suggestions when experiencing operational problems with PrinterMap. This chapter explores troubleshooting techniques for the following areas. • Log Files and Debug Functionality • Discover • Status and Alarm • Reporting • Error Messages PrinterMap User Guide...
  • Page 94: Log Files And Debug Functionality

    Log Files and Debug Functionality When PrinterMap encounters a problem, a pop-up message appears referring the user to the pmap.log. which contains general application status messages. Several process-specific logs can be generated by activating PrinterMap's debugging facility, for which several debug levels are available. The application initialization file, [Drive]:\[nstall Directory]\pmap.ini contains debug parameter settings and can be edited using any standard ASCII file editor.
  • Page 95 A debug setting of 10 or higher initiates the *_dbg.log files. If debug is 0 for all processes, the only log maintained is pmap.log containing general status messages. Each log message is prefixed by the date/time of occurrence and name of the generated process.
  • Page 96: Discover Problems

    MIB browser. 4. If the printer is not listed as a MIB object value, Telnet to the router and issue a broadcast ping to update the router cache. 5. Ensure the correct Community String discover configuration option is set.
  • Page 97: Discover Doesn't Complete

    2. On Windows 95/98, verify that the PrinterMap Status icon appears in the system tray. If not, start the Status service by selecting the PrinterMap Status menu option under Start > Programs > Xerox PrinterMap. The Status service can also be started from the Service Control window.
  • Page 98: Reporting Problems

    On Windows 95/98, verify that the PrinterMap Reporting icon appears in the system tray. If not, start the Reporting service by selecting the PrinterMap Reporting menu option under Start > Programs > Xerox PrinterMap. The Reporting Service can also be started from the Service Control window.
  • Page 99 User Action None. Text XPC001 $function 1 failed calling $function 2. Variables $function1 - Error detecting function $function 2 - Failing function Description Function 1 detected that function 2 did not successfully complete. System Action Function dependent User Action Note accompanying error messages for the failure cause. Text XPC002 $function 1 failed calling $function 2, rc = $value...
  • Page 100 Text XPC004 $function 1 failed calling $function 2, reason = $reason Variables $function 1 - Error detecting function $function 2 - Failing function $reason - Failure cause Description Function 1 detected that function 2 did not successfully complete. A string containing the reason for the failure is returned.
  • Page 101 $case - Unexpected condition Description An unexpected condition of $case occurred. System Action Function dependent User Action Note how to reproduce this condition. Text XPC010 Unable to open file: $filename Variables $filename - Filename Description PrinterMap is unable to open specified file. System Action Function dependent User Action...
  • Page 102 Variables $filename - Log filename Description PrinterMap is unable to open the specified log file. System Action Function dependent User Action Check to be sure the [Drive]:\[Install Directory]\log directory exists. Check to see if the specified log file exists. Check permissions on the file. Text XPC013 Unable to find/process MIB.ini file.
  • Page 103 Check permissions on the file. Text XPC015 Unable to determine/assign proper debug level. Variables None Description PrinterMap is unable to determine desired debug level. System Action Debug is not activated for the module. User Action Check to be sure the [Drive]:\[Install Directory]\pmap.ini file exists. Check that variables in the debug section are topology, discover, accounting, and status.
  • Page 104 $function: Printer information files are currently locked. Variables $function - Function trying to write to printer information file Description PrinterMap cannot write to a printer information file, because another function locked the file. System Action Updated information is not written to the file.
  • Page 105 Variables None Description The product cannot allocate the memory necessary to perform some function. System Action Function dependent User Action Close other active applications. Text XPC025 $process not started; error creating initialization semaphore. Variables $process - Name of PrinterMap process encountering the error. Description Specified process encountered an error during initialization creating a named semaphore.
  • Page 106: Printermap Discover Error Messages

    License key retrieval failed, only Xerox printers are discovered. Variables None Description Because the Discover process cannot retrieve a valid license key, only Xerox network printers are discovered. System Action Non-Xerox printers are passed over by the PrinterMap discover process.
  • Page 107 None Description Discover process cannot retrieve valid SNMP time-out values from PrinterMap ini file ([Drive]:\[Install Directory]\pmap.ini). Either the pmap.ini file cannot be found or the SNMP time-out entries are corrupt or missing. The following are the SNMP time-out entries as they should appear in the [discover] section of the pmap.ini file (shown with default shipped values in hundredths of a second): snmp_get_local_timeout=40 snmp_get_remote_timeout=100...
  • Page 108 Description The discover process detects PrinterMap is configured to do an IPX network Discover. The local machine is not configured for IPX/SPX protocol support. The discover process cannot continue. System Action Discover process terminates. User Action Verify the PrinterMap discover process is configured correctly and/or the local machine is properly configured for the IPX protocol before attempting another PrinterMap discover.
  • Page 109 Verify the specified default gateway does have SNMP capable network printers which should have been discovered. Use the "ping" command from a DOS prompt to verify the printer(s) is/are responding. Verify that the default SNMP time-out values specified in the user's guide are adequate.
  • Page 110 Verify the specified IP address range does have SNMP capable network printers which should have been discovered. Use the "ping" command from a DOS prompt to verify the printer(s) is/are responding. Verify that the default SNMP time-out values specified in the user's guide are adequate.
  • Page 111 Text XPD015 Unable to initialize Netware API, return code: $value Variables $value - Hex return code from Netware API initialization call. Description Discover process is unable to initialize the Novell NetWare API needed to perform an IPX discover. System Action Discover process terminates.
  • Page 112 Discover process terminates. User Action Verify that Novell's Client32 software is installed and operational. Text XPD018 Unable to connect to Netware preferred server, return code: $value Variables $value - Hex return code from Netware call to connect to the specified NetWare preferred server name.
  • Page 113 PrinterMap discover process is unable to connect to the specified NetWare. (Accompanies XPD018) System Action Discover process terminates. User Action Verify the specified NetWare server is up and operational and the local machine has network connectivity to the server. Text XPD022 Invalid IP address format encountered, address: $ip_address Variables...
  • Page 114 Discover process encountered an invalid IP address. An octet of the specified IP address is out of range. System Action Discover process terminates. User Action Correct invalid IP address by replacing it with an IP address of the proper format as specified here.
  • Page 115: Printermap Reporting Service Messages

    User Action Verify the specified router IP address is correct. If not reconfigure PrinterMap Discover and rerun discover. Text XPD040 Unable to retrieve MAC address for printer at address: %sVariables Description System Action User Action PrinterMap Reporting Service Messages Text XPR001 Reporting poll cycle takes longer than configured polling interval.
  • Page 116 Variables None Description The Reporting service encountered an error condition. It cannot recover and is exiting. Reporting printer data is not collected until service is restarted. System Action Reporting service terminates. User Action Review the PrinterMap message log ([Drive]:\[Install Directory]\pmap.log) for accompanying error messages indicating the cause of error and takes corrective action.
  • Page 117 User Action If the Reporting Option is not enabled, visit the Configuration Window (Reporting tab) to enable it. The Reporting Polling process then starts automatically. Text XPR006 Unable to install $process - $ErrorReason. Variables $process - Name of PrinterMap process encountering the error. Description Attempted to install the service $process, but attempt failed.
  • Page 118 Text XPR009 OpenSCManager failed - $ErrorReason. Variables $ErrorReason - System-returned error message. Description Attempt to install a service failed: the system is unable to establish a connection to the Services Control Manager. The failure reason is found in $ErrorReason. System Action Attempt to install service is terminated.
  • Page 119 Variables $process - Name of PrinterMap service process. Description Repeated attempts to stop the service $process failed. System Action Continue with other processing in the context of the stop service request. User Action Review pmap.log to see the context of the failure. Text XPR013 $process removed.
  • Page 120 Variables None Description The user requested the Reporting Option be enabled. PrinterMap is unable to correctly locate the directory where printer information is stored. System Action The reporting option is enabled, but no reporting files are pre-created. User Action Verify all PrinterMap directories exist as installed.
  • Page 121 Enabling the Reporting Option is requested. It is unable to write information into the indicated file. The most likely cause is the disk is System Action Processing continues. The reporting option is enabled. User Action Verify the space available on the target drive. Text XPR513 $number Reporting Data Files Have Been Created.
  • Page 122 None Description The user requested the Reporting Option be disabled. PrinterMap is unable to correctly locate the directory where printer information is stored. System Action The reporting option is disabled, but existing reporting data files are not deleted. User Action Verify all PrinterMap directories exist as installed.
  • Page 123: Printermap Alarm Log Messages

    System Action Processing continues. The reporting option is disabled. User Action None. Text XPR519 %d Reporting Data Files Have Been Deleted. Variables $number is the number of files deleted. Description Disabling of the Reporting Options requested. This request automatically deletes any existing reporting data files.
  • Page 124 User Action Verify whether the file was locked by another process, whether the file was locked for an unusually long time and try again. Text XPA003 Unable to resume the $path file. Variables $path - Path of temporary alarm.log file used by PrinterMap. Description PrinterMap attempts the conversion process described in XPA001 by writing out the contents of the old alarm.log file in the new format to a temporary file named...
  • Page 125: Printermap Status Service Messages

    System Action PrinterMap attempts ignoring the corrupted entries. User Action Open the alarm.log file in a text editor and check if there are any invalid entries/characters in the file. The corrupted entries are deleted when any changes are saved to the file through the alarm log viewer Text XPA006 The $path file is corrupted.
  • Page 126 PrinterMap Status service terminating due to user request. Variables None Description The Status service is terminating due to a user initiated action. Printer status and data is not maintained dynamically until service is restarted. System Action Status service terminates. User Action Restart the Status service when it is desirable to begin monitoring printer status and data dynamically.
  • Page 127 Attempt to install service is terminated. User Action Review information in $ErrorReason. Verify all PrinterMap programs are correctly installed. Text XPS006 $process installed. Variables $process - Name of PrinterMap process. Description Service $process installation attempt is successful. System Action None. User Action None.
  • Page 128 Review information in $ErrorReason. Additional technical assistance may be required. Text XPS009 Stopping $process. Variables $process - Name of PrinterMap service process. Description Attempting to stop the service $process. System Action Continues trying to stop service. Publishes follow-up message XPS010 or XPS011.
  • Page 129 Variables $process - Name of PrinterMap service process. Description The service $process is removed from the list of services controlled by the Service Control Manager. System Action None. User Action This normally occurs within the context of disabling the Reporting Option. Text XPS013 DeleteService failed - $ErrorReason.