Next: DAT_CCOPY - Copy one structure level
Up: ROUTINE DESCRIPTIONS
Previous: DAT_ANNUL - Annul locator
- Description:
Map a primitive as a sequence of basic machine units (bytes) for
reading, writing or updating.
- Invocation:
CALL DAT_BASIC( LOC, MODE, PNTR, LEN, STATUS )
- Arguments:
-
LOC = CHARACTER * ( DAT__SZLOC ) (Given)
-
Primitive locator.
-
MODE = CHARACTER * ( DAT__SZMOD ) (Given)
-
Access mode ('READ', 'UPDATE' or 'WRITE').
-
PNTR = INTEGER (Returned)
-
Pointer to the mapped value.
-
LEN = INTEGER (Returned)
-
Total number of bytes mapped.
-
STATUS = INTEGER (Given and Returned)
-
The global status.
- Notes:
If the primitive data have been written on a different machine
which uses a different data representation, then they will be
mapped as written (i.e. they will not be converted to or from the
data representation used by the host machine).
Next: DAT_CCOPY - Copy one structure level
Up: ROUTINE DESCRIPTIONS
Previous: DAT_ANNUL - Annul locator
HDS Hierarchical Data System
Starlink User Note 92
R.F. Warren-Smith & M.D. Lawden
23rd February 1999
E-mail:rfws@star.rl.ac.uk
Copyright (C) 1999 Central Laboratory of the Research Councils