Novell

This is Your Open EnterpriseTM

CONFIG.NLM for NetWare

This document (5024640) is provided subject to the disclaimer at the end of this document.

patches this patch supersedes

This patch does not supersede any other patches.

patches that supersede this patch

This patch is not superseded by any other patches.

patch attributes

Architecture: x86-64
Security patch: No
Priority: Optional
Distribution Type: Field Test File

document

Revision: 2
Document ID: 5024640
Creation Date: 2008-05-13 12:39:30
Modified Date: 2008-05-15 05:02:50

technical support

This Field Test File is supported by Novell Technical Services.

abstract

This is a field test release of CONFIG.NLM for NetWare Version 4.11, 4.2, 5.1, 6.0 and 6.5 It has been tested with NW6.5 SP7, NW 6.5 FCS, NW6.0 SP5, NW5.1 SP8, NW 4.11 SP9

details

SYNTAX: LOAD CONFIG [/o[=filename.ext]] [/option] [+option] [-option]
[--long_options[=#]] ...
OPTIONS:
a .. append to the existing file (TXT only)
d .. include a file listing of SYS:SYSTEM and the local drive
s .. include SET parameters
m .. include module version info
p .. include search paths and a file listing of their content
e .. include eDirectory info and a list of partitions
r .. e + replica ring for local partitions
c .. include copyright info on modules
l .. include serial number
n .. include NSS statistics (XML only)
a0 .. summary on all abends
a1 .. details for Abend 1 entries, summary for the rest
a2 .. details on all abends
(in cases above, only the last 200k will be scanned)
a9 .. include the entire ABEND.LOG
f .. include all NCF files from C: and SYS:
v .. include volume segment lists
b .. include SMBIOS info
w .. include Java and Client executable files
t .. link to Analyzer.xslt
j .. include list of Java processes
z .. include boot drive info and list of storage devices and volumes
k .. include cluster info and statistics (XML only)
u .. include LAN driver info and various CFG files
x .. generate XML output

all .. shortcut for /smperna2vbwjzku, which means:
include SET parameters
include module version info
include search paths and a file listing of their content
include eDirectory info and a list of partitions
e + replica ring for local partitions
include NSS statistics (XML only)
details on all abends
include volume segment lists
include SMBIOS info
include Java and Client Executable files
include list of Java processes
include boot drive info and list of storage devices and volumes
include cluster info and statistics (XML only)
include LAN driver info and various CFG files

PREFIXES:
/option .. include section
+option .. include section
-option .. exclude section

LONG OPTIONS:
--loaded_modules
list modules loaded on server
--product_list
list of installed products
--lan_drivers
list network driver info
--cfg_files
include various config files
--mem_stat
memory pool summary
--edir_local_database
local eDir database info
--edir_partitions
list of eDir partitions
--edir_replica_ring
list partition replicas
--edir_file_listing
list contents of sys:_netware
--storage_device_list
list storage devices and MM object hierarchy
--volume_list
list volumes and their properties
--boot_drive
boot disk info
--java_files
list of Java files
--client_files
list of executable files

POSTFIXES:
--long_option .. include section
--long_option=# .. non-zero includes the section
--long_option=0 .. exclude section

OUTPUT:
default .. sys:system\config.txt (TXT only)
sys:system\config.xml (XML only)
/o .. sys:system\config_SERVERNAME.txt (TXT only)
sys:system\config_SERVERNAME.xml (XML only)
/o=fn.ext .. sys:system\fn.ext


change log

Changes since fconfig16.exe:
- The list of SET parameter types was updated
- Changed CONFIG version to 3.10.17

Changes since fconfig15.exe:
- LAN driver custom counter names were not XML escaped properly
- Changed CONFIG version to 3.10.16

Changes since fconfig14.exe:
- Fixed a bug which caused the product list to remain empty
- ScanForNewDevices no longer called before reporting storage devices
- Changed CONFIG version to 3.10.15

Changes since fconfig13.exe:
- Added code to list LAN driver custom counters (XML only)
- Fixed code to handle mixed LF and CRLF terminated lines
when appending files from the boot partition to the XML output
- Refined the XML escaping method, based on customer feedback
- DIB size now expressed in variable format (X.X B/KB/MG/GB) to prevent an overflow
- Prevented an abend while parsing a corrupt DLL file for version info
- Changed CONFIG version to 3.10.14

Changes since fconfig12.exe:

- Fixed code to prevent CPU hog abends while listing SYS:_NETWARE
- Properly documented the /s command line parameter
- Changed CONFIG version to 3.10.13

Changes since fconfig11.exe:

- Fixed code to correctly handle the /o=filename parameter
- Changed CONFIG version to 3.10.12

Changes since fconfig10.exe:

- Fixed code to list failover objects in Storage Device Configuration section
- Added code to append SYS:ETC\HOSTNAME
- Invalid characters gets replaced with a space in the XML output
(like the arrow near JMP in the NW6.5 SP3 abend.log)
- Introducing GNU-style long parameter naming format
Allows greater freedom while selecting which sections are needed
- Added Boot Loader version (DOS or NetWare)
- Changed CONFIG version to 3.10.11

Changes since fconfig9.exe:

- Added /t command line parameter to insert the XSLT reference uncommented
- Added listing contents of SYS:_NETWARE (/e or /all)
- Command line switches for every section
- Command line switches can be prefixed with +/- to include/exclude that section
- Changed CONFIG version to 3.10.10

Changes since fconfig8.exe:

- Corrected the way we report Total Server Memory caused negative number to be displayed in the 2-4 GB range.
- Prevented an abend while listing cluster nodes
- To prevent confusion, on NW 4.x we report the PK major version in the Product Revision field
- Now listing the full path of STARTUP.NCF when appending
- Made some minor changes to ensure proper handling when DOSFAT.NSS is loaded
- Changed CONFIG version to 3.10.9

Changes since fconfig7.exe:

- Removed a possibility of a CPU hog abend while listing storage devices
- Changed CONFIG version to 3.10.8

Changes since fconfig6.exe:

- Corrected the way we use or import some public symbols from the NW 4.10 days
- Finally reporting the correct per-NLM memory usage on NW 6.5
- Inserted a reference to analyzer.xslt into the XML output (as a comment)
- Added global server memory statistics
- Added Server DOS Country ID and Server DOS Code Page (as in NoRM)
- Changed CONFIG version to 3.10.7

Changes since fconfig5.exe
- DoRealModeInterruptDisabled removed as it caused several servers to become
frozen
- Location of cluster stat XML files has been changed in NW6.5 SP1, now
checking both
- Changed CONFIG version to 3.10.6

Changes since fconfig4.exe:

- NSS statistics were sometimes skipped, now we make sure the correct namespace
is in use
- Cluster status XML files are appended when found
- Changed CONFIG version to 3.10.5
- Modified AppendFile to correctly handle lines terminated by LF only
- Resolved a compatibility issue with the NetWare Boot Loader in NW6.5 SP1

Changes since fconfig3.exe:

- Differences were reported in LRU Sitting Time displayed by Config.nlm and
Monitor.nlm. Modified variable from long to float in order to prevent overflow
in the middle of the calculation.
- No longer showing the Java process list if JVM is running on NW 4.x (to
prevent an abend).
- xmlEscape called when necessary to ensure a well-formed XML output
- xmlEscape needed one more time: <> reported as a SET parameter
name (possible NLM-MSG version mismatch)
- Changed GetVolInfo and GetNameSpcInfo because a broken API (DEFECT000328624
and DEFECT000255499) to really list all namespaces for NSS volumes
- Changed module version info to display the revision as a number rather than a
character
- Added code to show the current number of MP service processes
- Changed CONFIG version to 3.10.3, according to the format we now use
- Changed code to get rid of the empty NSS section on pre-NetWare 6.0 servers
(as no _ADMIN volume exists)
- Removed /s command line parameter to always include SET parameters. It was
interfering with the old version's behavior.
- /sd is equivalent to /all, to aid NTS in the support process.
- Now using BTI_RESET to really close the Btrieve connection behind us
- Changed version to 3.10.4

Changes since fconfig2.exe (01-29-2003)

- Fixed code to changed total memory size to unsigned. Caused negative number
to be displayed in the 2-4 GB range.
- Fixed an abend issue when VS_VERSION_INFO was located in a different section
- Fixed code to loading NWIDK.NLM dynamically on NetWare 5.0 and newer versions
only, allowing CONFIG.NLM to run on NetWare 4.1x as well.
- Fixed code to backrev'ed to
GetOriginalNumberOfCacheBuffers/GetCurrentNumberOfCacheBuffers from
NWGetCacheInfo preventing unrealistic results, different from those displayed
in Monitor/NORM.
- Fixed attribute listing for SYS:_NETWARE, which cannot be tied to specific
versions or SP levels. Changed code to call NWGetNSEntryInfo, and fail back to
stat

Changes since fconfig1a.exe (09-09-2002):

- Added code to append SYS:ETC\IPWAN.CFG file if it exists
- Added *.jar and *.class file listing (name, date, size) from the following
directories (and below):
- sys:java
- sys:public
- sys:system\lib
- Added *.exe and *.dll file listing (name, date, size) from sys:public and
below.
- Added code to show the file system name when listing volumes
- Added code to extract VS_VERSION_INFO resource structure from EXE and DLL
files (PE format), showing Company Name, Product Name, Product Version, File
Description, File Version (XML output only)
- Fixed an issue where the output file could have the correct timestamp, but
the contents are unchanged from a previous run. Now we are deleting the
previous output file before going on with creating the new one.
- Fixed the PE dump code to deal with keys having a 0 length value
- Fixed GetNameSpcInfo to discover cluster volumes as well
- Added code to include SM BIOS info (formerly known as DMI)
- Added code to show the disk space used by DET (in megabytes and percent of
total disk space)
- Added DSK and PSM to the list of extensions where module info must be
extracted
- Changed dependency on NWIDK.NLM to allow loading on NetWare 4.1x as well
- Added Cluster configuration listing, retrieved from eDirectory
- Some of the new features made optional, using new command line switches
- Parameter list (/? or /h on command line) now shows on a separate screen
instead of scrolling out quickly on the system console
- Eliminated error message when Media Manager APIs return
MM_FUNCTION_NOT_SUPPORTED

September 9 2002

- XML label should read Sectors Per Block instead of Free Disk Space, according
to TXT ... corrected.
- Added code to include the list of running Java processes ... like the one
presented by the "java -showall" console command.
- Added /o command line parameter to control the name of the output file:
... /o results in sys:system\config_SERVERNAME.txt (or *.xml)
... /o=filename.ext results in sys:system\filename.ext
- Both formats requires LONG namespace support on volume SYS.
- Added code to append SYS:ETC\PROXY\PROXY.CFG and SYS:_NETWARE\_NDSDB.INI
files if they exist.
- Corrected the code which is responsible to display the logical partition <->
volume segment mapping. The use of MM_VOLUME_RETURN_PARTITION_MAPPING was
dropped because it is buggy in earlier versions of NetWare 5.x.
Jul;y 25 2002
- Modified FileDir to call BuildList etc. in order to represent the directory
contents in alphabetically sorted order with dirs at the top.
- Modified SaveSetParms to use the category names returned by
ScanSetableParameters instead of hardcoding them into the code. This also
resolves the issue with NW6 where wrong category names were reported.
- Show Volume Segments when MM.NLM is version 2.02b or greater. Older versions
just issue a warning message on the console, and return nothing useful.
- Modified code to handle volume numbers up to 254 in case of NW 5 and higher.
Previously it stopped at 63 thus cluster volumes were not showing up.
- Modified Modules411 to filter out duplicate entries (caused by the same NLM
loaded into multiple address spaces).
- Made some space to display the newer and longer NLM version numbers in a nice
formatted manner.
New Features:
- Added /h command line parameter to include the hidden SET parameters in
listing
- Added GATEWAYS, HOSTNAME, SLP.CFG, TCPIP.CFG, CRONTAB files from SYS:ETC if
they exist
- Added /m command line parameter to include module info for directory listings
- Added /p command line parameter to list search paths, and list directory
contents for each of them
- Added more feedback to the console while writing the output file
- Added /e command line parameter to include basic NDS/eDirectory information
(tree name, server name, local partitions) and a categorized summary of
sys:_netware contents
- Added /r command line parameter to include replica ring info (name, type,
status) for local partitions
- Added time synchronization status
- Added volume segment details on NW5 and higher to produce an output similar
like on previous NetWare versions (logical partitions and volumes were not
linked together).
- Added product version level
- Added total and the free space on the DOS drive
- Added NSS statistics (specific XML files from _ADMIN:Manage_NSS) - ONLY to
XML output
- Added /c command line parameter to exclude copyright info on modules
- Added /x command line parameter to select the output format: XML or TXT.
- Added installed products list from PRODUCTS.DAT
- Added allocated memory count for loaded modules
- Added the command line parameters used to create the current output.
- Added code to test the existence of C:SERVER.EXE and D:SERVER.EXE when search
path reports no default value (we need to get the boot drive anyway)
- Displays a warning message when performing a directory search in the search
paths, as it could take a while on slower machines
- Modified default parameter values, based on internal beta results. SET
parameters are included, while copyright info is no longer there by default.
- Added code to show the segment list for every volume ... it is more useful to
catch spanned volumes this way.
- Added /f command line parameter: appending all NCF files from C: and
SYS:SYSTEM made optional. C:STARTUP.NCF and SYS:SYSTEM/AUTOEXEC.NCF are always
inserted, regardless of this parameter value.
- Added SERVER.EXE size and date to the boot drive section
- Added Media Manager Object Type for the detailed device output
- Added *.TAO (DirXML Driver cache files) and *.WBQ (DirXML Writeback queue
files) to the NDS/eDir filegroup section (RFEx)
- Added sys:_netware directory attributes
- Added processor numbers

file contents

Compressed File Name: fconfig17.zip

Files IncludedSizeDate
license_agreement.txt2.8 KB (2909)2008-05-13 12:42:20
readme_5024640.htmlN/A2008-05-15 05:02:51

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. Any trademarks referenced in this document are the property of their respective owners. Consult your product manuals for complete trademark information.

Novell is a registered trademark of Novell, Inc. in the United States and other countries. SUSE is a registered trademark of SUSE Linux AG, a Novell business. *All third-party trademarks are the property of their respective owners.

© 2007 Novell, Inc. All Rights Reserved.