rvperfs

Command

Syntax

rvperfs  [-service service ]
         [-network network ]
         [-daemon daemon ]
         [-subject subject ]
         [-non-vectored]
         [-cm]
         [-cm-name name ]
         [-cm-ledger filename ]
         [-cm-sync]
         [-h]

Purpose

rvperfs listens for messages from rvperfm, gathers and reports statistics to rvperfm at the end of each run.

Remarks

rvperfs operates passively; it sends messages only in response to requests from rvperfm.

You can leave process instances of rvperfs running idle. Each instance of rvperfs can report statistics from several consecutive process instances of rvperfm—as long as only one rvperfm executes at a time. You can relocate the rvperfm process from one host computer to another without restarting the rvperfs processes.

Unlike rvperfm, an rvperfs process never exits by itself. You must explicitly terminate each rvperfs process.

In addition to sending its statistics to rvperfm, rvperfs also prints its report to stdout.

Parameter

Description

-service service

service is the service name or UDP port number that defines the service group.

See Service Selection.

If you do not specify the -service parameter, the default value is 7599.

-network network

network narrows the service group by selecting a local network by network name or IP network number (when the host computer has multiple network interfaces). It can also specify multicast addresses.

See Network Selection.

If you do not specify the -network parameter, the default value is the multicast address ";225.9.9.9".

-daemon daemon

The -daemon parameter instructs the program about how and where to find rvd and establish communication.

See Daemon Client Socket—Establishing Connections.

You can specify a daemon on a remote computer. For details, see Remote Daemon. However, the program cannot start a remote daemon automatically—you must start it manually on the remote computer.

If you do not specify the -daemon parameter, the program finds the local daemon on TCP socket 7500.

-subject subject

rvperfs listens for messages with this subject name.

If this parameter is absent, then rvperfs uses _perf as a prefix to construct broadcast subjects.

(When you specify the -inbox flag to rvperfm, you need not specify this rvperfs parameter.)

-non-vectored

When present, rvperfs receives messages individually, using an ordinary listener.

When absent, rvperfs receives messages using a vector listener.

-cm

When present, rvperfs listens for messages using certified delivery features. If rvperfm also specifies -cm, then the programs establish a certified delivery agreement.

-cm-name name

When present, rvperfs specifies this reusable correspondent name when it enables certified delivery.

When -cm is present, but -cm-name is not, rvperfs operates with a non-reusable correspondent name.

-cm-ledger filename

When present, rvperfs uses this ledger file. You must also supply -cm-name.

-cm-sync

When present, then operations that update the ledger file do not return until the changes are written to the storage medium. You must also supply -cm-ledger and -cm-name.

When absent, the operating system writes ledger file changes to the storage medium asynchronously.

-h

When present, output a parameter usage list to stdout, and exit immediately.