CommTrace

java.lang.Object
- java.awt.event.WindowAdapter
- - com.ibm.as400.util.commtrace.CommTrace

All Implemented Interfaces:

java.awt.event.WindowFocusListener, java.awt.event.WindowListener, java.awt.event.WindowStateListener, java.util.EventListener
```
public class CommTrace
extends java.awt.event.WindowAdapter
```
Provides a front end for the Format class, to display and transfer a communications trace file.
The trace must originate from a system (running OS/400 V5R2 or greater) and reside in the IFS directory structure.
The trace should be created with the following sequence of commands:
```
 STRCMNTRC
 ENDCMNTRC
 DMPCMNTRC
 
```
The next step is to either format the trace file, or transfer it to the local PC. The format can be done in two different ways.
- Using the "Format" button on the main window.
- Using the Commtrace->Format menu option
The two options are equivalent.
The format that will be performed can be affected by changing the selection of the "Remote" and "Local" radio button.

If Remote is selected:
The file will be formatted remotely on the IBM i system using JavaCommandCall. The output file will be an IFS file in the same directory as the trace but with a .bin extension appended. The progress of the format operation is not relayed to the Commtrace program unless the -verbose option is specified. A dialog will appear when the format has completed.
The file will then be displayed on the local PC. Any previous format can be displayed by selecting the "Display" button or using the Commtrace->Display menu option.
The formatted file could also be transfered to the local PC using the "Transfer" button or Commtrace->Transfer menu option and then displayed locally using the "Display" method.

If Local is selected:
The file must be transfered to the local PC using the transfer methods described above. A progress dialog will appear showing the transfer as it progresses.
The file can then be formatted by selecting the Format button or menu option.
A progress dialog will appear when formatting and display the progress of the format.
After the formatting is complete the trace will be displayed as described in the FormatDisplay class.
CommTrace can be run as an application as follows:
```
 java com.ibm.as400.commtrace.Commtrace [options]
 
```
Options:

-verbose/-v [true|false]

Specifies whether to print status and other information to System.out

Constructor Summary

Constructors
Constructor and Description

CommTrace(java.lang.String[] args)
Base constructor which creates a Commtrace.

Constructors
Constructor and Description
`CommTrace(java.lang.String[] args)` Base constructor which creates a Commtrace.

Method Summary

Methods
Modifier and Type	Method and Description
`static void`	`main(java.lang.String[] args)` Called by the JVM to start the CommTrace Utility.
`void`	`windowClosing(java.awt.event.WindowEvent e)` Invoked when a window is in the process of being closed.

Methods inherited from class java.awt.event.WindowAdapter
windowActivated, windowClosed, windowDeactivated, windowDeiconified, windowGainedFocus, windowIconified, windowLostFocus, windowOpened, windowStateChanged

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Constructor Detail
  - CommTrace
```
public CommTrace(java.lang.String[] args)
```
    Base constructor which creates a Commtrace.
    
    Parameters:
    args - The command line arguments
- Method Detail
  - windowClosing
```
public void windowClosing(java.awt.event.WindowEvent e)
```
    Invoked when a window is in the process of being closed.
    
    Specified by:
    
    windowClosing in interface java.awt.event.WindowListener
    
    Overrides:
    
    windowClosing in class java.awt.event.WindowAdapter
    
    Parameters:
    e - The event for this window.
  - main
```
public static void main(java.lang.String[] args)
```
    Called by the JVM to start the CommTrace Utility.
    
    Parameters:
    args - The arguments from the command line.

Methods inherited from class java.awt.event.WindowAdapter

Methods inherited from class java.lang.Object

CommTrace

windowClosing

main