The following release notes for Collect for Tru64 UNIX® describe enhancements, new features, and restrictions for this release. These notes are applicable to Version 5.2 and earlier releases of Tru64 UNIX.

Legal

December 2000

© 2000 Compaq Computer Corporation

Compaq, the Compaq logo, and the Digital logo are registered in the U.S. Patent and Trademark Office. Alpha, AlphaServer, NonStop, TruCluster, and Tru64 are trademarks of Compaq Computer Corporation.

Microsoft and Windows NT are registered trademarks of Microsoft Corporation. Intel, Pentium, and Intel Inside are registered trademarks of Intel Corporation. UNIX is a registered trademark and The Open Group is a trademark of The Open Group in the United States and other countries. Other product names mentioned herein may be the trademarks of their respective companies.

Possession, use, or copying of the software described in this publication is authorized only pursuant to a valid written license from Compaq Computer Corporation or an authorized sublicensor.

Compaq Computer Corporation shall not be liable for technical or editorial errors or omissions contained herein. The information in this document is subject to change without notice.

Preface

Collect is a data collector for operating system and process statistics, designed for high reliability and very low system overhead. Unless you set Collect to gather all possible data at frequent intervals, it does not have a significant performance impact.

For more information, see the collect(8) reference page.

Operation Notes

The following operation notes may help you with your use of Collect:

Recent Changes

The following changes and enhancements have been made to Version 2.0 as of August, 2000:

Historic Changes

The following changes may be of interest to early adopters of Collect:

January - December, 1999 (Version 2.0)

August - October, 1998 (Version 1.09 - 1.10)

collgui

June - August, 1998 (Version 1.08d - 1.09)

collgui

Miscellaneous

ß Added entries to /etc/magic so that file collect.output works.

June - July, 1997 (Version1.08b - 1.08c)

May, 1997 (Version 1.07 - 1.08)

cfilt

collgui

December, 1996 (Version 1.06 - 1.07)

October, 1996 (Version 1.05 - 1.06)

  • Added to process info input blocks, output blocks, major faults and minor faults. This caused the line to be longer than 80 columns, requiring the next fix.
  • Added the -F option. Normally, not all fields are printed, and some things, such as RSS and VSZ are converted to compact format using K, M, and G tags. The -F option causes all information to print, in expanded form.
  • Added to memory info processes swapped per second, UBC hits/sec, UBC pages pushed (written)/sec, and UBC pages allocated/sec.
  • Improved the -C (chop out a timeslice) flag. The format is somewhat different: Either the start or end time can be in the format [+]Year:Month:Day:Hour:Minute:Second. If there is a plus-sign at the beginning, then the time specified is relative to the beginning of the collection period. If there is no plus sign, then the time is absolute. Any of Year, Month, Day, Hour, or Minute can be left off, in which case the values from the beginning of the collection period are taken. Therefore, if you collected from 10:23:34 to 10:44:15 on October 16th, you could use -C24:00,25:00 to extract samples from 10:24:00 to 10:25:00. You could also use: -C10:24:00,10:25:00, or even C16:10:24:00,16:10:25:00, etc. If no start time (-C,10:25:00) or no end time (-C10:24:00,) is given, then the collection start and end times are used, respectively.
  • Added (-l) option to seek to and print the last valid record. This aids collgui, reducing the time to open a large binary data file.
  • Adjusted collgui to use the new time format of Collect.
  • New reference page for collgui.
  • New reference page for cfilt.
  • Added call to task_set_notify_port so that kernel doesn't store non-deliverable mach messages and eat memory.
  • September, 1996 (Version 1.04 - 1.05)

    September, 1996 (Version 1.03 - 1.04)

    August 26, 1996 (Version 1.02 - 1.03)

    August 8, 1996 (Version 1.01 - 1.02)

    July 14, 1996 (Version 1.00 - 1.01)

    Kit location

    Collect is included with the current release of Tru64 UNIX, and updates will be included in the patch kit releases for Tru64 UNIX. Currently, Collect is freely available from the following FTP locations:

    ftp://ftp.digital.com/pub/DEC/collect (US)
    ftp://ftp.digital.de/pub/digital/collect/ (Germany)

    This is the Collect kit at these sites:

    COLLECT_SETLD_LATEST.tar.gz (setld kit)

    This Perl kit is also available if you want to use the GUI or filter scripts:

    PERL5004SETLD.tar.gz (DIGITAL UNIX Version 4.0+, and all versions of Tru64 UNIX)

    Perl

    The above setld kit for Perl includes the Tk extension. If you want to use the graphical user interface for Collect, collgui, you must get this kit and install it using the standard software installation utility setld.

    If you already have Perl, you may not have the Tk extension for Perl (not the same as Tcl/Tk). You can still use cfilt. Edit /usr/bin/cfilt and set the path of Perl to where you have Perl installed. If you also have Tk for Perl, you need to edit /usr/bin/collgui and set the path in the same way.

    Questions and Comments

    If you have any questions or comments, please send mail or telephone the Compaq Customer Support Center at this address:

    Customer Support Center
    Compaq Computer Corporaton
    5555 Windward Parkway West
    Alpharetta, GA 30004-7407
    770.343.0000


    Collect for Tru64 UNIX
    Compaq Computer Corporation
    http://www.tru64unix.compaq.com/collect/