NOVELL TECHNICAL INFORMATION DOCUMENT TITLE: NetWare Server Tools v2.15 TID #: 2958910 README FOR: etbox7.exe SUPERSEDES: etbox6.exe NOVELL PRODUCTS and VERSIONS: NetWare 4.2 NetWare 5.1 ABSTRACT: TOOLBOX.NLM provides various utility functions to be executed on the server console or via NCF files (without involving any clients). Please read the Known Issues and FAQ sections (below) before reporting problems. NOTE: This utility helps system administrators and developers. It is provided free of charge as a courtesy, and therefore, is not a Novell supported product. 8/20/2004 change in readme only ----------------------------------------------------------------- DISCLAIMER THE ORIGIN OF THIS INFORMATION MAY BE INTERNAL OR EXTERNAL TO NOVELL. NOVELL MAKES ALL REASONABLE EFFORTS TO VERIFY THIS INFORMATION. HOWEVER, THE INFORMATION PROVIDED IN THIS DOCUMENT IS FOR YOUR INFORMATION ONLY. NOVELL MAKES NO EXPLICIT OR IMPLIED CLAIMS TO THE VALIDITY OF THIS INFORMATION. ----------------------------------------------------------------- INSTALLATION INSTRUCTIONS: TOOLBOX.NLM Version 2.15 (for NetWare 4 & 5) Copyright (C) 1997-2001 Novell, Inc. All Rights Reserved 12 April 2001 ________________________________________ CONTENTS ________________________________________ I. Abstract II. Installation Instructions III. Usage IV. Product Description V. Enhancements/Bug Fixes VI. Known Issues VII. Frequently Asked Questions ________________________________________ I. ABSTRACT ________________________________________ TOOLBOX.NLM provides various utility functions to be executed on the server console or via NCF files (without involving any clients). Please read the Known Issues and FAQ sections (below) before reporting problems. NOTE: This utility helps system administrators and developers. It is provided free of charge as a courtesy, and therefore, is not a Novell supported product. ________________________________________ II. INSTALLATION INSTRUCTIONS ________________________________________ Copy TOOLBOX.NLM to the SYS:\SYSTEM directory on your server. NOTE: 4.10 servers require 410PT8B and LIBUPJ4 or greater 4.11 servers require Service Pack 5 or greater If the above requirements are not met, Toolbox may not be able to load because of unresolved symbols. Also note that on 4.1x and 5.0, you must load CLIBAUX.NLM before loading TOOLBOX, otherwise some symbols may not be found. CLIBAUX is included in the support packs. ________________________________________ III. USAGE ________________________________________ Loading: load TOOLBOX [/NS] [/NL] /NS = Don't execute the Toolbox startup file /NL = No Login mode. (To access _NETWARE for disaster recovery) After loading, general help can be obtained with the console command: TOOLBOX A command listing is done with the command: TOOLS For help on the commands provided by Toolbox, type: ? or /? All commands can redirected with file redirection (> or >>) followed by a filename at the end of the command. e.g. dir /st > sys:myfile.txt ________________________________________ IV. PRODUCT DESCRIPTION ________________________________________ TOOLBOX is a collection of utilities that can be used at the server console, or executed from NCF files. All utilities, except where specified, allow operations on the local DOS partition, the local server's Volumes, and remote server's Volumes. The utilities provided by Toolbox are: auth - Manage authentication/connection information beep - Ring the bell (no help available) cat - Display file(s) on the screen chdir (cd) - Set/View current directory or default path copy (cp) - Copy utility del (rm) - Delete utility delay - Delay command dir (ls) - Directory utility echo - Echo a string to the console (no help available) flag - Flag and attribute utility map - Alias mapping mkdir (md) - Make Directory utility move (mv) - Move utility (alias for COPY /MS) purge - Purge deleted files rmdir (rd) - Remove Directory utility shutdown - Shutdown and restart the server startfile - Edit the Startup file (see help in newly created file) Startfile Only Commands: CDV4 - Allow the CD alias in NetWare 4.x. (See CD help) NONS - Disable long name space support NSV4 - Enable long name space on v4.x (4.11 with Support Pack 6) tapplet - Start a Java applet texp - Export (copy) Toolbox.NLM and all associated files tjava - Start a Java application tload - Load a NetWare module tmodules - List loaded NetWare modules trun - Execute an NCF file tunload - Unload a NetWare module toolbox - Toolbox main help tools - Toolbox Command List (this screen) xtd,xtb,dtx - Hex, Decimal and Binary conversion AUTH Help --------- Authentication management utility - auth USAGE: auth [BinderyServer | Tree [Username [Password]] [options]] SAVE | LOAD [filename] authset (alias) Server = Server name (can include wildcards if listing) Username = User object for authen. to Tree or Bindery server. NDS users must be fully qualified from [Root]: e.g. .bryan.devsup.provo.novell Password = Password for above user (Enter "" for no password) or omit to be prompted. Options = preface option(s) with '-' or '/' (e.g. -bsa) b - Entry specifies a Bindery connection c - List connection table (all if no name specified) d - delete one entry (if server/tree is specified) or all entries (if not specified) c - List connection table (all if no name specified) m - Used only with LOAD which merges the current entries with the ones being loaded. Otherwise all current entries are removed. o - logOut entry (or logout all if entry is omitted) y - bYpass confirm when deleting all auth entries filename = A file to save/load an authentication profile The directory must already exist. Even though the file is encrypted, it is suggested to place it in SYS:SYSTEM for security purposes. Description: - Authentication information is used by TOOLBOX utilities when authentication is required. If the AUTH table doesn't contain the auth info needed, it will be prompted for. - If Username has no password, specify "" - If password is omitted, it will be prompted for - If adding an entry that already exists, the original will be overwritten without warning. - If no file is specified with SAVE or LOAD, the default profile name is used: SYS:SYSTEM/TBOXAUTH.DAT - All AUTH table entries are automatically saved upon exiting TOOLBOX, and are restored upon loading TOOLBOX. This is done before any startup commands are executed so it can be overwritten with an AUTH LOAD command in the STARTFILE. - AUTH LOAD without the /m (merge) switch, will logout all current connections to prepare for the new table. NDS Connections: To specify an NDS connection you need only provide authentication information for the tree. TOOLBOX will automatically use those credentials when communication with a server in that tree is requested. Bindery Connections: Bindery connections are specified with the /b option. If the /b option is omitted, the entry is assumed to be a tree. Auth Examples: - AUTH mytree .bamund.devsup.novell (add a tree entry) - AUTH mysrvr supervisor /b (add a bindery server entry) - AUTH (list all entries in the auth table) - AUTH mytree (list a single entry) - AUTH my* (list all matching entries) - AUTH mytree /d (delete all 'mytree' entries) - AUTH /d (delete all auth entries) - AUTH /c (list the current active connections) - AUTH mytree /o (logout of mytree and all its servers) - AUTH /o (logout of all trees and servers) BEEP Help: ---------- USAGE: beep Rings the bell CAT Help: ---------- cat (type) utility - cat USAGE: cat FileSpec [options] FileSpec = [servername/]VolOrDrive:path/filespec Options = preface option(s) with '-' or '/' (ie. -bsa) c - Continuous display Description: - View the contents of text files on the screen Features: - Accepts wildcards for viewing multiple files - Works with DOS partition on local server - Quotes are required in the path for directories with spaces - AUTH information is used for all authen. (See AUTH) CD Help: -------- Change/View Current Directory utility - chdir USAGE: chdir [Path] c cd (On NetWare 4 only if CDV4 is set in the Startfile) pwd Path = [servername/]VolOrDrive:[path] = ..[/][...] = may include spaces and wildcards Description: - When set, "Path" will be prepended to all filespec and path arguments that do not include a colon - cd with no parameters will display the current path - Set the default path to LocalServer/SYS: by doing: cd "" - Any number of dots can be used to go back n - 1 directories - Wildcards (*) may be specified for directory completion - Supports LONG name space on NW4.x (with SP6) and NetWare 5 - Quotes are allowed but not required in the path for directories with spaces - AUTH information is used for all authen. (See AUTH) Known Issues: - CD is a reserved command on NetWare 4 (CDROM.NLM) so the CD alias is not active by default. If CDROM.NLM is not used, you may use CD on NetWare 4 by specifying in the startup file: CDV4 (See STARTFILE) COPY Help: ---------- Copy/Move utility - copy USAGE: copy SourceSpec [DestPath] [options] move (same as: copy /ms) cp (same as: copy) mv (save as: move) SourceSpec = [servername/]VolOrDrive:["]path["]/filespec DestPath = [servername/]VolOrDrive:["]path["][/file] Options = preface option(s) with '-' or '/' (ie. -bsa) a - do not copy DOS & NetWare Attributes d - copy empty subDirectories e - do not remove Empty dirs during a move l - Log activity summary to the file: TBOX$ACT.LOG in the destination directory m - Move file/dirs (delete original after copy) r - overwrite Read-only files (on NetWare partitions) s - copy filespec in current dir and all subdirs v - Verbose mode q - Quiet mode Features/Description: - Works with DOS partition on local server - Keeps activity log for auditing purposes - Interrupt copy with Ctl-C - Supports Long name space copying between two local volumes that support long names. (NetWare 4.11 requires Support Pack 6) - Copying Long names to/from remote volumes is not supported - Quotes are required in the path for directories with spaces - AUTH information is used for all authen. (See AUTH) Limitations/Known Issues: - No wildcards are allowed in destination filespec - Trustees and extended attributes are not copied - Files copied to the DOS partition will not preserve attributes - Overwrite Read-only files is not supported on any DOS Partitions - Max recursive depth for subdirectory copies is 15 - Empty subdirs are always copied from the DOS partition. (See /e) - With Move, the /s switch is active only when Moving a directory. This conforms to the typical move specification. - When on NetWare versions prior to NetWare 5.1 SP1, to copy files with more than one dot, specify *.*.*.* etc. Warnings: - If the destination file exists, it will be overwritten without warning. DEL Help: --------- Delete utility - del USAGE: del FileSpec [options] rm FileSpec = [servername/]VolOrDrive:path[/filespec] Options = preface option(s) with '-' or '/' (ie. -bsa) s - delete filespec in current and all subdirs and remove any empty subdirectories when completed d=nn - remove files matching filespec that have not been modified within the last nn days e - will not remove Empty subdirs (used with /s) q - Quiet mode r - Do not delete Read-only files v - Verbose mode y - Suppress delete confirmation Description: - Deletes the files specified with filespec - If a directory is specified with the /s option, it will be removed as well as all files and subdirs beneath it unless /e is used - Removes read-only files by default (use /r to preserve them) Features: - Works with DOS partition on local server - Quotes are required in the path for directories with spaces - AUTH information is used for all authen. (See AUTH) Limitations/Known Issues: - Max recursive depth for /s option is 15 - Cannot delete Read-only files from DOS Partitions - When on NetWare versions prior to NetWare 5.1 SP1, to delete files with more than one dot, specify *.*.*.* etc. DELAY HELP: ----------- Delay/Pause the command prompt - delay USAGE: delay [mseconds] mseconds = number of milliseconds to delay Description: - To hold the command prompt from executing any other commands for a specified delay time - Useful in NCF files to pseudo-synchronize commands - If mseconds is not specified, delay the default of 1000ms (1 sec) Warning: - You cannot break out of delay once it has started DIR Help: --------- Dir utility - dir USAGE: dir [FileSpec] [options] ls FileSpec = [servername/]VolOrDrive:[path/filespec] Options = preface option(s) with '-' or '/' (ie. -bsa) c - Continuous listing d - list Directories only n - list DOS Name space names s - search Subdirectories for filespec t - list Totals only v - Verbose mode w - Wide listing Description: - If no filespec is specified, a directory of the path specified by Chdir is listed. Chdir path is set to the root of SYS: by default. - AUTH information is used for all authen. (See AUTH) - Quotes are required in the path for directories with spaces Features: - Works with DOS partition on local server Limitations/Known Issues: - Will not report available space on the DOS partition - Max recursive depth for subdirectory listings is 15 - Sizes of files > 2GB are reported incorrectly - When on NetWare versions prior to NetWare 5.1 SP1, to list files with more than one dot, specify *.*.*.* etc. ECHO Help: ---------- USAGE: echo [["]string["]] string = Any string to echo to the console Quotes are optional. FLAG Help: ---------- Flag utility - flag USAGE: flag [[FileSpec] [[+|-]attribs] [/options]] ls FileSpec = [servername/]VolOrDrive:[path/filespec] Attribs = + sets (default), - clears DOS Attributes (** Files and Directories **) N - Normal (clear all attributes) R - Read only H - Hidden Y - sYstem A - Archive NetWare Attributes (** Files only **) T - Transaction P - immediate Purge S - Sharable D - Delete inhibit C - Copy inhibit E - rEname inhibit O - don't cOmpress I - Immediately compress B - don't suBallocate Options = preface option(s) with '/' (ie. /sv) c - Continuous listing s - search Subdirectories for filespec v - Verbose mode Description: - Provides limited capabilities for setting file attributes - If no filespec is specified, a directory of the path specified by Chdir is listed. Chdir path is set to the root of SYS: by default. - AUTH information is used for all authen. (See AUTH) - Quotes are required in the path for directories with spaces - If a directory name is specified with the /s switch, all files in the directory will be listed/modified Limitations/Known Issues: - Max recursive depth for subdirectories is 15 - Will not set attributes on DOS partitions - When on NetWare versions prior to NetWare 5.1 SP1, to flag files with more than one dot, specify *.*.*.* etc. MAP Help: --------- Map utility - map USAGE: map [Alias:[=[Server/]Vol|Drive:[path]] [options]] SAVE | LOAD [filename] Alias = Alias name used to refer to resource. Can be up to 15 characters in length. Server = Server name Vol = Volume name or DOS drive letter Path = Directory Path or File (. for current dir.) Options = preface option(s) with '-' or '/' (e.g. -bsa) c - Continuous listing d - delete one entry (if alias is specified) or all entries (if none specified) m - Used only with LOAD which merges the current entries with the ones being loaded. Otherwise all current entries are removed. s - Do not append a / to the end of the path. This is used for aliases to files. filename = A file to save/load a map profile The directory must already exist. Description: - If adding an entry that already exists, the original will be overwritten without warning. - If no file is specified with SAVE or LOAD, the default profile name is used: SYS:SYSTEM/TBOXMAP.DAT - All MAP table entries are automatically saved upon exiting TOOLBOX, and are restored upon loading TOOLBOX. This is done before any startup commands are executed so it can be overwritten with a MAP LOAD command in the STARTFILE. - Quotes are required in the path for directories with spaces - Mappings are not verified for validity. This prevents connections from being established merely because a map entry exists to a server. TOOLBOX establishes connections only when operations are performed on that server. - The alias value automatically has a / appended to it unless the /s option is specified, allowing file aliases. Examples: - map mydir:=edward_ii/vol1:users/bamund - map silauto:=silicon/sys:system/autoexec.ncf /s - map mydir: /d MD Help: -------- Make Directory utility - mkdir USAGE: mkdir Directory md Directory = [servername/]VolOrDrive:path Features: - Will create all non-existant directories in the path - Quotes are accepted but not required in the path for directories with spaces. - AUTH information is used for all authen. (See AUTH) MOVE Help: ---------- See COPY Help. PURGE Help: ----------- Purge utility - purge USAGE: purge [Path] [options] Path = [servername/]Volume:[path[/filespec]] Options = preface option(s) with '-' or '/' (ie. -bsa) a - purge files in directory and all subdirs d=nn - don't purge files deleted less than nn days q - Quiet mode v - Verbose mode Description: - Purges (permanently removes) all files in Path - If Path is omitted, all files in the current directory from Chdir are purged Features: - AUTH information is used for all authen. (See AUTH) Limitations/Known Issues: - Max recursive depth for /a option is 15 - Support only DOS name space names on the command line RD Help: -------- Remove Directory utility - rmdir USAGE: rmdir Directory rd Directory = [servername/]VolOrDrive:path Features: - Quotes are accepted but not required in the path for directories with spaces. - AUTH information is used for all authen. (See AUTH) Limitations: - Will only remove the directory if it is empty. See "DEL /S" SHUTDOWN Help: -------------- Down Server utility - ShutDown USAGE: ShutDown [Server] [options] Server = Servername of server to down (local if none) Options = preface option(s) with '-' or '/' (ie. -bsa) f - Force Server Down even if there are open files q - Do not prompt for confirmation. LOCAL SERVER ONLY OPTIONS: r - Restart the server after it is down s - reSet server (NetWare 5 only) Description: - ShutDown allows you to force the server DOWN, even if files are open, without having to be at the console to confirm it. - If the Force option is not specified and files are open, ShutDown will print an error and return to the prompt. - Restart (/r) is the default behavior on NetWare 5 - Reset server reboots the machine (NetWare 5 only) STARTFILE Help: --------------- USAGE: Startfile Description: - Edits the startup file which is executed when toolbox loads - Only certain commands are valid for the startup file, execute the TOOLS command for that list. If an invalid command is placed in the file, Toolbox will report the error upon startup. - Load TOOLBOX with the /NS switch to not execute the startup file - Comments for the startup file include: # ; REM - This documentation is also found in the startfile file itself. - The startfile name is: sys:system/tbox.cfg - Special Startfile only commands are: NONS - Disables long name space support CDV4 - Allows the CD command to be registered on 4.x which is not registered by default so it doesn't conflict with the CDROM NLM. NSV4 - Enables long name space support on 4.x. It is disabled by default on 4.x because of CLIB bugs but is fixed with Support Pack 6. - Startfile documentation is placed in a newly created file. If you want the above docs in your startfile, remove it, and reload Toolbox. T[exec]... Help: -------------- Load/Unload/Execute Server Modules USAGE: TLoad [Server/vol:path/]Module [Parameters] TUnload [Server:]Module TModules [Server:][ModuleSpec] TRun [Server/vol:path/]NCFFile TJava [-options] Class [Class Options] TApplet [-debug] [-J] URL|File TLoad - Same parameters as the LOAD command TUnload - A loaded module TModules - A module name or module spec may be specified TRun - An NCF file TJava - For parameters see: java -help | java -nwhelp TApplet - For parameters see: help applet Options: -cp (TJava only) This option allows you to easily append a path (or paths separated by ;) to the existing classpath in ENVSET. This should not be used with -classpath. Description: - Texec commands use the current directory (set by CD) to provide path information for executing modules or Java applications/applets. - Texec commands do NOT use the OS search paths. - Texec commands are unsupported to remote 3.x servers. - TLoad allows you to load a server module from the current directory without the need to specify a path to the module. A full path may be specified if desired. - TUnload will unload a server module on a specified server, or the server in the current directory. - TModules will list modules on a specified server, or the server in the current directory. - TRun allows you to run an NCF file from the current directory without the need to specify a path to the file. A full path may be specified if desired. - TJava works the same as executing a Java application using the JAVA command, except that TJava automatically inserts the current directory into the classpath. One custom option: -cp is available to easily append a path (or paths separated by ;) to the existing classpath variable in ENVSET. Basically this option is the same as specifying: -classpath $CLASSPATH;. The -cp option cannot be used with -classpath. Requires JAVA.NLM to be loaded. - TApplet works the same as executing a Java applet using the APPLET command, except that TApplet uses the current directory as the path to the HTML file, if a URL is not specified. Requires JAVA.NLM to be loaded. Limitations: - TJava and TApplet do not work for remote servers Examples: - TLOAD: cd vol1:mynlms tload test tload joeserver/sys:mynlms/test - TUNLOAD: cd jimserver/sys: tunload monitor tunload joeserver:monitor - TRUN: cd vol1:myncfs trun doit trun joeserver/sys:myncfs/test - TMODULES: cd joeserver/sys: tmodules mo* tmodules joeserver:mo* - TJAVA: cd sys:java/demos tjava mydemo tjava -cp tjava -classpath - TAPPLET: cd sys:java/applets tapplet myapplet Known Issues: When toolbox is remotely loaded on a server (by using tload), when toolbox commands which open a new screen are performed on that server (such as command help or cat), when that screen is closed it appears to lock the console. To get the console prompt back do: Ctl-Alt-Esc. Unload and reload toolbox locally to get around the problem. TEXP Help: ---------- Toolbox Environment Export Utility - texp USAGE: texp destDir DestDir = Directory to copy Toolbox.NLM and related files Description: - Toolbox.NLM uses various files to store and retrieve necessary information such as Authentication, Map, and Startup data. This utility provides a quick way to copy all current files that toolbox needs for its current environment to a specified location, such as another Server. - IMPORTANT: In order for Toolbox to work properly, all exported files must be placed in SYS:SYSTEM on the destination server. Also be sure that TOOLBOX is not loaded on the destination server or the new Authentation and Map data files will be overwritten when Toolbox unloads. (See TUNLOAD) TOOLBOX Help: ------------- USAGE: toolbox [?][/?] Displays the main toolbox help screen and copyright EXAMPLE: toolbox TOOLS Help: ----------- USAGE: tools [?][/?] Displays the command list screen. EXAMPLE: tools XTD, XTB, DTX Help: ------------------- Hex, Decimal and Binary conversion USAGE: XTD (convert hex to decimal) XTB (convert hex to binary) DTX (convert decimal to hex) ISSUE: ________________________________________ V. ENHANCEMENTS/BUG FIXES ________________________________________ Enhancements and Bug Fixes from v1.09c - New authentication and connection model (See AUTH). All authentication information is taken from the AUTH table and is no longer available as commandline parameters. A connection table is now managed so connections do not have to be re-established before each command. Multi-tree authentication has also been added. Because of this new authentication model, all limitations with regards to simultaneous bindery and NDS authenication have been eliminated. - Long name space names are supported on NetWare 5. NetWare 4.11 with support pack 5 still has some bugs in the CLIB libraries that will be fixed in support pack 6. Long name space is only supported on the local server, remote support is not built-in to the CLIB libraries. - File size accumulators and volume size reports can now report up to 999 terabytes instead of 4 gigabytes. - The CD command will now verify directories and also performs directory completion so wildcards may be specified. - Copying to a DOS partition will now preserve the date and time. - Copying or moving files or dirs into a child directory resulted in a Cyclical copy. This has been fixed. - The following utilities have been added: flag, map, tapplet, texp, tjava, tload, tunload, trun, tmodules, xtd, xtb, dtx. - New Startfile commands: NONS - Disables long name space support CDV4 - Allows the CD command to be registered on 4.x which is not registered by default so it doesn't conflict with the CDROM NLM. NSV4 - Enables long name space support on 4.x. It is disabled by default on 4.x because of CLIB bugs but should be corrected in Support Pack 6. Explanation of versions 2.00 and 2.00b Both versions provide the same functionality and are built from the same source, with minor differences explained below. - 2.00 is the web release of TOOLBOX v2 - 2.00b is the DLL version provided as a DLL Loader demo. TEXP is also modified to copy TOOLBOX.DLL instead of TOOLBOX.NLM. Enhancements and Bug Fixes from v2.00 - Purge /d=nnn would sometimes abend the server - The /f flag in Shutdown worked the opposite as stated in the docs - Fixed authentication to remote servers that do not contain a partition replica. - Clarified Texec Help. All Texec commands are not supported when targeting a 3.x server. - Fixed problems detecting and reconnecting invalid connections - Clarified long name space issues in COPY help Enhancements and Bug Fixes from v2.01 - Added /y switch to AUTH to delete all AUTH entries without confirm - Fixed situations where local files could not be found during copy - Added file redirection (> or >>) followed by a filename at the end of the command. - No longer prints an invalid attribute mask when flag fails - Fixed problem of invalid authfile entries at load time - Disallow TUNLOAD TOOLBOX on local server to avoid an abend - Added raw directory listing (/r) switch to DIR - Fixed . and .. problems during copy and dir - FLAG now works with directories (dos attribs only) - Del /s can now remove read-only directories - RD can now remove read-only directories - Auth and Map tables are now saved when server is downed - Fixed incorrect date/time on files copied to the DOS partition - Added /d=nn option to DEL to limit the delete by days - Fixed flag abend on NW4.x and corrupt redzone during Free on NW5 Enhancements and Bug Fixes from v2.11 - Removed the TYPE command because of a type.nlm that was shipped on NetWare v5.1 and later. Replaced TYPE with CAT. Enhancements and Bug Fixes from v2.12 - Allow whitespace between the redirection indicators > or >> and the redirection filename. - Corrected a problem where empty directories would be deleted if the filespec wasn't found (with /s only) Enhancements and Bug Fixes from v2.13 - When doing any file operations on files with more than one dot the file could not be acted upon by default. You had to explicitely specify *.*.*.* etc. to find files with N number or less dots in their names. This issue has been resolved, now a single * will find all files. Enhancements and Bug Fixes from v2.14 - When deleting with a wildcard, the default action was set to /s ________________________________________ VI. KNOWN ISSUES ________________________________________ General Issues: NOTE: 4.10 servers require 410PT8B and LIBUPI or greater 4.11 servers require Service Pack 5 or greater If the above requirements are not met, Toolbox may not be able to load because of unresolved symbols. Also note that with some configurations of 4.11, you must load CLIBAUX.NLM before loading TOOLBOX, otherwise some symbols may not be found. CLIBAUX is included in the support pack. Issue 1: Long name space is supported on the local server only. You cannot copy long names to remote servers or retrieve long filenames from remote servers. This is a limitation in the CLIB libraries. Issue 2: When toolbox is remotely loaded on a server (by using tload), when toolbox commands which open a new screen are performed on that server (such as command help or cat), when that screen is closed it appears to lock the console. To get the console prompt back do: Ctl-Alt-Esc. Unload and reload toolbox locally to get around the problem. Issue 3: When using wildcards on files with multiple dots, you must specify *.*.*.* etc. to find those files. This is fixed on NetWare 5.1 SP1. Cat: Issue 1: Very slow when typing files on remote servers CD (chdir, pwd): Issue 1: Cannot CD to an empty volume. It must contain at least one directory (other than DELETED.SAV). Copy (cp): Issue 1: Files copied to the DOS partition will not preserve attributes. Issue 2: Overwrite read-only files will not work on any DOS Partitions Issue 3: Supports Long name space copying between local volumes only. (NetWare 4.11 with Support Pack 6 or greater) Copying Long names to/from remote volumes is not supported. Issue 4: When using a wildcard in the source filespec, it assumes the destination to be a directory. This prevents a source file with an unknown exact name (e.g. spf??.txt) to be copied with a different name. Del (rm): Issue 1: Cannot delete Read-only files from any DOS Partitions Dir (ls): Issue 1: Will not report available space on the DOS partition Issue 2: Sizes of files > 2GB are reported incorrectly Echo: Issue 1: Control characters (e.g. \b, \n, etc.) are not acted upon. Map: Issue 1: Aliases are referenced with a trailing : Example: dir myalias: Mkdir (md): None: Move (mv): Issue 1: See issues for Copy. Purge: Issue 1: Does not support long names on the command line. TApplet: Issue 1: For local server only TJava: Issue 1: For local server only ________________________________________ VII. FREQUENTLY ASKED QUESTIONS ________________________________________ Q: When will Toolbox support long names on remote servers? A: Really, I want this done as much as anyone, but despite my efforts, the current API set keeps slapping my hands. I can get remote long name support working partially, but it has so many strange side affects and limitations that it makes the syntax very confusing. The good news is, Novell has developed a new API, NKS (Novell Kernel Services), that will support long names on remote servers. If somebody wants to come and take care of my kids for a couple of weeks I will update Toolbox to use these APIs. :-) Q: Can I access _NETWARE? A: Load Toolbox with the /NL (No Login) option. When loaded with this option, long name space is disabled (not by choice) and some functions don't work. This mode is strictly for disaster recovery if NDS is so corrupt that you can't login to the tree. Q: I have support pack 6 loaded on my 4.x server, yet long name space doesn't seem to be supported. A: You must specify the option: NSV4 in the startfile. (See STARTFILE command) Q: I try to load toolbox on my 4.x server with support pack 5 or 6 loaded, and it can't find some symbols. A: You must load CLIBAUX.NLM before loading toolbox. Just load CLIBAUX in the autoexec.ncf and you'll never have to worry again. Q: Can I run Toolbox commands in an NCF file? A: Yes, as long as you load TOOLBOX.NLM before executing the NCF file. If you try to load TOOLBOX.NLM in the same NCF file as toolbox commands, all commands will fail because TOOLBOX.NLM is still loading and has not yet registered the commands. We recommend that TOOLBOX.NLM be loaded in AUTOEXEC.NCF. Do not run commands in a NCF file that require keyboard input such as Dir or Type. (As if you wanted to anyway!) Q: Why is my console command frozen when I run any toolbox command? A: All toolbox commands are single threaded and attached to the console prompt. This was done to guarantee execution order when toolbox commands were executed from NCF files. The prompt returns when the command has finished execution. Q: When I get help on a command, or use the Type command, my console prompt will not come back? A: The prompt will return when you close the Help or Type screen that is displaying output from the command. Q: How do I specify my NDS Username? What is my current context? A: Specify the entire distinguished name. The authenticator's context is [Root]. For example, if my user object Bryan, were in: OU=devsup.O=novell I would specify my username as: .bryan.devsup.novell Note the leading "." which is specifying an absolute path regardless of the current context. Q: Why doesn't Chdir allow just "cd" on NetWare 4.x. A: It interferes with the "cd" command used by the cdrom nlm. If you want to force the CD command to work on 4.x, place the command: CDV4 in the startfile (See STARTFILE). Q: Sometimes toolbox cannot find some files during dir, del, or copy. A: On NetWare versions prior to NetWare 5.1 SP1, in order to find files with multiple dots, you must specify *.*.*. Self-Extracting File Name: etbox7.exe Files Included Size Date Time ..\ ETBOX7.TXT (This file) TOOLBOX.NLM 169120 4-12-2001 4:44:54 pm ----------------------------------------------------------------- Any trademarks referenced in this document are the property of their respective owners. Consult your product manuals for complete trademark information. -----------------------------------------------------------------