CTF$HELP.HLB  —  ANALYZE
 The ANALYZE command formats and displays the contents of a trace file.
 The command is also used to specify the format in which trace data is
 displayed, either during live tracing or when the contents of a trace
 file are displayed.

 Format:

 	ANALYZE [file-spec] [/qualifiers]

 If you issue the ANALYZE command while displaying a trace file,
 and you do not specify a filename, the qualifiers you use will be
 applied to the trace file being displayed.

1  –  Parameters 

 The command has the following optional parameter:

 file-spec

 	Specifies the name of the trace file to be displayed.

 	The default is the file CTF$TRACE.DAT in your default
 	directory. You cannot specify this parameter if you are
  	performing live tracing.

 	If you do not specify a file version number, the ANALYZE
 	command starts at the lowest version of the trace file and
 	processes each version of the file in turn.

2  –  Command qualifiers 

 The ANALYZE command has the following qualifiers:

  /BEFORE   /BRIEF   /DATA      /DISPLAY	    /FILTER   /FULL   /NAME
  /OUTPUT   /PAGE    /PROTOCOL  /REVERSE	    /SAVE_BUFFER_SIZE
  /SCROLL   /SELECT  /SINCE     /TRACE_LEVEL /TRUNCATE /WIDTH

3    /BEFORE 

  /BEFORE=time

 	Specifies that only trace records collected before the
 	specified time are to be displayed.

 	Specify the time in standard VMS format.

4    /BRIEF 

  /BRIEF

 	Specifies that a single-line analysis of the protocol data in
 	each trace record is displayed. This qualifier is effective
 	only if the relevant protocol analysis routines support
 	abbreviated analysis of protocol data.

 	/BRIEF is the default display.

5    /DATA 

  /DATA=(data-type,...)
  /NODATA

        Use /DATA to specify the format(s) of the output.

        Valid data-types are:

        DECIMAL, OCTAL, HEXADECIMAL, ASCII and EBCDIC

6    /DISPLAY 

  /DISPLAY=(field,...)
  /NODISPLAY

 	Specifies which fields of a trace record (other than the
 	protocol data itself) are displayed.

 	The fields that can be displayed are:

 	[NO]ALL             All the fields shown below are
                             displayed.
 	[NO]CONTEXT         Tracepoint-specific information.
 	[NO]EVENT           Trace event code.
 	[NO]FUNCTION_CODE   The tracepoint-specific function code
                             of the operation being traced.
 	[NO]NAME            The name of the tracepoint from which
                             the trace record was collected. Names
                             longer than 16 characters will be
                             truncated on the right.
 	[NO]SIZE            The original size of the trace data, in
                             bytes.
 	[NO]STATUS          If the value in this field is non-zero, it
                             is the current status of the operation
                             being traced.
 	[NO]TIME            The time at which the trace record was
                             collected.

 	The default display is:

 	TIME
 	EVENT
 	SIZE

7    /FILTER 

  /FILTER=(event-code,...)
  /NOFILTER

 	Specifies a filter for trace records.

 	A trace record is displayed only if its event code is one of
 	those specified in the filter. This value overrides the
 	current filter, if any.

 	You cannot specify this qualifier with /SELECT or
 	/TRACE_LEVEL.

 	The default is /NOFILTER.

8    /FULL 

  /FULL

 	Specifies that a multi-line analysis of each trace record is
 	produced. This qualifier is effective only if the relevant
 	protocol analysis routines support full analysis of protocol
 	data.

 	The default, if you do not specify /FULL, is /BRIEF.

9    /NAME 

  /NAME=instance-name

 	Specifies the instance part of a tracepoint name.

 	A trace record is displayed only if it came from the specified
 	tracepoint. If you specify only the first part of an instance
 	name, trace records are displayed from all tracepoints whose
 	name begins with this string.

 	The default is to display trace records from all active
 	tracepoints.

