OSI/FTAM and OSI/APLMGR SCF Reference Manual

PTrace Reference for Tandem FTAM
OSI/FTAM and OSI/APLMGR SCF Reference Manual421943-001
5-9
FILTER Command
In the above example, only DSM records were written to the trace file. Therefore, the
DSM keyword does not need to be repeated in the PTrace command.
FILTER Command
The PTrace FILTER command allows you to more narrowly define the trace information
to be displayed from PROV, ASN1, and USER trace records generated by initiator and
responder processes. It allows you to select records for display according to the content
of the record. Using the FILTER command in conjunction with the SELECT command,
you can request a subset of the information specified by a SELECT option.
Each FILTER option defines a particular type of process activity associated with the
corresponding SELECT option. For example, specifying the FILTER option ASN1ENC
indicates that the only ASN.1 trace records to be displayed are those for encoding.
The FILTER command is not required, nor is it required to use the FILTER command in
conjunction with the SELECT command. If you do not use the FILTER command, all
trace-record information defined by the SELECT command is displayed. If you issue a
FILTER command without using a SELECT command, the PTrace utility displays all
other record types in addition to the subset of information for the record type requested
in the FILTER command.
For example, you could specify the ASN1DEC FILTER option without specifying the
ASN1 SELECT option. In such a case, PTrace displays only the ASN1 decoding records
of the ASN1 record type, and displays all other non-ASN1 record types, including
PROV, USER, DSM, MEM, MSG, SYSMSG, and SM.