next up previous 225
Next: CAT_PNEW0 - Create a scalar part (column or parameter)
Up: Detailed subroutine specifications
Previous: CAT_INEW - Create an index on a column


CAT_PINQ - Inquire the values of all the attributes for a parameter

Description:
Inquire the values of all the attributes for a parameter. If the parameter is an array, the value of the first element is returned.
Invocation:
CALL CAT_PINQ (QI, SZDIM; CI, QNAME, DTYPE, CSIZE, DIMS, SIZEA, UNITS, EXTFMT, PRFDSP, COMM, VALUE, DATE; STATUS)
Arguments:
QI = INTEGER (Given)
Parameter identifier.
SZDIM = INTEGER (Given)
Maximum permitted dimensionality for a column (defines the size of array SIZEA).
CI = INTEGER (Returned)
Catalogue identifier.
QNAME = CHARACTER$*$($*$) (Returned)
Name of the parameter.
DTYPE = INTEGER (Returned)
Type of the parameter. The permitted types are identical to HDS types.
CSIZE = INTEGER (Given)
Size of a character parameter (set to zero if the column is note of data type character).
DIMS = INTEGER (Returned)
Dimensionality of the parameter. For a scalar DIMS = 0.
SIZEA(SZDIM) = INTEGER (Returned)
The size of the array in each of its dimensions. The exception is a scalar parameter, when SIZEA becomes a single-element, one-dimensional array, set to 0.
UNITS = CHARACTER$*$($*$) (Returned)
The units of the parameter.
EXTFMT = CHARACTER$*$($*$) (Returned)
The external format for the parameter.
PRFDSP = LOGICAL (Returned)
The preferential display flag for the parameter: .TRUE. - display the parameter by default, .FALSE. - do not display the parameter by default.
COMM = CHARACTER$*$($*$) (Returned)
Comments about the parameter.
VALUE = CHARACTER$*$($*$) (Returned)
The value of the parameter. If the parameter is an array the first element is returned.
DATE = DOUBLE PRECISION (Returned)
Modification date of the parameter.
STATUS = INTEGER (Given and Returned)
The global status.
Copyright
Copyright (C) 1999 Central Laboratory of the Research Councils
Bugs:
None known


next up previous 225
Next: CAT_PNEW0 - Create a scalar part (column or parameter)
Up: Detailed subroutine specifications
Previous: CAT_INEW - Create an index on a column

CAT [1ex
Starlink User Note 181
A.C. Davenhall
4th April 2001
E-mail:ussc@star.rl.ac.uk

Copyright © 2001 Council for the Central Laboratory of the Research Councils