next up previous
Next: DAT_CCOPY - Copy one structure level
Up: ROUTINE DESCRIPTIONS
Previous: DAT_ANNUL - Annul locator

DAT_BASIC - Map primitive as basic units   

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 up previous
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