NAME
scstest - test PM in a SCOUT environment

SYNOPSIS
% scstest [options]

DESCRIPTION
scstest tests PM in a SCOUT environment.

NOTICE
scstest checks if the PM hardware and software configurations are set properly. In this sense, scstest i sthe same as the cstest program. However, unlike the cstest program, scstest invokes remote processes via SCOUT environment. Thus, scstest program must be invoked with in a SCOUT environment.

Users must specify the network which is defined on the scorehosts.db file. As a result, users do not have to specify configuration (and firmware) file(s), becuase they are specified in the scorehosts.db file.

On large clusters, having more than hundred hosts, users had better to use scstest rather than cstest or rcstest. cstest and rcstest invoke remote processes using the rsh Unix (linux) command. Due to the limitation of rsh scalability, cstest or rcstest may fail to invoke remote processes.

OPTIONS
-network network
The network option specifies the network name defined in the scorehosts.db file.
-chan chan
Chan is used as the PM channel number for testing.
Default is zero.
-context ctx
Ctx is used as the PM context number for testing.
Default is zero.
-len length
Length byte messages are used for testing.
Default is 8 bytes.
-count count
This option specifies the number of tests.
Default is infinity.
-pe num_pe
Num_pe PEs are tested.
Default is all PEs of the cluster.
-base base_pe
Base_pe is used as the first PE number.
Default is zero.
-burst
A burst transfer is used for testing.
This is the default.
-ping
A ping-pong transfer is used for testing instead of a burst transfer.
-v
-verbos
Show some messages while testing.
Default is that no messages are shown except errors.

EXAMPLE
% scout -g pcc
% scstest -network myrinet -pe 32 -ping
Execute a ping-pong transfer test on 32 PEs.

ERRORS
Cstest outputs the following error message when any error occurs:
node_name(pe#) function: error
function detects error on the node.
node_name(pe#) function: Operation timed out
function failed for a long time on the node.
node_name(pe#) Signal: Interrupted system call
Testing was interrupted by a signal on the node.