Log Viewer Functions

The Z and I Emulator for Windows log viewer utility enables you to view, merge, sort, search, and filter information contained in message and trace logs. You can use the viewer during problem determination to work with message and trace log entries. The default name of the message log output file is PCSMSG.MLG; its file extension must be .MLG. The file extension for trace logs must be .TLG. Note that the Help per Message Log Item functionality is available only for message logs.

Viewing Message and Trace Logs

To view message or trace logs:

  1. From the Administrative and PD Aids folder, click Log Viewer; or, from an active session window, click Actions -> Launch -> Log Viewer.
  2. From the list of logged messages, click on one of the details on the log entry in the bottom pane.
Note:
If the logger device driver determines that the product kernel driver-generated log is full and cannot log a message, it will create an entry in the Windows log. The information logged may include which log failed, as well as the location and reason for the failure.

Changing Message Log Size and Location

The Z and I Emulator for Windows log viewer utility allows you to modify the size and location of message log files, and change the name of the default message log file. The size of a log file is counted in kilobytes and can range from a minimum of 4Kb to a maximum limited only by available hard disk space.

To modify the location and size of the log:

  1. From the Log Viewer main menu, click Options and then click Configure Message Log Settings... A Windows common dialog box is displayed.
  2. From the dialog box, browse the directory structure and choose the destination directory and file name for the message log.
  3. Using the spin control counter field, use the up and down arrows to increase or decrease the log file size (in kilobytes).
  4. Select OK to save settings and exit the window.

Merging Message and Trace Logs

The Z and I Emulator for Windows log viewer utility allows you to open and merge message and trace log entries in the same log viewer window. You can merge any combination of message and trace log files.

To merge message and trace log files:

  1. From the Log Viewer window, select the message or trace log file window where the files will be merged.
  2. Click the File menu, then click Merge and choose a file to be merged.

Sorting Message and Trace Logs

The Z and I Emulator for Windows log viewer utility allows you to sort message and log files in ascending and descending order. To sort files in ascending order, click the column header one time, or right mouse click the data. Click the column header, or right mouse click the data a second time to sort in descending order.

Message and logs can also be sorted by selecting the data to be sorted, and right mouse clicking to display the pop-up menu. Click Sort.

Searching Z and I Emulator for Windows Logs

To search the log files, click Edit -> Find on the Main menu.

Type your search string in the provided box. You can refine your search by checking the Match case check box if your search is to be case-specific. If you want to limit your search to only complete words, select the Match whole word only check box.

Clicking Find Next takes you to the next instance where your search string appears highlighted in the log.

Clicking Cancel will stop the search.

Filtering Z and I Emulator for Windows Logs

Messages can be filtered by component only. Traces can be filtered by component, by process ID, and by thread ID.

To filter the message or trace record list, do the following:

  1. Decide what you want to filter by. For example, in the message log, you may want to filter your view so that it contains only messages issued by a particular component. (Filtering by component is the default.)
  2. Click the left mouse button to highlight the item that has the value that you want to filter by.
  3. Right click in the appropriate column list area.
  4. Click Filter In, Filter Out or Sort.

    Filter In allows only those items selected to be in the resulting view. Filter Out removes the selected items from the resulting view. Sort allows you to sort entries in ascending or descending order based upon the entry selected. This function works much like sorting by column header. Filters are cumulative, so you can filter the results of your first filter.

To restore your original view, click View and then Refresh, or you can press F5.

Building a Printer Definition Table (PDT)