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