NuSDaS Interface Reference Manual

NUSDAS_INQ_CNTL

SYNOPSIS

/* C */
    int
nusdas_inq_cntl(type1, type2, type3, btime, memb, vtime1,
  param, value, vsize)

    int
nusdas_inq_cntl2(type1, type2, type3, btime, memb, vtime1, vtime2,
  param, value, vsize)

! Fortran
SUBROUTINE NUSDAS_INQ_CNTL(type1, type2, type3, btime, memb, vtime1, &
  param, value, vsize, iostat)
SUBROUTINE NUSDAS_INQ_CNTL2(type1, type2, type3, btime, memb, &
  vtime1, vtime2, param, value, vsize, iostat)
symbolFortranC
param(should be constant/macro defined in header file)
value(may be various type)void *
vsizeINTEGERN_SI4 *
iostatINTEGER, INTENT(OUT)(not used)

DESCRIPTION

Meaning of arguments is same to that of NUSDAS_INQ_DEF. However, only following parameter symbols are acceptable: N_MEMBER_NUM, N_MEMBER_LIST, N_VALIDTIME_NUM, N_VALIDTIME_LIST, N_PLANE_NUM, N_PLANE_LIST, N_ELEMENT_NUM, and N_ELEMENT_LIST. See also NUSDAS_GRID to get grid information from CNTL record.

RETURN VALUE

>= 0Succeeded. Value is number of array elements retrieved.
-1Error: size of value array insufficient.
-2Error: value array not allocated (???)
-3Error: invalid argument.
-10 to -99(see error code table)

see also Error Code of NuSDaS library for return code from -10 to -99.