pvm_tasks - information about the tasks running on the virtual machine.

Calling Sequence

res = pvm_tasks([where])

Parameters

• where : (optional) integer, specifying what tasks to return information about. The options are:

  
   0(default) for all the tasks on the virtual machine
   pvmd tid for all tasks on a given host
     tid  for a specific task
     
            

• res : list of 7 elements such that:
  • res(1) : integer returning task ID of one task
  • res(2) : integer returning parent task ID
  • res(3) : integer returning pvmd task ID of host task is on
  • res(4) : integer returning status of task
  • res(5) : string returning the name of spawned task. Manually started tasks return blank.
  • res(6) : integer returning the number of tasks being reported on.
  • res(7) : integer status code returned by the routine.

Description

pvm_tasks returns information about tasks presently running on the virtual machine. The information returned is the same as that available from the console command

The pvm_tasks function returns information about the entire virtual machine in one call.

If pvm_tasks is successful,

will be 0. If some error occurs then

will be < 0.

for example:

-->res = pvm_tasks()
 res  =
 
       res(1)
 
!   262148.    262151.    262152. !
 
       res(2)
 
!   262147.    0.    262151. !
 
       res(3)
 
!   262144.    262144.    262144. !
 
       res(4)
 
!   6.    4.    6. !
 
       res(5)
 
!pvmgs    /home/ubeda/SCILAB/scilab-2.4/bin/scilex  !
 
       res(6)
 
    3.  
 
       res(7)
 
    0. 
   
    

See Also

pvm_config ,   pvm_tidtohost ,