Description:
The routine returns
a CAT identifier for an existing catalogue. The name of the catalogue is held at a given index within a
given group. It is equivalent to
CAT_ASSOC.
Invocation
CALL CTG_CATAS( IGRP, INDEX,
MODE, CI, STATUS )
Arguments
IGRP = INTEGER (Given)
A GRP identifier for a
group holding the names of catalogues. This will often be created using
CTG_ASSOC, but
groups created
by hand using GRP directly (
i.e. without the supplemental groups created by
CTG_ASSOC) can also be used.
INDEX = INTEGER (Given)
The index within the group
at which the name of the catalogue to be accessed is stored.
MODE = CHARACTER
(
)
(Given)
Type of catalogue access required: ’READ’
, or ’WRITE’
.
CI = INTEGER (Returned)
catalogue identifier.
STATUS = INTEGER (Given and Returned)
The global status.
Notes:
-
If this routine is called with STATUS set, then a value of CAT__NOID will be returned for the CI
argument, although no further processing will occur. The same value will also be returned if the
routine should fail for any reason. The CAT__NOID constant is defined in the include file CAT_PAR
.
Copyright © 2009 Science and Technology Facilities Council.