In the following we describe the structure of the HELIOS printer log file and server log file. Please refer to your UNIX manuals for a description of the "system messages" file. All three files can be inspected in the EtherShare Admin by choosing the appropriate item in the
Lists menu.
A 3.1 Printer log file structure
Each entry in "HELIOSDIR/var/adm/printer.acct" (with the appendices ".0",
yesterday to ".6",
seven days ago) has the following format:
status, ptrName, "username", "JobTitle",
startTime, duration, pages, ListOfFonts
status (decimal):
3 general UNIX warning
2 PostScript output
1 UNIX info (e.g. Extended print information)
0 OK
-1 communications error
-2 PostScript error
-3 terminated job (e.g. killed signal)
-4 UNIX error (e.g. file not found)
ptrName (string): logical (UNIX) printer name
"username" (string): from PostScript header of job
"JobTitle" (string): i.e. document name, from PostScript header of job
startTime (decimal): seconds since 1.1.1970 (UNIX time_t values)
duration (seconds): = endTime-startTime
pages (decimal): = endPage-startPage (determined by printer interrogation with the "pagecount.ps" query.
ListOfFonts (string array): fonts used, space delimited
If
status0, the line is followed by the error output of the printer, bracketed by the lines "Error output:" and "End error output". Also, if no printable data are sent to the printer (pages=0), then duration will be "0".
Note: Messages are only written to the printer log file if you checked the Accounting File switch when creating the printer queue with the EtherShare Admin.
User and
document names
in print jobs
The user name logged with each print job in the printer log file "HELIOSDIR/var/adm/printer.acct" (and the user to which error messages are sent as mail) is determined by interrogating the PostScript header of the job for the name in the "%%For" comment.
Under Macintosh System 7.x or later, the name in the "%%For" comment is automatically set to the "Owner Name" specified in the
Network Identity section of Apple's
File Sharing (
Start/Stop) control field.
If the "%%For" comment or the name field is missing, all jobs will be allocated to "nobody" by default.
If a name is specified but cannot be found in the list of long or short names in "/etc/passwd", the specified (unknown) user name will still appear in the printer log file, but any error messages are sent as mail to "root" instead.
Note: If you check Save My Name Only or Save My Name and Password in the Macintosh Chooser, the name saved in the system may not be the same as the name in the File Sharing control field, since it is possible to overwrite the prompted name before saving it. The name stored in File Sharing is the one used by the log file.
The document title is determined by interrogating the PostScript header of the job for the name in the "%%Title" comment.
It may be possible for you to set these comments for UNIX and MS-DOS print jobs, too, in order to ensure that they also have complete records in the printer log file.
A 3.2 Server log file structure
Each entry in "HELIOSDIR/var/adm/server.acct" (with the appendices ".0",
yesterday to ".6",
seven days ago) has the following format:
status, svrName, ws_address, pe_status, usrname,
startTime, duration, usrTime, sysTime, rusage
status = 1 (normal login)
svrName (string): server name
ws_address (string): workstation network address (TCP/IP or AppleTalk)
pe_status (decimal): UNIX process exit status (0 = OK; 1...127 = error exit, i.e. the program has been terminated; 128... = abnormal termination, ask your system administrator)
usrname (string): user login name
startTime (decimal): login time, seconds since 1.1.1970 (UNIX time_t values)
duration, seconds: = endTime-startTime
usrTime (decimal): processor time consumed by user process
sysTime (decimal): processor time consumed by the process while in system mode
rusage (decimal array): = resource usage information. The structure is operating system dependent - see the description of "getrusage" in your UNIX documentation. Some of the resource usage fields are decoded and used by the EtherShare Admin in the
Server Log File window.
Each entry in "HELIOSDIR/var/adm/server.acct" has the following format for an unsuccessful login:
status, svrName, ws_address, pid, name, time
svrName (string): server name
ws_address (string): workstation network address (TCP/IP or AppleTalk)
name (string): attempted login name
time (decimal): attempted login time, seconds since 1.1.1970 (UNIX time_t values)
This section describes optional tuning procedures which require substantial UNIX experience. With the exception of
Other tuning tips (below), they should not be attempted by beginners.
If the HELIOS host has plenty of memory, it may be worthwhile adjusting some data structures inside the operating system to be larger than normal. This keeps more information in memory that otherwise may need to be continuously re-read from the disk. Modern operating systems adjust the data structure values depending on the available memory size. See your UNIX documentation for more information.
For more information on UNIX kernel tuning see the HELIOS Web site at:
http://www.helios.de/support/unixkernel.html
EtherShare contains highly-efficient AppleTalk router modules which do not present an excessive load on the host's CPU, even with heavy routing traffic. You can often improve network response by installing two or more network cards in your host, and arranging your network to share traffic between two separate network segments. This approach is particularly beneficial if you have installed the ImageServer product - in such cases we recommend installing a second network card to deal with printer/RIP traffic only, and thus separate it from workstation traffic. There is no theoretical limit to the number of network cards supported by the EtherShare router, but generally there are no gains to be made by installing more than 3 cards, except in the fastest hosts.
A 3.4 TCP/IP ports used by HELIOS programs
| Port |
Protoc. |
Where |
Function |
|
|
|
|
EtherShare POP 3 E-Mail server
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
PCShare native DOS/Win 3.x
|
|
|
|
|
|
|
|
|
|
ImageServer Event Listener
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Reserved for new HELIOS Admin
|
|
|
|
|
EtherShare print spooler (papsrv)
|
|
|
|
|
|
|
|
|
|
|
