Index of /netwaresl/REPORT/REPRT101

      Name                    Last modified       Size  Description

[DIR] Parent Directory 23-Apr-2005 03:06 - [   ] REPORT.EXE 25-Feb-1994 20:46 350k

   TGB - Thomas Botta, Rosenmuehlweg 7, D-89415 Lauingen, CIS: 100020,1721
______________________________________________________________________________
                               Report-Generator
                              V1.01 (26.02.1994)
                            (c) 1993, 1994 by TGB
                              All rights reserved
______________________________________________________________________________


Contents:
	1. Overview
	1.1 What is Report-Generator?
	1.2 Features
	1.3 Requirements
	1.4 Problems/Suggestions
	2. Shareware
	2.1 Definition of Shareware
	2.2 Disclaimer Agreement
	3. Using Report Generator
	3.1 Menu "Change Current File Server"
	3.2 Menu "Choose Output File"
	3.3 Menu "Server Information"
	3.4 Menu "Accounting Information"
	3.5 Menu "User Information"
	3.6 Menu "Group Information"
	3.7 Menu "Queue Information"
	3.8 Menu "Print Server Information"
	3.9 Menu "Volume Information"
	3.10 Menu "Retrieve all"
	3.11 Menu "View output"
	3.12 Menu "Quit"
	3.13 Command line options and usage
	4. Format of the log files which are generated by report
	4.1 Server Information
	4.2 Accounting Information
	4.3 User/Group/Queue Information
	4.4 User Defaults
	4.5 Printserver information
	4.6 Volume information

1. Overview:
============

1.1 What is Report-Generator?
Report-Generator was designed to retrieve detailed configuration information
from Novell file servers. It retrieves the information available with SYSCON,
PCONSOLE, DSPACE, FCONSOLE and more. We use it to generate configuration 
reports for our customers.
Report-Generator is also usefull to document changes in the server configuration 
e.g. at a weekly basis.

