CAT_CNEWA

Create a column, simultaneously setting all its attributes

Description:

Create a column, simultaneously setting all its attributes.

Note that the GENUS attribute is automatically set to CAT__GPHYS.

Invocation

CALL CAT_CNEWA (CI, FNAME, EXPR, DTYPE, CSIZE, DIMS, SIZEA, NULL, EXCEPT, SCALEF, ZEROP, ORDER, UNITS, EXTFMT, PRFDSP, COMM; FI; STATUS)

Arguments

CI = INTEGER (Given)
Catalogue identifier.
FNAME = CHARACTER∗(∗) (Given)
Name of the column (or field).
EXPR = CHARACTER∗(∗) (Given)
The expression defining a virtual column; blank for a physical column.
DTYPE = INTEGER (Given)
Type of the column.
CSIZE = INTEGER (Given)
Size of a CHARACTER column. If the column is not of type CHARACTER CSIZE is irrelevant; it is conventional to set it to zero.
DIMS = INTEGER (Given)
Dimensionality of the column. The permitted values are: CAT__SCALR - scalar, CAT__VECTR - vector.
SIZEA(1) = INTEGER (Given)
If the column is a vector this attribute should be set to the number of elements in the vector. For a scalar it should be set to one.
NULL = INTEGER (Given)
The way that null values are handled for the column. The permitted values are: CAT__NULLD - default, HDS null values used, CAT__NULLS - null values explictly specified for the column, CAT__LOCUM - null values not supported for the column and a locum value used instead.
EXCEPT = CHARACTER∗(∗) (Given)
In the cases where either the column supports explicitly specified null values, or nulls are not supported and a locum is used instead, EXCEPT contains the required value, written into a character string.
SCALEF = DOUBLE PRECISION (Given)
Scale factor for scaled columns. 1.0D0 for columns which are not scaled.
ZEROP = DOUBLE PRECISION (Given)
Zero point for scaled columns. 0.0D0 for columns which are not scaled.
ORDER = INTEGER (Given)
The order in which values occur in the column, coded as follows: CAT__ASCND - ascending, CAT__DSCND - descending, CAT__NOORD - none.
UNITS = CHARACTER∗(∗) (Given)
The units of the column.
EXTFMT = CHARACTER∗(∗) (Given)
The external format for the column.
PRFDSP = LOGICAL (Given)
The preferential display flag for the column: .TRUE. - display the column by default, .FALSE. - do not display the column by default.
COMM = CHARACTER∗(∗) (Given)
Comments about the column.
FI = INTEGER (Returned)
Identifier for the column.
STATUS = INTEGER (Given and Returned)
The global status.

Copyright

Copyright (C) 1999 Central Laboratory of the Research Councils

Bugs:

None known