DLOG Quick Reference Guide

DLOG IS!!

A new CI level log formatting facility called DLOG is available for use with
SHERLOCK, or separately. DLOG improves
upon the existing LOGFORMAT command, whick is being phased out. The new
DLOG facility reduces file size and
formatting time by allowing you to:

auto-scan for the correct DLOG file required

add date/time parameters to collect logs for a specified time frame
include or exclude specific log reports
format multiple DLOG files into one formatted file

NOTE: Only one user is allowed to format logs at one time; therefore, only one
user is allowed in the DLOG command level
at a time.

DLOG Commands

DLOG

Gets you into the DLOG level. Upon entering this level, the default format
setting is ALL logs included and no logs
excluded. The other commands listed are available after you enter this level.
STATUS

Displays the current DLOG format parameters (that is, those logs that are
INCLUDED/EXCLUDED). Also displayed
is the earliest valid starttime available for use with the FORMAT subcommand
and information on the previous use of
DLOG.
EXCLUDEALL

Removes all logs from the current set of logs to be formatted. This
subcommand must be followed by the INCLUDE
subcommand or no formatting of logs will take place.
INCLUDEALL

Resets the current set of logs to ve formatted to ALL, which is the default
value.
EXCLUDE <...>
 Removes logs from the current set of logs to be formatted. If the logs were not
included in the first place, this
subcommand does nothing. The logs are validated upon entering this
subcommand. Enter log IDs as whole group or
specific report numbers, separated by spaces (eg, EXCLUDE PM NET 101
SOS TOP 102 101).
INCLUDE <...>

Appends lgos to the current set of logs to be formatted. If the logs are already
included, this subcommand does
nothing. The logs are validated upon entering this subcommand. Enter log IDs
as a whole group or specific report
numbers, separatd by spaces (eg, INCLUDE PM NET 101 SOS TOP 102 101).
FORMAT

<starttime>
<endtime>
<output options>

Executes the actual formatting process, using the following parameters:

&ltstarttime> and &ltendtime> allow you to specify the time window for
which logs are to be formatted. Both are
required. Format is yymmddhhmmss.

&ltoutput options> required parameter that specifies either ToFile or

ToTerminal. ToFile requires entry of an output
device (SFDEV, DEU, or SLM) where the final formatted file is to be stored.
ToTerminal sends output to the screen.

The final formatted file has the name DLOG+date/timestamp of the current
time and includes a header inside the file
which echoes the parameters used in the format.
FORMATFILE

<filename>
<output options>
<starting block>

Allows you to format raw DLOG data by specifying a specific filename. This
is the current functionality of the
LOGFORMAT CI command.

&ltoutput options> are ToFile or ToTerminal.

&ltstarting block> is an optional parameter (0-4294967295).

LISTFILES

Displays the raw DLOG filenames recorded in the internal table with their
starttimes and endtimes that the DLOG
utility will search through for the desired logs.
QUIT

Exits DLOG level.

(found on http://47.161.123.123/sprint/network_support/htmls/dlog.quick.ref.html)

Getting DLOG's from the switch

==============================

DMS> dlog

Basic command format ...

DMS> format YYMMDDHHMMSS YYMMDDHHMMSS tofile VOLUME

For example ...

DMS> format 970920130000 970920235959 tofile s01dscr1

To dump the logs on your screen ...

DMS> format 970920130000 970920235959 toterminal

Or to look at only one type of log

DMS> excludeall

DMS> include pm (all PM logs)

DMS> include trk 123 (just the TRK123 logs)
DMS> includeall (include all the logs)

To get the DLOG from the switch to your UNIX box ...

DMS> diskut

DMS> lf VOLUME (same as volume used above)

DMS> compress DLOGFILENAME DLOGFILENAME_Z VOLUME text

Note: DLOGFILENAME is output from 'format' command.

For example ...

DMS> compress DLOG9709201325 DLOG9709201325_Z s01dscr1 text

Now to transfer the file ...

UNIX> ftupz SITENAME DLOGFILENAME_Z VOLUME

For example ...

UNIX> ftupz losp DLOG9709201325_Z s01dscr1

And then give the DLOG file a descriptive name ...

UNIX> mv DLOGFILENAME_Z losp970920.dlog