1 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. 2 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 2 /BEFORE /BEFORE=time Specifies that only trace records collected before the specified time are to be displayed. Specify the time in standard VMS format. 2 /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. 2 /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 2 /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 2 /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. 2 /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. 2 /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. 2 /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. 2 /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. 2 /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. 2 /REVERSE /REVERSE /NOREVERSE Specifies that received data will be displayed in reverse video, and titles will be displayed in bold. The default is /REVERSE. 2 /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. 2 /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. 2 /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. 2 /SINCE /SINCE=time Specifies that only trace records collected since the specified time are to be displayed. Specify the time in standard VMS format. 2 /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. 2 /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. 2 /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. 2 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.