10    /OUTPUT 

  /OUTPUT[=output-filename]

 	Specifies the name of a file to which the formatted trace
 	records are to be written.

 	If you specify /OUTPUT without a filename, the default is to
 	display the output on your terminal.

 	You cannot use this qualifier if you are performing live
 	tracing.

11    /PAGE 

  /PAGE=lines-per-page

 	Specifies the number of lines per page when writing output to
 	a file.

 	This qualifier has no effect if trace records are being
 	displayed on your terminal.

 	The default is defined by the logical name SYS$LP_LINES, which
 	usually has the value 66.

12    /PROTOCOL 

  /PROTOCOL=(protocol-identifier,...)
  /NOPROTOCOL

 	Specifies the type of analysis performed on each trace record.

 	The protocol data in each trace record is analyzed for each of
 	the protocols listed in the /PROTOCOL qualifier, in the order
 	in which they are specified.

 	If you do not specify this qualifier, only the protocol data
 	supplied at the protocol level of the originating tracepoint
 	is analyzed; protocol data from higher levels is displayed,
 	unanalyzed, as user data.

 	If you specify /NOPROTOCOL, no analysis is performed on the
 	protocol data in the trace record; it is all presented as user
 	data.

13    /REVERSE 

  /REVERSE
  /NOREVERSE

 	Specifies that received data will be displayed in reverse
 	video, and titles will be displayed in bold.

 	The default is /REVERSE.

14    /SAVE_BUFFER_SIZE 

  /SAVE_BUFFER_SIZE=n

 	Specifies how many screens of saved lines of data will be
 	kept.

 	These screens can be examined by using the NEXT and BACK
 	commands.

 	The default is 30. The minimum is one screen. The maximum is
 	1000 screens.

15    /SCROLL 

  /SCROLL
  /NOSCROLL

 	Specifies whether data is displayed continuously or a page at
 	a time.

 	If you specify /NOSCROLL, you have to issue the NEXT or BACK
 	command to display the next screen or previous screen.

 	The default is /SCROLL, which causes data to be displayed
 	continuously.

16    /SELECT 

  /SELECT=(protocol-identifier,...)

 	Specifies which protocol analyses are to be displayed.

 	This qualifier is only useful if you have used the /PROTOCOL
 	qualifier to request multiple protocol analysis of a trace
 	record.

 	The default is to display all the protocol analyses requested
 	by the /PROTOCOL qualifier.

17    /SINCE 

  /SINCE=time

 	Specifies that only trace records collected since the
 	specified time are to be displayed.

 	Specify the time in standard VMS format.

18    /TRACE_LEVEL 

  /TRACE_LEVEL=(protocol-identifier,...)

 	Normally, CTF will display the analysis for a single protocol,
 	even if the trace file contains trace records from more than
 	one protocol. By default, CTF will analyze only those trace
 	records with the same protocol as the first trace record in
 	the trace file.

 	However, if you use this qualifier, all the specified
 	protocols will be analyzed.

 	You cannot use this qualifier with either /FILTER or /SELECT.

19    /TRUNCATE 

  /TRUNCATE
  /NOTRUNCATE

 	Specifies whether data that will not fit on one line is
 	truncated or continued on the next line.

 	The default is /TRUNCATE for live tracing and /NOTRUNCATE for
 	analysis of a file.

20    /WIDTH 

  /WIDTH=n

 	Specifies the width of the output page, in columns.

 	If the data is written to a file, the default is 132.

 	If the data is displayed on your terminal, the default is the
 	width of your screen.

21  –  Examples 

 CTF> ANALYZE/OUTPUT=TRACE_ASC.LIS

 	This command formats the contents of the default trace file,
 	CTF$TRACE.DAT, and places the formatted data in a file called
 	TRACE_ASC.LIS.

 CTF> ANALYZE/FILTER=(RX,TX)

 	This command displays the contents of the default trace file,
 	CTF$TRACE.DAT, on your terminal. Only trace records with event
 	code RECEIVE or TRANSMIT will be displayed.
Close Help