/sys$common/syshlp/NCLHELP.HLB  —  NCL Introduction, Using Snapshot, Tru64 UNIX
    Snapshot saves all of the counter attributes available
    from the specified entity at that time. You can snapshot only
    counters, and the results are displayed using a subsequent
    show command. For example, do either of the following:

    ncl> snapshot node 0 all counters

    or

    ncl> snapshot node 0 all counters, to file_name

    If you omit the attribute list entirely from the snapshot
    command, NCL defaults to all counters.

    If you do not choose a file name, NCL retains the binary data
    in memory. If you enter the show command for which the remote
    entity returns any counters, NCL tries to find snapshot data
    in the snapshot file you specified (or within its memory, if
    you did not specify a file name).

    If your show command does not contain the from preposition, NCL
    tries to find a corresponding snapshot in memory. If you
    have not performed a snapshot command in this NCL session, NCL
    displays just the raw counters.

    If the show command does contain the from preposition, NCL tries
    to read the specified file. If NCL cannot open the file, it
    returns the appropriate error message and displays the data
    returned from the entity. If a snapshot file exists, but does
    not contain data from the current entity, NCL displays just the
    raw counters.

    If NCL succeeds in finding a saved snapshot of the entity's
    counters, then it displays the counters returned by the agent.
    The following example shows a typical snapshot file, in this
    instance called x.tmp:

    ncl> snapshot 12.80 csm sta * oct se, oct r, to x.tmp

    To recall the snapshot file x.tmp, you would use the following
    command:

    show n 12.80 csm sta *, from x.tmp

    Node 12.80 CSMA-CD Station csmacd-1
    AT 1994-09-08-11:12:01.497-04:00I0.165
    Snapshot Elapsed Time = +0-02:01:47.536I0.428

                       Current     Snapshot    Difference
                       -------     --------    -----------
   Counters
    Octets Sent        64354851    45070297    19284554
    Octets Received    34030180    27575906    6454274

    To list all the snapshots that NCL is holding "in memory,"
    use the command:

    ncl> show ncl snapshots

    To eliminate the snapshot corresponding to a value, thus
    allowing counters to be displayed in the normal name=value
    format, use the command:

    ncl> clear ncl snapshot 50

    without this, the only way to get back to a normal display
    is to exit NCL and reinvoke it.

    To periodically poll the value of a counter and display it
    (using the snapshot format) until ^C'ed, use the command:

    ncl> cmonitor entity counter

    this is similar to netstat and iostat which allow you to
    monitor a value by specifying an interval.

    To control what the interval between polls should be, use
    the commands:

    ncl> set ncl cmonitor time = 5
    ncl> show ncl cmonitor time
Close Help