1.2 Features
- Generate reports for Novell 2.x / 3.x / and (with limitations) 4.x servers
- Server config: name/version/*.ncf files/system login script/...
- Accounting config: charge rates
- User/Group: account restrictions/time restrictions/trustee assignments/...
- Queue: queue directory/users/servers/operators
- Print Server: printer configuration/version/status/type/...
- Volume: Volume Info/Directory tree with dspace information
- Novell like menu system
- Batch processing

1.3 Requirements
- NetWare 2.x or higher

1.4 Problems/Suggestions

You have problems using Report Generator? You are missing a bit of infor-
mation which is not currently retrieved by Report Generator? Feel free to
contact me via E-Mail (Compuserve: Thomas Botta [100020,1721]).




2. Shareware:
=============


2.1 Definition of Shareware:
Shareware distribution gives users a chance to try software before buying it. 
If you try a Shareware program and continue using it, you are expected to re-
gister. Individual programs differ on details -- some request registration 
while others require it, some specify a maximum trial period. With registra-
tion, you get anything from the simple right to continue using the software 
to an updated program with printed manual.

Copyright laws apply to both Shareware and commercial software, and the 
copyright holder retains all rights, with a few specific exceptions as stated 
below. Shareware authors are accomplished programmers, just like commercial 
authors, and the programs are of comparable quality. (In both cases, there 
are good programs and bad ones!) The main difference is in the method of 
distribution. The author specifically grants the right to copy and distribute 
the software, either to all and sundry or to a specific group. For example, 
some authors require written permission before a commercial disk vendor may 
copy their Shareware.

Shareware is a distribution method, not a type of software. You should find 
software that suits your needs and pocketbook, whether it's commercial or 
Shareware. The Shareware system makes fitting your needs easier, because you 
can try before you buy. And because the overhead is low, prices are low also. 
Shareware has the ultimate money-back guarantee -- if you don't use the 
product, you don't pay for it.


2.2 DISCLAIMER - AGREEMENT
Users of Report Generator must accept this disclaimer of warranty: 

"Report Generator is supplied as is. The author disclaims all warranties, 
expressed or implied, including, without limitation, the warranties of 
merchantability and of fitness for any purpose. The author assumes no 
liability for damages, direct or consequential, which may result from the 
use of Report Generator". 

Report Generator is a 'shareware program' and is provided at no charge to the 
user for evaluation. Feel free to share it with your friends, but please do not 
give it away altered or as part of another system. If you find this program 
usefull and wish to use it after you have run it 5 times on your server, you 
must make a registration payment of $89 which license Report Generator to use 
it on one server. Report Generator is also available in an unlimitted version 
for $235.

The $89 registration fee will license one copy for use on one server. You 
must register Report Generator for each server you wish to use it for. If you
have more than 2 servers the unlimitted version ($235 registration fee) is
recommended. It license you to use one copy with any number of file servers.

To register please send me your company name as well as the serial number of
your file server. Registration is easy with compuserve: Simply enter "GO SWREG"
and search for keyword "TGB" now select the product you want to register.

Anyone distributing Report Generator for any kind of renumeration must first 
contact Thomas Botta at the address below for authorization.

You are encouraged to pass a copy of Report Generator along to your friends 
for evaluation.  Please encourage them to register their copy if they find 
that they can use it.



3. Using Report Generator
=========================

After starting report generator you must confirm the registration reminder

3.1 Menu "Change Current File Server"

Use this entry to change the fileserver for which you want to generate a 
report. A list box will be displayed with all file servers you are currently
attached to. 
If you want to attach to another file server simply press the "ins" key. A 
list with all available server will be displayed. Select the server you want 
to attach to and press "enter". You are asked for the username and passwort 
to attach to the file server.
If the attachement was successful the new file server will also be displayed
in the selection.
Now choose the server you want to use for this report. You must have super-
visor equivalenz to that server. If you have not supervisor privilegs a
message is displayed and you can't run report on this server.
If you have successfully selected the file server RG will display something
like 

 "User SUPERVISOR attached to server PRODUCTION running NetWare v3.12[2]" 

in the second line. It shows your username the fileserver name and version
as the number of times you have run RG on this server ( 2 times in the above
example ).

You can also specify the server at the command line. Simply start report with
"report /server:servername".


3.2 Menu "Choose output file"

Use this entry to specify the output filename.

A input box will be displayed, where you can enter the path and filename of
the output file you want to use.

If you press the "ins" key in this box a listbox with the directory tree is
displayed, where you can select a file name.

If you press the "enter" key in the "Enter output filename" box, the file is
created. If the file already exists you are asked to overwrite or append to
the file or specify a new filename.

You can also specify the output filename at the command line:

"report /output:filename"


3.3 Menu "Server Information"

Use this entry to retrieve server information.

If you run Report generator in batch mode (/BATCH command line argument) you
can specify this option also by the command line argument /SERVER.

"report /batch /server /output:nw.log"


3.4 Menu "Accounting Information"

Use this entry to retrieve accounting information.

If you run Report generator in batch mode (/BATCH command line argument) you
can specify this option also by the command line argument /ACCOUNTING.

"report /batch /accounting /output:nw.log"


3.5 Menu "User Information"

Use this entry to retrieve user information.

If you run Report generator in batch mode (/BATCH command line argument) you
can specify this option also by the command line argument /USER.

"report /batch /user /output:nw.log"


3.6 Menu "Group Information"

Use this entry to retrieve group information.

If you run Report generator in batch mode (/BATCH command line argument) you
can specify this option also by the command line argument /GROUP.

"report /batch /group /output:nw.log"


3.7 Menu "Queue Information"

Use this entry to retrieve queue information.

If you run Report generator in batch mode (/BATCH command line argument) you
can specify this option also by the command line argument /QUEUE.

"report /batch /queue /output:nw.log"


3.8 Menu "Print Server Information"

Use this entry to retrieve printserver information.

If you run Report generator in batch mode (/BATCH command line argument) you
can specify this option also by the command line argument /PS.

"report /batch /ps /output:nw.log"


3.9 Menu "Volume Information"

Use this entry to retrieve volume information.

If you run Report generator in batch mode (/BATCH command line argument) you
can specify this option also by the command line argument /VOLUME.

"report /batch /volume /output:nw.log"


3.10 Menu "Retrieve all"

Use this entry to retrieve all available information.

If you run Report generator in batch mode (/BATCH command line argument) you
can specify this option also by the command line argument /ALL.

"report /batch /all /output:nw.log"


3.11 Menu "View output"

Use this entry to view the current contents of the specified log file.


3.12 Menu "Quit"

Use this entry to exit report generator.


3.13 Command line options and usage

Call report with the /? or /HELP switch to get help for command line options.

If you want to use report in batch files you must specify at least the
following in the command line of report:
/BATCH for batchmode /OUTPUT:<filename> to specify the output file and one or
more of the options (/ACCOUNTING /GROUP /PS /QUEUE /SERVER /USER /VOLUME) or
/ALL for all available information.

The following errorlevels are returned by report:

EXITERR_NOERROR                0
EXITERR_NOT_ATTACHED           1
EXITERR_UNABLETOATTACH         2     
EXITERR_NOSUPERVISORPRIVILEGS  3
EXITERR_CREATEOUTPUTFILE       4
EXITERR_NOOUTPUTFILE           5
EXITERR_LICENSEVIOLATION       6
EXITERR_DAMAGEDEXE             7





4. Format of the *.log files which are generated by report:
===========================================================


4.1 Server Information
								
section name: [Fileserver-%s]       %s is the name of the fileserver

entry                         2 3 4 sample         
-------------------------------------------------------------------------------
ServerName                    X X X PRODUCTION
SerialNumber                  X X X 23345689
ApplicationNumber             X X X 2455
CompanyName                   X X X Novell
NetWare Version               X X X NetWare V4.01
OS Revision Date              X X X 12 Juli 1993
CopyrightNotice               X X X (C) Copyright 1983-1993 Novell, Inc.   All Rights Reserved.
Maximum Volumes               X X X 64
Revision                      X X X 0
SFT Level                     X X X 2
TTS Level                     X X X 1
Accounting Version            X X X 1
VAP Version                   X X X 1
Queue Version                 X X X 1
Print Version                 X X X 0
Virtual Console Version       X X X 1
Restriction Level             X X X 1
Internet Bridge               X X X 1
Maximum Connections           X X X 10
Maximum NumberOfNameSpaces        X 6
Maximum NumberOfLANs              X 256
Maximum NumberOfMediaTypes        X 32
Maximum NumberOfProtocols         X 16
Maximum SubDirTreeDepth           X 100
Maximum NumberOfDataStreams       X 3
Maximum NumberOfSpoolPrinters     X 5
ConsoleOperators              X X X -> none if there are no console operators defined
IntruderDetection             X X X -> disabled or enabled if enabled the following entries:
 IncorrectLoginAttempts             2
 BadLoginCountRetentionTime         0 Days 1 Hours 5 Minutes
 LockAccountAfterDetection          no or 1 Days 0 Hours 0 Minutes
{ System Login Script:        X X X -> Contents of system login script (sys:public\net$log.dat)
System Login Script           X X X -> none if there is no system login script
Workgroup Managers            X X X -> none if there are no workgroup managers defined
CacheBufferCount              X     1000
CacheBufferSize               X     4096 Byte
LogicalDriveCount             X     2
PhysicalDriveCount            X     2
Chn-ChannelState              X     running / stopping / stopped / not functional / unknown(x)
Chn-ChannelType               X     XT / AT / SCSI / disk coprocessor / unknown(x)
Chn-DriverType                X     5
Chn-DriverVersion             X     2.1
Chn-DriverIOAddr1             X     1f0h-1ffh
Chn-DriverIOAddr2             X     178h-17fh
Chn-DriverMemory1             X     D00000h:0h
Chn-DriverMemory2             X     D00000h:0h
Chn-DriverInterrupt1          X     12
Chn-DriverInterrupt2          X     none
Chn-DriverDMAChannel1         X     5
Chn-DriverDMAChannel2         X     none
Chn-DriverConfigDescription   X     IBM SCSI Diskcontroller
MaxOpenFiles                  X     240
LANc-Config1                  X     Racal Interlan NI6510 Driver  V2.0EC (900201)
LANc-Config2                  X     Dma Channel = 3
LANc-OptionNumber             X     6
LANc-NetworkAddress           X     01020304h:020701084b8a
Diskn-Channel                 X     0
Diskn-Removable               X     yes or no
Diskn-DriveType               X     XT / AT / SCSI / disk coprocessor / PS/2 with MFM controller
												PS/2 with ESDI controller / Convergent Technology SBIC / unknown(x)
Diskn-ControllerDriveNumber   X     1
Diskn-ControllerNumber        X     2
Diskn-ControllerType          X     0
Diskn-DriveSize               X     100000KB
Diskn-DriveCylinders          X     1024
Diskn-DriveHeads              X     16
Diskn-SectorsPerTrack         X     17
Diskn-DriveDefinition         X     IDE Disk
Diskn-IOErrorCount            X     0
Diskn-HotFixStart             X     10000
Diskn-HotFixSize              X     2000
Diskn-HotFixBlockAvailable    X     1999
Diskn-HotFixEnabled           X     yes or no
{ xxxxxxxx.NCF:                 X X -> Contents of all *.NCF files in sys:system
{ AUTOEXEC.NCF:               X X X -> Contents of AUTOEXEC.NCF (NW > 2) or AUTOEXEC.SYS (NW <= 2)
AUTOEXEC.NCF                  X X X -> none if there is no AUTOEXEC.NCF/.SYS
												

4.2 Accounting Information
								
section name: [Accounting]

entry                         2 3 4 sample         
-------------------------------------------------------------------------------
Accounting installed          X X X yes or no - if yes the following additional entrys are used
AccountingServers             X X X -> name of the accounting servers
BlocksRead                    X X X -> none or the format described below
BlocksWritten                 X X X -> none or the format described below
ConnectTime                   X X X -> none or the format described below
DiskStorage                   X X X -> none or the format described below
RequestsMade                  X X X -> none or the format described below

format of the accounting entries

entryname Charge Rate xx=n/m        List of defined charge rates
entryname hh:mm  r r r r r r r r    rate for time hh:mm from 00:00 - 23:30 ( Su Mo Tu We Th Fr Sa )


4.3 User/Group/Queue Information
								
section name: [USERS] / [GROUPS] / [PRINT_QUEUES]

entry                         2 3 4 sample         
-------------------------------------------------------------------------------
Usern/Groupn/Queuen           X X X SUPERVISOR(1) -> username(object id)
NumberofUsers/Groups/Queues   X X X 5

for each user/group/queue a own section is created

section name: [User/Group/Queue-%s]  %s is the name of the user/group/queue

entry                         2 3 4 sample         
-------------------------------------------------------------------------------
FullName                      X X   Jonny Walker
Account                       X X X enabled or disabled
AccountExpireDate             X X X never or day.month.year   
LimitConcurrentConnections    X X X no or number of connections allowed e.g. 5
AllowUserToChangePassword     X X X no or yes     
RequirePassword               X X X no or yes
 MinimumPasswordLength        X X X 5
 RequireUniquePasswords       X X X yes or no 
 ForcePeriodicPwdChanges      X X X no or days between forced changes e.g. 30 days
  PasswordExpireDate          X X X day.month.year
  LimitGraceLogins            X X X no or number of grace logins allowed
   RemainingGraceLogins       X X X number of remaining grace logins
TimeRestrictions              X X X none or the following additional entries
 SunTimeRestrictions          X X X 01.00-07.30
 MonTimeRestrictions          X X X 01.00-07.30
 TueTimeRestrictions          X X X 01.00-07.30 18.00-23.00
 WedTimeRestrictions          X X X 01.00-07.30 18.00-23.00
 ThuTimeRestrictions          X X X none
 FriTimeRestrictions          X X X 01.00-07.30
 SatTimeRestrictions          X X X 01.00-07.30
SecurityEqualTo               X X X USER1 USER2 GROUP1 GROUP2 (maybe more than one line)
MemberOfGroups                X X X GROUP1 GROUP2 (maybe more than one line) (user only)
GroupMembers                  X X X USER1 USER2 (maybe more than one line) (group only)
StationRestrictions1          X X X xxxxxxxx:xxxxxxxxxxxx xxxxxxxx:xxxxxxxxxxxx (maybe more than one line)
AccountBalance                X X X 5000
LowBalanceLimit               X X X 100
Managers                      X X   USER1 USER2 (maybe more than one line)
QueueDirectory                X X X sys:system\xxxxxxx (queue only)
QueueUsers                    X X X USER1 USER2 (maybe more than one line) (queue only)
QueueServers                  X X X PRODUCTION (maybe more than one line) (queue only)
QueueOperators                X X X USER1 USER2 (maybe more than one line) (queue only)
CommonName                        X common name (maybe more than one line)
Surname                           X Jonny Walker (maybe more than one line)
Title                             X Title (maybe more than one line)
Location                          X Location (maybe more than one line)
OU                                X Department (maybe more than one line)
PhoneNumber                       X Phone number (maybe more than one line)
DeliveryOffice                    X DeliveryOffice (maybe more than one line)
PostalAddress                     X Postal Address (maybe more than one line)
PostalCode                        X Postal Code (maybe more than one line)
PostOfficeBox                     X Post Office Box (maybe more than one line)
State                             X State (maybe more than one line)
StreetAddress                     X Street Address (maybe more than one line)
Organisation                      X Organisation (maybe more than one line)
UnknownProperty               X X X Name of a property unknown to report
PasswordAssigned              X X X yes or no (user only)
{ Login-Script:               X X   -> Contents of login script (user only)
LoginScript                   X X   -> none if there is no login script (user only)
{ Login-Script OS/2:          X X   -> Contents of login script for OS/2 (user only)
LoginScriptOS2                X X   -> none if there is no login script for OS/2 (user only)
ManagedUsers                  X X   USER1 USER2 (maybe more than one line)
ManagedGroups                 X X   GROUP1 GROUP2 (maybe more than one line)
FileServerConsoleOperator     X X X yes or no
{ Trustee Assignments:        X X X lines with the format: [SRWCEMFA] VOL:dir/dir/file
{ Volume Disk Restrictions:   X X X lines with the format: vol  none/rest.  in use: xKB


4.4 User Defaults
								
section name: [User Defaults]

entry                         2 3 4 sample         
-------------------------------------------------------------------------------
CreateHomeDir                 X X   no or path e.g. sys:user/ or none if no path specyfied
AccountBalance                X X   1000
LowBalanceLimit               X X   50
AccountExpireDate             X X   never or day.month.year
LimitConcurrentConnections    X X   no or number of connections allowed e.g. 5
RequirePassword               X X X no or yes
 MinimumPasswordLength        X X X 5
 RequireUniquePasswords       X X X yes or no 
 ForcePeriodicPwdChanges      X X X no or days between forced changes e.g. 30 days
  LimitGraceLogins            X X X no or number of grace logins allowed
TimeRestrictions              X X X none or the following additional entries
 SunTimeRestrictions          X X X 01.00-07.30
 MonTimeRestrictions          X X X 01.00-07.30
 TueTimeRestrictions          X X X 01.00-07.30 18.00-23.00
 WedTimeRestrictions          X X X 01.00-07.30 18.00-23.00
 ThuTimeRestrictions          X X X none
 FriTimeRestrictions          X X X 01.00-07.30
 SatTimeRestrictions          X X X 01.00-07.30



4.5 Printserver information
								
section name: [PRINT-SERVERS]

entry                         2 3 4 sample         
-------------------------------------------------------------------------------
PrintServer                   X X   PS

for each print server a own section is created

section name: [PrintServer-%s]  %s is the name of the print server

entry                         2 3 4 sample         
-------------------------------------------------------------------------------
CommonName                    X X   common name
PasswordAssigned              X X   yes or no
ObjectID                      X X   435345
Status                        X X   running (only if ps is loaded)
NumPrinters                   X X   4 (only if ps is loaded)
NumModes                      X X   2 (only if ps is loaded)
Version                       X X   3.76 (only if ps is loaded)
ServerType                    X X   nlm (only if ps is loaded)
Description                   X X   description
Operators                     X X   USER1 (maybe more than one line)
Device                        X X   device (maybe more than one line)
Users                         X X   USER1 (maybe more than one line)
ServicedServer                X X   PRODUCTION (maybe more than one line)
Printer                       X X   epson lq850 (maybe more than one line)

for each defined printer a own section is created

section name: [Printer-%s1-%s2] %s1 is the ps name %s2 is the printer name

entry                         2 3 4 sample         
-------------------------------------------------------------------------------
CN                            X X   epson
Type                          X X   parallel
Port                          X X   LPT1
UseInterrupts                 X X   yes
IrqNumber                     X X   7
CurrentForm                   X X   0
BufferSize                    X X   3
ServiceMode                   X X   change form as needed
BannerType                    X X   text
Default Queue                 X X   EPSON
Notify                        X X   EVERYONE[First:30][Next:60] (maybe more than one line)
Owner                         X X   SUPERVISOR
Print Server                  X X   PS
Queue                         X X   EPSON (maybe more than one line)
Priority                      X X   1 (maybe more than one line)


4.6 Volume information
								
section name: [Volume-%s]  %s is the name of the volume

entry                         2 3 4 sample         
-------------------------------------------------------------------------------
TotalBlocks                   X X X 29242(467872KB)
SectorsPerBlock               X X X 32(16KB)
AvailableBlocks               X X X 6970(111520KB)
TotalDirEntries               X X X 36096
AvailableDirEntries           X X X 19786
RemovableVolume               X X X yes or no
Auditing                          X enabled or disabled
 AuditFileSize                    X 40
 AuditConfigFileSize              X 232
 AuditFileMaxSize                 X 1024000
 AuditFileSizeThreshold           X 921600
 AuditRecordCount                 X 2
 AuditHistoryRecordCount          X 7
NumberOfVolumeSegments            X 2
SegmentDeviceNumn                 X 1
SegmentOffsetn                    X 160
SegmentSizen                      X 462592(231296KB)
LoadedNameSpace                 X X DOS MAC
LogicalDriveNumber            X     1
StartingBlock                 X     200
Hashing                       X     yes or no
Caching                       X     yes or no
Mounted                       X     yes or no


section name: [Volumes]

entry                         2 3 4 sample         
-------------------------------------------------------------------------------
{ Volume: VolName             X X X SYS (directory tree follows)
direntry[dspace:xKB]            X X sample directory entry with directory space restriction