redhat man page for pvm_advise

Query: pvm_advise

OS: redhat

Section: 3pvm

Format: Original Unix Latex Style Formatted with HTML and a Horizontal Scroll Bar

ADVISE(3PVM)							  PVM Version 3.4						      ADVISE(3PVM)

NAME
pvm_advise() - Controls use of direct task-to-task routing. [In Version 3.2: Replaced by pvm_setopt]
SYNOPSIS
C int info = pvm_advise( int route ) Fortran call pvmfadvise( route, info )
PARAMETERS
route Integer advising PVM to set up direct task-to-task links. route options PvmDontRoute 1 Don't allow direct links to this task PvmAllowDirect 2 Allow but don't request direct links PvmRouteDirect 3 Request direct links info Integer returning error status.
DESCRIPTION
The routine pvm_advise advises PVM on whether or not to set up direct task-to-task links (using TCP) for all subsequent communication. Once a link is established it remains until the application finishes. If a direct link can not be established because one of the two tasks has requested PvmDontRoute or because no resources are available, then the default route through the PVM daemons is used. pvm_advise can be called multiple times to selectively establish direct links, but is typically set only once near the beginning of each task. PvmAllowDi- rect is the default advise setting. This setting on task A allows other tasks to set up direct links to A. Once a direct link is estab- lished between tasks both tasks will use it for sending messages. pvm_advise returns the error status in info. The performance of direct task-to-task links can be up to a factor of two better than the default route. The draw back is a lack of scalability of the direct links. Some versions of UNIX limit the number of links to no more than 30.
EXAMPLES
C: info = pvm_advise( PvmRouteDirect ); Fortran: CALL PVMFADVISE( PVMROUTEDIRECT, INFO )
ERRORS
This error condition can be returned by pvm_advise PvmBadParam giving an invalid route value.
SEE ALSO
pvm_setopt(3PVM) 30 August, 1993 ADVISE(3PVM)
Related Man Pages
pvm_getfds(3pvm) - redhat
pvm_setopt(3pvm) - redhat
pvm_getfds(3pvm) - debian
pvm_send(3pvm) - debian
pvm_setopt(3pvm) - debian
Similar Topics in the Unix Linux Community
Connect to RAS callback server: route problem
What is Orca?
Select only top "N" records based on column value
How not to install fibre links between data centres!
Disabling SSH direct access for an AIX user