README.TXT Welcome to The CNW Commander V2.53 the ultimate file manager of the NetWare server console ________________________________________ CONTENTS ________________________________________ I. Product Description II. Freeware and Commercial Versions III. Mutations and OS Dependencies IV. Versions and Mutations V. Installation and Removal VI. Usage VII. Remote Server Support VIII. Enhancements / Bug Fixes IX. Remote Performance Issues X. Other Known Issues XI. Frequently Asked Questions ________________________________________ I. PRODUCT DESCRIPTION ________________________________________ The CNW Commander is the ultimate file manager of the NetWare server console. Its main features: - two panels - perform NDS and bindery authentication to remote servers - deal with local and remote volumes - history and favorites - full cluster-compatibility - access the local SYS:_NETWARE directory - deal with local DOS drives - handle DOS and LONG names - select directories/files - copy and rename/move directories/files - transfer LONG name, flags, rights, ownership, and directory quota - preserve compression - delete directories/files - create directories - set flags of directories/files - view files - text, binary, hexadecimal, and double-byte views - search - edit files - search and replace - undo and redo - find files - find/salvage/purge deleted files - advanced search options: search by text/size/date - export results to file - directory/file information - open file information - volume information - server information - compare panels - directory tree - purge deleted files - uncompress files - change the LONG name of single directories/files - open emergency console - restart local server in a brutal way - generate file SERVDATA.NDS - zip/unzip by using HRZIP.NLM/HRUNZIP.NLM - split file / join files - compare files by content The CNW Commander can be downloaded from http://www.cnw.hu/cc.zip ________________________________________ II. FREEWARE AND COMMERCIAL VERSIONS ________________________________________ The CNW Commander is available in freeware and commercial versions. The benefit of the commercial version is that it provides access to all remote volumes (unlike the freeware version, that doesn't provide access to remote volumes other than SYS:). Customers of the commercial version are eligible for - free updates for all future releases - unlimited support via e-mail Visit http://www.cnw.hu/CCPay.nsf/Order?OpenAgent - for prices and purchasing information - to purchase the product on-line Novell employees please don't purchase the commercial version but ask for a complimentary license at ccnlm (at) cnw (dot) hu For more information, see section IV (Versions and Mutations). ________________________________________ III. MUTATIONS AND OS DEPENDENCIES ________________________________________ The CNW Commander has been tested in the following OS environments: - NetWare OES (with or without SP3) - NetWare 6.5 (with or without SP6) - NetWare 6 (with or without SP5) - NetWare 5.1 (with or without SP8) - NetWare 5 (with or without SP6A) - NetWare 4.11/4.2 (with or without SP8A or SP9) It may run (but has not been tested) on - NetWare 4.10 - NetWare 4.0x It can't be run on - NetWare 3.x Because of its CLIB (and therefore OS) dependencies, The CNW Commander has been split into two mutations: CC.NLM and CCLITE.NLM. The following table lists their OS dependencies. +------------+------------+ | CC.NLM | CCLITE.NLM | +-------------------+-----------------------+------------+------------+ | NetWare OES | with or without SP3 | YES | YES | +-------------------+-----------------------+------------+------------+ | NetWare 6.5 | with or without SP6 | YES | YES | +-------------------+-----------------------+------------+------------+ | NetWare 6 | with or without SP5 | YES | YES | +-------------------+-----------------------+------------+------------+ | NetWare 5.1 | with or without SP8 | YES | YES | +-------------------+-----------------------+------------+------------+ | NetWare 5 | with or without SP6A | YES | YES | +-------------------+-----------------------+------------+------------+ | | with SP8A | YES | YES | | +-----------------------+------------+------------+ | NetWare 4.11/4.2 | with SP9 | YES* | YES | | +-----------------------+------------+------------+ | | without any SP | no | YES | +-------------------+-----------------------+------------+------------+ | | thoroughly patched | not tested | not tested | | NetWare 4.10/4.0x +-----------------------+------------+------------+ | | not or poorly patched | no | not tested | +-------------------+-----------------------+------------+------------+ | NetWare 3.x | no | no | +-------------------------------------------+------------+------------+ * for NW4SP9, see section X (Other Known Issues) Both mutations are cluster-compatible, i.e. - both of them are able to deal with local cluster volumes - CC.NLM is able to authenticate to the virtual cluster server and deal with its volumes CCLITE.NLM is the 'light' mutation. It - can't authenticate (Ctrl+N) to remote servers - doesn't copy (F5) or move (F6) LONG names along with the directories/files - doesn't transfer date/time while copying or moving directories/files to DOS drives - doesn't preserve compression while copying or moving files - decompresses compressed files while viewing (F3, F9, Ctrl+Q), copying, moving, splitting (Ctrl+Z), or comparing (Ctrl+T) them - can't change the LONG name (Shift+F6) of directories/files - doesn't provide Open file information (F2) - doesn't tell (Ctrl+L) whether a volume is actually a CD/DVD Which mutation should you use? - CC.NLM: at all times whenever possible - CCLITE.NLM: only if your OS isn't supported by CC.NLM - neither: if your OS isn't supported by CCLITE.NLM either For more information, see section IV (Versions and Mutations). ________________________________________ IV. VERSIONS AND MUTATIONS ________________________________________ The table below compiles and summarizes section II (Freeware and Commercial Versions) and section III (Mutations and OS Dependencies). +--------------------------------+ | version/mutation | +----------+------------+--------+ | freeware | commercial | lite | +------------------------------------------+----------+------------+--------+ | name of the .NLM program module | CC | CC | CCLITE | +------------------------------------------+----------+------------+--------+ | freeware | yes | no | yes | +------------------------------------------+----------+------------+--------+ | up-to-date OS (e.g. NetWare OES) support | YES | YES | YES | +------------------------------------------+----------+------------+--------+ | old OS (e.g. NetWare 4.11 SP0) support | no | no | YES | +------------------------------------------+----------+------------+--------+ | full management of local resources | YES | YES | no | +------------------------------------------+----------+------------+--------+ | management of remote SYS: volumes | YES | YES | no | +------------------------------------------+----------+------------+--------+ | management of all remote volumes | no | YES | no | +------------------------------------------+----------+------------+--------+ ________________________________________ V. INSTALLATION AND REMOVAL ________________________________________ Installation: - copy CC.NLM or CCLITE.NLM to the SYS:SYSTEM directory Removal: - delete - SYS:SYSTEM\CC.NLM or SYS:SYSTEM\CCLITE.NLM - SYS:SYSTEM\CC.LA - SYS:SYSTEM\CC.CFG - TREEINFO.CC from the root directory of every affected volume and DOS drive - SYS:ETC\CC_SKIP.LOG - SYS:ETC\CC_*.TXT ________________________________________ VI. USAGE ________________________________________ No user manual ships with The CNW Commander since it provides the same look and feel as those well-known DOS-based commanders. I believe that everybody who has been familiar with those commanders is able to navigate through The CNW Commander. When no dialog box is open, the F1 key displays the available keyboard commands as listed below. Ctrl A About Ctrl B Toggle colors Ctrl C Compare panels Ctrl D Restore selection Ctrl E Open emergency console Ctrl F Change flags Ctrl G Purge deleted files Ctrl L Volume/drive information Ctrl N NCP connections to remote servers Ctrl O Options Ctrl P Paste file/directory name to console prompt Ctrl Q File/directory information Ctrl R Re-read panels Ctrl S Server information Ctrl T Compare files by content Ctrl U Swap panels Ctrl V Generate file SERVDATA.NDS Ctrl W Uncompress files Ctrl X Restart local server in a brutal way Ctrl Z Split file / join files letter Quick search Enter Enter directory Ctrl PgDn Enter directory Tab Change panel Ins Select/deselect Space Select/deselect + Expand selection - Shrink selection * Invert selection \ Enter root directory Ctrl PgUp Enter parent directory / Enter parent directory Backsp History & Favorites < Choose an action (useful via remote console) F1 This help Alt F1 Select volume/drive in left panel Ctrl F1 Zoom/unzoom left panel Shift F1 Select volume/drive in left panel F2 Open file information Alt F2 Select volume/drive in right panel Ctrl F2 Zoom/unzoom right panel Shift F2 Select volume/drive in right panel F3 View file Ctrl F3 Sort by name (ascending/descending order) F4 Edit file Ctrl F4 Sort by extension (ascending/descending order) Shift F4 Edit any file F5 Copy Ctrl F5 Sort by size (ascending/descending order) Shift F5 Zip/unzip by using HRZIP.NLM/HRUNZIP.NLM F6 Rename/move Ctrl F6 Sort by date (ascending/descending order) Shift F6 Change LONG name F7 Create directory Alt F7 Find files (find/salvage/purge deleted files) Ctrl F7 Unsort F8 Delete Ctrl F8 Full mode F9 File/directory information Ctrl F9 Brief mode F10 Exit Alt F10 Directory tree Ctrl F10 LONG names mode Through a remote console session, you can - press Shift+F1/F2 (instead of Alt+F1/F2) to select volumes/drives - press '/' (instead of Ctrl+PgUp) to enter parent directory - use Choose an action dialog box by pressing '>' (instead of the ineffective Ctrl/Shift/Alt+xxx keys) Advanced users can make use of the command line switch Q (LOAD CC Q) in order to get the same CC.NLM configuration I prefer, i.e. - disable message box Some life-saving information displayed at startup - switch both panels to brief mode - sort both panels by extension - set some other options ________________________________________ VII. REMOTE SERVER SUPPORT ________________________________________ The CNW Commander can perform NDS and bindery authentication to remote servers in order to deal with their volumes. In order to authenticate to / disconnect from remote servers: - press Ctrl+N when no dialog box is open - open the Select a volume/drive dialog box (Alt+F1/F2 or Shift+F1/F2) and press F2 All operations supported on the local server are supported on remote servers with the exceptions listed below: - On remote servers - the DOS drives are not handled - the hidden _NETWARE directory is not handled - Open emergency console (Ctrl+E) is not available - Restart local server in a brutal way (Ctrl+X) is not available - Generate file SERVDATA.NDS (Ctrl+V) is not available - Zip/unzip by using HRZIP.NLM/HRUNZIP.NLM (Shift+F5) is not available - Volume information (Ctrl+L) doesn't tell whether the volume is actually a CD/DVD and is not refreshed each second - Server information (Ctrl+S) displays less information and is not refreshed each second - Change LONG name (Shift+F6) fails if CLIB is outdated on the host server - the 'owning name space' (aka 'originating name space') of the destination directories/files is not set to LONG (for more information, consult the FAQ in section XI) - Copy (F5) and Move (F6) don't transfer rights and ownership between - local server <-> remote server via bindery connection - remote server via NDS connection <-> remote server via bindery connection - remote server via bindery connection <-> remote server via bindery connection (if different servers) [Copy and Move do transfer LONG names between - local server <-> local server - local server <-> remote server - remote server <-> remote server Copy and Move do transfer rights and ownership between - local server <-> local server - local server <-> remote server via NDS connection (even if different trees) - remote server via NDS connection <-> remote server via NDS connection (even if different trees) - remote server via bindery connection <-> remote server via bindery connection (if same server)] ________________________________________ VIII. ENHANCEMENTS / BUG FIXES ________________________________________ For a full list of the new features, modifications, and bug fixes, see file HISTORY.TXT. Please send bug reports and enhancement requests to ccnlm (at) cnw (dot) hu Before reporting a bug, please consult the FAQ in section XI. Check for the newest version at http://www.cnw.hu/ccnlm ________________________________________ IX. REMOTE PERFORMANCE ISSUES ________________________________________ You may find the performance of a remote copy (F5) or move (F6) operation to be poorer than expected. In order to enhance it, consider not to transfer rights and ownership (file system information that require excessive object ID translation) between servers. As a rule of thumb, expect up to 10 GB/hour performance (depending on the average file size and CPU/bus speed) through full-duplex Gigabit Ethernet. If you copy or move between - one volume of a remote server and another (or the same) volume of the same remote server - one remote server and another remote server consider to enable option pair Do remote copy directly in the Options dialog box (Ctrl+O; the advantage and disadvantage of doing that are explained in the rich on-line help of these options). ________________________________________ X. OTHER KNOWN ISSUES ________________________________________ On NSS3 volumes (NetWare 6.x/OES), Purge deleted files (Ctrl+G) may leave behind deleted blocks. This is caused by the limitation of the available API calls. You can verify this statement in this way: 1. reproduce the situation by using CC.NLM 2. do a purge operation by using TOOLBOX.NLM 3. check the number of deleted blocks by using MONITOR.NLM CC.NLM works very badly with remote OES Linux servers: - though it is able to authenticate, access the volumes, and retrieve directory listings - it may be unable to access directories/files whose LONG name is different from the DOS name (i.e. the DOS name contains a ~ character like AAAAAA~1.TXT) This issue is under investigation. Currently, you need another tool for an OES Linux <-> NetWare migration. CC.NLM (being CLIB based) may have problems with accented characters in - both local and remote - directory/file names: these directories/files may be - invisible for CC.NLM - inaccessible by CC.NLM For a workaround, please consult TID-10097059. Authentication to a remote server (Ctrl+N; Select a volume/drive > F2) allows the remote server to be specified by its IP address rather than its name. (If this is the case, the tree name - if specified - is ignored.) Please note that - a DNS name (like fs1.something.com) is not accepted - due to the apparent limitation of the available API calls, the SLP service of the remote NDS tree (service type ndap.novell) must be visible to the local server otherwise the authentication fails On NSS3 volumes (NetWare 6.x/OES), Delete (F8) / Move (F6) may not delete/move all source directories/files if at least one directory/file has been skipped. This is caused by an apparent NSS bug: the available API calls may fail to enumerate all directories/files. You don't encounter this if you don't skip any directories/files since CC.NLM/CCLITE.NLM does the delete/move operation in a tricky way: it repeats the same operation again and again until all source directories/files have disappeared (or if at least one directory/file has been skipped). RCONAG6.NLM prior to V1.03 abends if through an RCONJ remote console session you switch to the CC.NLM screen. To avoid this to happen: - For NetWare 5.1, install NW51SP3 or later. - For NetWare 5, grab and use RCONAG6.NLM from NW51SP3 or later. - For NetWare 5, use CC.NLM or CCLITE.NLM in black-and-white mode (Ctrl+B key). The first time you may even want to load it in this way: LOAD CC BWONLY+ / LOAD CCLITE BWONLY+ This forces it to operate exclusively in black-and-white mode - forever or until you switch off this mode so: LOAD CC BWONLY- / LOAD CCLITE BWONLY- - Upgrade to NetWare 6.x/OES since they ship with a newer RCONAG6.NLM. NetWare 4.11/4.2 with NW4SP9 seems to handle LONG file names in a strange way. - Expect to encounter errors if - existing files are to be overwritten during a Copy (F5) or Rename/move (F6) operation (with option Transfer LONG name = On) - you rename (F6) directories/files (with option Transfer LONG name = On) - you try to change the LONG name (Shift+F6) of a directory/file - Expect not to encounter errors during other operations. - As a possible workaround, you may want to consider to downgrade to NW4SP8A. - I mean it seriously! I have had other bad experiences with NW4SP9. A server with NW4SP8A (+ individual updates) seems to be much more stable than with NW4SP9. Some outdated CLIB versions cause the OS to report a minor memory leak ('Module did not release 240 resources ...') when you unload or exit CC.NLM/CCLITE.NLM. To eliminate this, disable option Display key bar in the Options dialog box (Ctrl+O) then exit and re-load CC.NLM/CCLITE.NLM. ________________________________________ XI. FREQUENTLY ASKED QUESTIONS ________________________________________ Beyond the Q&A below, please consult section IX (Remote Performance Issues) and section X (Other Known Issues), too. Q: Which mutation should I use: CC.NLM or CCLITE.NLM? A: Use - CC.NLM: at all times whenever possible - CCLITE.NLM: only if your OS isn't supported by CC.NLM - neither: if your OS isn't supported by CCLITE.NLM either ;-( A: Read section III (Mutations and OS Dependencies). Q: What is the difference between CC.NLM or CCLITE.NLM? A: Read section III (Mutations and OS Dependencies). Q: How can I get the list of the available keyboard commands? A: Press the F1 key when no dialog box is open. Q: How can I select volumes/drives through a remote console session? A: Use the Shift+F1/F2 keys instead of the Alt+F1/F2 ones. Q: How can I choose the unavailable Ctrl+xxx, Shift+xxx, and Alt+xxx actions through a remote console session? A: Read section VI (Usage). Q: How can I authenticate to other servers? A: Press Ctrl+N when no dialog box is open. A: Open the Select a volume/drive dialog box (Alt+F1/F2 or Shift+F1/F2) and press F2. A: Read section VII (Remote Server Support). Q: Can I prevent CC.NLM from loading its configuration file CC.CFG at startup? A: Yes. Load it in this way: LOAD CC NOCFG Q: CC.NLM abends in case of an early loadstage (SERVER -NS -NA > STARTUP.NCF > LOADSTAGE 1 > LOAD CC). What shall I do? A: CC.NLM does abend in loadstage 1 due to a suspected OS bug. Proceed to loadstage 2 or later prior to loading CC.NLM (SERVER -NS -NA > STARTUP.NCF > LOADSTAGE 1 > LOADSTAGE 2 > LOAD CC). Q: I can't copy LONG names. Why? A: Some trivial reasons: the source directory/file doesn't have a LONG name, the destination volume doesn't support LONG names, you are using CCLITE.NLM instead of CC.NLM. A: In case of a local->remote or remote->remote copy operation, CC.NLM does transfer LONG name but - due to limitation of the corresponding API call - it is unable to set the 'owning name space' (aka 'originating name space') of the remote destination directory/file to LONG. So the LONG name is there (most utilities - including CC.NLM - see it and deal with it) but some utilities (e.g. the Novell Client extension of Windows Explorer) may handle the fact that the owning name space is DOS in a strict way and interpret it as the directory/file wouldn't have a LONG name at all. Q: On a NetWare 4.x server, CC.NLM produces 'Loader cannot find public symbol ...' errors and doesn't load. What shall I do? A: For NetWare 4.11/4.2, install NW4SP8A. A: Use CCLITE.NLM rather than CC.NLM. A: Read section III (Mutations and OS Dependencies). Q: On a NetWare 3.x server, both CC.NLM and CCLITE.NLM produce 'Loader cannot find public symbol ...' errors and don't load. What shall I do? A: Neither CC.NLM nor CCLITE.NLM supports NetWare 3.x. A: Read section III (Mutations and OS Dependencies). Q: Why don't you display a key bar when neither of the Alt, Ctrl, and Shift keys is being pressed? A: Because there is no need for it. I believe that everybody who has been familiar with those well-known DOS-based commanders knows that F1 is for Help, F5 is for Copy, and F8 is for Delete. There are only two non-trivial keys [F2 (Open file information) and F9 (File/directory information)] so I decided not to waste a precious screen line for a permanent key bar.