BB_GetTransferHandle

NAME

BB_GetTransferHandle - Retrieves a transfer handle.

SYNOPSIS

#include <bb/include/bbapi.h>

int BB_GetTransferHandle(BBTAG tag, uint64_t numcontrib, uint32_t contrib[], BBTransferHandle_t *handle)

DESCRIPTION

The BB_GetTransferHandle routine retrieves a transfer handle based upon the input criteria. If this is the first request made for this job using the input tag and contrib values, a transfer handle will be generated and returned. Subsequent requests made for the job using the same input tag and contrib values will return the prior generated value as the transfer handle.

Transfer handles are associated with the current jobid and jobstepid. If numcontrib==1 and contrib==NULL, the invoker’s contributor id is assumed. Error code

param

tag = User-specified tag

numcontrib = Number of entries in the contrib[] array

contrib = Array of contributor indexes

handle = Opaque handle to the transfer

retval

0 = Success

errno = Positive non-zero values correspond with errno. strerror() can be used to interpret.