> cool solutions home   > cool tools home
Change the Host Device attribute value of a Print Server object without having to delete the object.
Reader Rating    from ratings rate this article
View a Printer Friendly Version of this Page Send this page to a friend
Posted: 25 Apr 2002
Created: 18 Aug 1999
File Size: 164KB
License: Evaluation
Download 1:  hostedit.zip
Download 2: hostedit.zip
Publisher: Peter Kuo, Ph.D., DreamLAN Network Consulting
E-mail: infoTAKETHISOUT@DreamLAN.com
Please read the note from our friends in legal before using this file.

The HostEditor utility can change the Host Device attribute value of a PrintServer object without having to delete the Print Server object and recreate it.In addition, this utility can change the Host Device/Host Server attribute valueof Directory Map, Print Queue, and Volume objects. As an added bonus, thisutility can be used to change the Volume and Queue Directory attributes of aPrint Queue object (for the purpose of "moving" a print queue from oneserver/volume to another)!

HostEditor is specifically designed to address the following four issues:

  • Print Server objects. (Per Novell TID# 2951096) When a print server object is created, a HostDevice will be assigned where the PSERVER.LOG file will be stored. The HostDevice will default to the creating user's Default Server (see User Details :Environment : Default Server in NWAdmin). If the user creating the Print Serverhas no Default Server, the Host Device will be the server in the same partitionas the Print Server that is closest to the top of the tree. If multiple serversexist in the same OU as the PSERVER, the PSERVER.LOG file will be created on theserver in that OU that is closest to the top of the tree. This "random"assignment of Host Device can result in one of the following error conditions:

    "PSERVER-4.10-214: The print server was unable to login to server <servername>specified in the print server's Directory Services (DS) attribute list as thehost device. Warning, the job audit logging feature may not function properly.Program execution may not continue normally."

    "PSERVER-4.10-29: A host device was not specified in the print server'sDirectory Services attribute list, the print server will attempt to use thelocal server as a host device. Warning, the job audit logging feature may notfunction properly. Program execution may not continue normally."

    One of these above errors will be displayed if the server that the HostDevice attribute of the Print Server is set to is not available or does notrespond (e.g. the server is down or that the server is across a WAN link and theWAN is down). HostEditor has been written to change the Host Device attribute ofthe Print Server to a different server. Prior to the availability of HostEditor,the only way to eliminate the above errors was to use Novell's HSTDEV utility(Novell TID# 2906116) or to delete the Print Server and recreate while onlyattached to the desired server.

  • Print Queue objects. In a recent server migration project, weneeded to move a large number of Print Queues from one server to a differentserver and to a different volume name. In order to not have to recreate theQueue objects, this utility was enhanced to allow the changing of Volume andQueue Directory attributes of a Queue object. This way, all you need is tocreate a QDR directory on the new server/volume with the same name as the oldone, change the Volume and Queue Directory attribute values in the Queue objectto point to the new server's Volume object, restart the Print Server and viola!(If you need to change a large number of queues, we're in the process offinishing up a pair of batch-mode based utilities so you can use text files todrive the changes. Stay tune!)

  • Directory Map objects. The additional support for Directory Mapobjects was added as a fix to the problem that occurred if a server that isreferenced by a DM object is deleted. When a DM is initially created, its HostSrever attribute value points to the server that hosts the Volume where the DM'spath is. If you later change the path setting, NWAdmin does not updatethe Host Server attribute. So if the server is later removed from the tree,Directory Map might get invalid mappings. (Novell DeveloperNet has a sampleapplication that does this--called D3MAPOBJ--but since its not supported, wedecided to add that functionality to HostEditor as well.) HostEditor verifiesthat the Host Server property matches the Path attribute and updates the HostServer attribute on request.

  • Volume objects. Every Volume object has a mandtory Host Serverattribute. If for some reason the server pointed to by this attribute isincorrect, this utility can make the change without you having to delete andrecreate the Volume object.

So, why HostEditor if there are already free Novell utilities that canperform similar tasks? Unlike HostDev and D3MAPOBJ, HostEditor is a supportedutility. HostEditor has been tested and extensively used in real-worldsituations. HostEdtior runs on Windows 9x and Windows NT workstations, usingClient32. Compairing to HostDev, HostEditor is very "lightweight"consisting of a single 32-bit Windows EXE that's only 400KB in size (c.f.HSTDEV.EXE which is 1MB in size). Furthermore, HostEditor can work with fourdifferent object types whereas HSTDEV and D3MAPOBJ are "single-typed".

What's New

  • Submitted to Novell for NetWare 5 certification.


  1. You can specify an object name by manually typing it in or use the browserbutton; the browsing starts at the workstation's current context. When manuallyentering the object name, ensure to use the absolute name path (i.e.starting with a leading period); the name can be typeful or typeless. The sameapplies to the server and volume names.

  2. After you have entered or browsed for the desired object (say, PrintQueue), you must "select" it and the current settings are displayed.

  3. If the object names for the "Current Host Value", "CurrentVolume Value", and "Queue Directory" are longer than can bedisplayed in their respective fields, simply move the cursor to the display boxand you can cursor-right to see the rest of the object name.

  4. Some of the options have tooltips and you can enable them by checking the "Showtooltips" box at the bottom of the dialog screen.