[Next] [Previous] [Top]

Dynamic PVM Configuration

PVMFCONFIG()

PVMFCONFIG(NHOST, NARCH, DTID, NAME,

ARCH, SPEED, INFO)

• nhost - integer returning the number of hosts in the virtual machine

• narch - integer returning the number of different data formats being used. Note narch=1 indicates a homogeneous machine

• dtid - integer returning pvmd task ID for this host

• name - character string returning the name of this host

• arch - character string returning the name of host architecture

• speed - integer returning relative speed of this host ie default = 1000

• info - integer status code returned by the routine, values less than 0 indicate an error

DO i = 1, NHOST

CALL PVMFCONFIG(NHOST, NARCH,

DTID(i), HOST(i), ARCH(i), SPEED(i), INFO)

ENDDO

• Error condition returned by this is PvmSysErr when the pvmd is not responding

PVMFADDHOST()

PVMFADDHOST(HOST, INFO)

• host - a character string containing the name of the machines to be added

• info - status code (values <1 indicate failure)

• add more hosts as they become available or if the application determines it could use more computational power

CALL PVMFSPAWN ('prog',flag,'pawnee-atm',

1,TIDS(1),NUMT)

PVMFDELHOST()

PVMFDELHOST(HOST, INFO)

• host - a character string containing the name of the machines to be deleted

• info - status code where a value <1 indicates a failure

• pvmfnotify - can be used to notify an application of the failure of a host

CALL PVMFDELHOST(`pawnee-atm', INFO)

PVMFNOTIFY()

PVMFNOTIFY(WHAT, MSGTAG, COUNT,

TIDS, INFO)

• what - integer identifier of event should trigger the notification eg
  • PvmTaskExit - notify if tasks exits

  • PvmHostDelete - notify if host is deleted

  • PvmHostAdd - notify if host is added

• msgtag - message tag to be used in notification

• count - length of tids array for PvmTaskExit and PvmHostDelete

• tids - integer array of length the number of tasks to be notified - should be empty with a PvmAddHost option

• info - status code where a value <0 indicates a failure

• calling task(s) are responsible for receiving the message with the specified message tag and taking the appropriate action

• future PVM versions may expand the list of notifiable events

CALL PVMFNOTIFY (PVMHOSTDELETE,

1111,NPROC, TIDS, INFO)

PVMFTASKS()

• Returns information about the tasks running on the virtual machine

• Similar to a ps console command

• C - all information returned in one call

• Fortran - information about one task per call, repeated calls cycle through all tasks

DTID, FLAG, AOUT, INFO)

• where - integer specifying what tasks to return information about
  • 0 - all tasks on the virtual machine

  • pvmd tid - all tasks on a given host

  • tid - specific task

• ntask - returns the number of tasks being reported on

• tid - integer returning task ID of one task

• ptid - integer returning parent task ID

• dtid - returns pvmd task ID of host task

• flag - returns the status of task

• aout - character string returning the name of the spawned task

• info - status code returned by the routine ie <0 indicates an error

PVMFKILL()

PVMFKILL(TID, INFO)

• tid - integer task identifier of the PVM process to be killed ie not yourself

• info - integer status code returned by the
  routine, values less than zero indicate an
  error

• pvmfexit() is used to kill yourself

• Error conditions returned by pvmfkill are
  • PvmBadParam - giving an invalid tid value

  • PvmSysErr - pvmd not responding

PVMFTIDTOHOST()

PVMFTIDTOHOST(TID, DTID)

• tid - task identifier

• dtid - tid of the host's pvmd

CALL PVMFTIDTOHOST(TID, HOSTID)

PVMFCATCHOUT()

PVMFCATCHOUT (ONOFF)

• this routine causes the parent task to catch output from tasks spawned after this call

• output collection can only be turned on or off and is logged to stdout of the parent task

CALL PVMFCATCHOUT(1)

This switches output collection on 0 switches it off.