| Here's the source (a piece of it) that generates the \endfigure
errors...
thanks,
Bette Jean
<HEAD2>(ANALYZE\ANALYZE)
<p>
<X>(SNATRACE<XS>commands<XS>ANALYZE)
<X>(ANALYZE command)
The ANALYZE command copies the binary information in a specified
trace data file to a new file in ASCII format to help you interpret
the data.
<X>(ANALYZE command<XS>syntax)
<p>
<emphasis>(Syntax:\bold)
<p>
ANALYZE <emphasis>(file-spec)
<p>
where
<TABLE>
<TABLE_SETUP>(2\10)
<TABLE_ROW>(<emphasis>(file-spec)\
Identifies the trace data file to be analyzed. This is
the file created by
the TRACE command. The <emphasis>(file-spec) value is a standard VMS file specification.
)<ENDTABLE>
<p>
If you do not specify a file type for this file, .DAT is
the default. You cannot use wildcard characters in the file
specification.
<p>
If you do not specify a file-spec for the ANALYZE command, you are prompted for
one as follows:
<interactive>
<s>(SNATRACE> )<u>(ANALYZE <key>(Return))
<s>()
<s>(File: )
<endinteractive>
<subhead1>(ANALYZE qualifiers)
<X>(ANALYZE command<XS>qualifiers)
<p>
The qualifiers to the ANALYZE command are the following:
<qualdeflist>
<QUALITEM>(/OUTPUT=<emphasis>(file-spec))
<QUALDEF>
This qualifier identifies the output file created to store the results
of the
analysis. The default file type is .LIS. If you do not enter
a file name, the output is sent to a file that has the same name as the input
file and a file type of .LIS. If you do not specify the /OUTPUT qualifier, the
output is sent to SYS$OUTPUT. You cannot use wildcard characters in the file
specification.
<QUALITEM>(/WIDE\/NOWIDE (D))
<QUALDEF>
This qualifier specifies the width of formatted trace data. If you specify
/WIDE, the output data is arranged in a width of 132 columns.
<p>
/NOWIDE is the default. If you specify /NOWIDE or omit this qualifier
entirely, the width is 80 columns.
<ENDQUALDEFLIST>
<HEAD2>(HELP)
<X>(SNATRACE<XS>commands<XS>HELP)
<X>(HELP command<XS>format)
<p>
The HELP command gives you on-line information about the SNATRACE utility.
<p>
<emphasis>(Syntax:\bold)
<p>
HELP [<emphasis>(keyword)...]
<p>
where
<TABLE>
<TABLE_SETUP>(2\10)
<TABLE_ROW>(<emphasis>(keyword...)\Specifies one or more subjects
about which you are requesting help.
<p>
You can get help on the TRACE, ANALYZE, EXIT, and HELP commands
and their qualifiers.
)<ENDTABLE>
<HEAD2>(EXIT)
<X>(SNATRACE<XS>commands<XS>EXIT)
<p>
The EXIT command stops SNATRACE and returns control to the VAX/VMS command
interpreter.
<p>
The following example stops SNATRACE:
<interactive>
<s>(SNATRACE> )<u>(EXIT)
<s>($ )
<endinteractive>
<subhead1>(SNATRACE Example)
<p>
<X>(SNATRACE<XS>example)
The following example shows the command format for
a session level trace (session number 2)
performed on data sent over the SDLC circuit identified as SNA-0.
<comment>
warning
Is it correct to document the circuit as SNA-0 rather than SDLC-0?
<endcomment>
<p>
The output file created to contain the
trace data is called EXAMPLE.TRC. To stop the trace, press
<key>(CTRL/Z). When the trace has ended, the
SNATRACE utility analyzes the file EXAMPLE.TRC, and the formatted results
are stored in a file called EXAMPLE.LIS.
<interactive>
<s>($ )<u>(RUN SYS$SYSTEM:SNATRACE)
<s>(SNATRACE> )<u>(TRACE NODEG SNA-0/OUTPUT=EXAMPLE.TRC/SESSION=2)
<s>(%SNATRACE-I-BEGIN at 25-JUN-1986 16:37:22.40)
<s>()
<u>(<key>(CTRL/C))
<s>()
<s>%SNATRACE-I-ENDED at 25-NOV-1986 17:15:30.7
<s>(SNATRACE> )<u>(ANALYZE/OUTPUT=EXAMPLE.LIS EXAMPLE.TRC)
<s>(SNATRACE> )<u>(EXIT)
<endinteractive>
<HEAD1>(Interpreting Retrieved SNATRACE Messages)
<p>
<X>(Messages<XS>SNATRACE)
<X>(SNATRACE<XS>messages<XS>interpreting)
<X>(Interpreting SNATRACE messages)
Every trace message that you retrieve should contain a message-type value.
The following is a list of possible message-type values that you
might see:
<X>(SNATRACE<XS>messages<XS>message-type values)
<LIST>(UNNUMBERED)
<LE>R - Indicates that the message was received by the Gateway from the IBM
communications controller.
<LE>T - Indicates that the message was transmitted by the Gateway to the IBM
communications controller.
<LE>C - Indicates a request to perform a control function (this does
not appply to Gateway V2.0).
<LE>D - Indicates that the requested control function has completed
(this does not apply to the Gateway V2.0).
<ENDLIST>
<note>
Since message-type values appear only in trace message output,
they cannot be considered a true message field.
<endnote>
<p>
An SDLC circuit level trace returns values are returned for an address field
(ADDR) and a control field (CTL). See <REFERENCE>(VALUES) for information
about these values.
All levels of trace messages contain values for TH/RH/RU elements.
See the appropriate IBM documentation for information on these values.
|