NAME

       dpm_abortreq - abort a given get, put or copy request

SYNOPSIS

       #include <sys/types.h>
       #include "dpm_api.h"

       int dpm_abortreq (char *r_token)

DESCRIPTION

       dpm_abortreq  aborts  a given get, put or copy request.  The request status and the status
       of every file belonging to this request and still in the queue is set to DPM_ABORTED.

       r_token
              specifies the token returned by a previous get, put or copy request.

RETURN VALUE

       This routine returns 0 if the operation was successful or -1 if the operation  failed.  In
       the latter case, serrno is set appropriately.

ERRORS

       EACCES       Permission denied.

       EFAULT       r_token is a NULL pointer.

       EINVAL       The length of r_token exceeds CA_MAXDPMTOKENLEN or the token is unknown.

       SENOSHOST    Host unknown.

       SEINTERNAL   Database error.

       SECOMERR     Communication error.