Ref: 11030057
Title: Flagging Errors with Maxess
Date: 12/14/89

Copyright 3Com Corporation, 1991.  All rights reserved.

An integral part of the Maxess Gateway is the activity log file.  The
default name of this file is GW.LOG.  A record of Gateway activity
is logged in this file, providing information that can be used in
diagnosing problems.

Using the Gateway Manager Program, you can watch the activity log
as it is updated, modify which events are logged, copy the log to
another file, and so forth.  The activity log can also be redirected to
the standard DOS system devices such as PRN, AUX, and COM1.

Activity Log Event Level flags are used to control the amount of
information that gets logged to the log file.  The default value is
8FF as specified in the MAXESSGW.CFG gateway configuration file.
This value can also be changed dynamically by using the gateway manager.

The "Activity Log Event Level" flag is an eight-character value
that equates to 4 HEX numbers internally.  The first four
characters represent debug flags and the second four are event
flags.  The 8FF default is actually 000008FF with the zeros
truncated.

FLAG TABLE
----------
Debug Flags

1008 0000 - Processed Function Management Data
2000 0000 - Function Management Data
4000 0000 - Logical Split  (internal Maxess commands)
8000 0000 - Physical Split (shows NetBIOS commands)

0100 0000 - Function Management Headers
0200 0000 - Resource Monitor
0400 0000 - Miscellaneous
0800 0000 - Network Management Vector Transport (shows alerts)

0010 0000 - APPC receive processing
0020 0000 - PIU Dump (much like a line trace)
0040 0000 - RTM
0080 0000 - CNOS Processing

Event Flags

0000 1000 - APPC/PC SYSLOG Exit Data
0000 2000 - APPC Conversation status changes

0000 0100 - SNA Session Commands (SC log option)
0000 0200 - SNA Session Status change (SS log option)
0000 0400 - SNA Details
0000 0800 - SDLC Commands (CMD trace option)

0000 0010 - Errors
0000 0020 - Warnings and Notifications

0000 0001 - Link Status change (LS log option)
0000 0002 - Link Statistics Updated
0000 0004 - LU Assignments (LU log option)
0000 0008 - Activity Log Updated

These values can be modified in either of two ways.  Using a text
editor, you can change the Activity Log Event Level value in the
MAXESSGW.CFG file.  The value is read only once when the gateway
is first loaded.  The second method is done from the "Log Watch"
screen in the gateway manager.  Pressing Ctrl-F10 while in the
Log Watch screen will give you a dialog box asking for log value.
The new value remains in effect until the gateway is reloaded or
is changed using Ctrl-F10.

For example, let's say we want to monitor APPC activity.  The hex
value that best fits would be 04B03538.  This event level will
monitor the following information:

1.  Miscellaneous info (various buffer allocations)
2.  CNOS Processing (session parameter negoiation)
3.  APPC Receive processing (embedded statements within code)
4.  APPC/PC Syslog Exit
5.  APPC Conversation status changes (shows allocations and
    deallocations)
6.  SNA Details (provides verbose listing of SNA info)
7.  SNA Session Commands (activate LUs and PUs, BINDS ...)
8.  Errors
9.  Warnings and Notifications
10. Update the activity log
11. PIU dump

Note:  Choose carefully which flags to set, and set only those
you require, because setting the flags can drastically degrade
the performance of the gateway.  When more flags are used, more
information is logged in the activity log; thus, more output is
written to the hard drive or server.

