4.33 Inquire the number of pending nonblocking requests: ncmpi_inq_nreqs

This API reports the number of pending nonblocking requests.

Operational Mode

This API is an independent subroutine.

This API can be called while the file is in either define or data mode (collective or independent).

Usage

int ncmpi_inq_nreqs(int  ncid,
                    int *nreqs);

ncid

NetCDF ID, from a previous call to ncmpi_open or ncmpi_create.

nreqs

Number of pending requests. Prior to 1.9.0, if this argument is NULL, error code NC_EINVAL is returned. Starting from 1.9.0, if this argument is NULL, it is ignored.

Return Error Codes

ncmpi_inq_nreqs returns the value NC_NOERR if no errors occurred. Otherwise, the returned status indicates an error. Possible causes of errors include:

• NC_EBADID: The specified netCDF ID does not refer to an opened netCDF file.
• NC_ENOTSUPPORT: This API for NetCDF-4 files is not yet supported.

Example

Here is an example using ncmpi_inq_nreqs.

#include <pnetcdf.h>
   ...
int nreqs, err;
   ...

err = ncmpi_inq_nreqs(ncid, &nreqs);

if (err != NC_NOERR)
    fprintf(stderr, "Error on calling ncmpi_inq_nreqs (%s)\n",
            ncmpi_strerror(err));