next up previous
Next: NDF_TYPE - Obtain the numeric type of an NDF array component
Up: FORTRAN ROUTINE DESCRIPTIONS
Previous: NDF_TEMP - Obtain a placeholder for a temporary NDF

NDF_TUNE - Set an NDF_ system tuning parameter   

Description:
The routine sets a new value for an NDF_ system internal tuning parameter.

Invocation:
CALL NDF_TUNE( VALUE, TPAR, STATUS )

Arguments:
VALUE = INTEGER (Given)
New value for the tuning parameter.
TPAR = CHARACTER * ( * ) (Given)
Name of the parameter to be set (case insensitive). This name may be abbreviated, to no less than 3 characters.
STATUS = INTEGER (Given and Returned)
The global status.

Notes:
The following tuning parameters are currently available:
  • 'DOCVT': Controls whether to convert foreign format data files to and from native NDF format for access (using the facilities described in SSN/20). If DOCVT is set to 1 (the default), and the other necessary steps described in SSN/20 have been taken, then such conversions will be performed whenever they are necessary to gain access to data stored in a foreign format. If DOCVT is set to 0, no such conversions will be attempted and all data will be accessed in native NDF format only.

    The value of DOCVT may be changed at any time. It is the value current when a dataset is acquired by the NDF_ library (or a placeholder for a new dataset is created) which is significant.

  • 'KEEP': Controls whether to retain a native format NDF copy of any foreign format data files which are accessed by the NDF_ library (and automatically converted using the facilities described in SSN/20). If KEEP is set to 0 (the default), then the results of converting foreign format data files will be stored in scratch filespace and deleted when no longer required. If KEEP is set to 1, the results of the conversion will instead be stored in permanent NDF data files in the default directory (such files will have the same name as the foreign file from which they are derived and a file type of '.sdf'). Setting KEEP to 1 may be useful if the same datasets are to be re-used, as it avoids having to convert them on each occasion.

    The value of KEEP may be changed at any time. It is the value current when a foreign format file is first accessed by the NDF_ library which is significant.

  • 'SHCVT': Controls whether diagnostic information is displayed to show the actions being taken to convert to and from foreign data formats (using the facilities described in SSN/20). If SHCVT is set to 1, then this information is displayed to assist in debugging external format conversion software whenever a foreign format file is accessed. If SHCVT is set to 0 (the default), this information does not appear and format conversion proceeds silently unless an error occurs.
  • 'TRACE': Controls the reporting of additional error messages which may occasionally be useful for diagnosing internal problems within the NDF_ library. If TRACE is set to 1, then any error occurring within the NDF_ system will be accompanied by error messages indicating which internal routines have exited prematurely as a result. If TRACE is set to 0 (the default), this internal diagnostic information will not appear and only standard error messages will be produced.
  • 'WARN': Controls the issuing of warning messages when certain non-fatal errors in the structure of NDF data objects are detected. If WARN is set to 1 (the default), then a warning message is issued. If WARN is set to 0, then no message is issued. In both cases normal execution continues and no STATUS value is set.



next up previous
Next: NDF_TYPE - Obtain the numeric type of an NDF array component
Up: FORTRAN ROUTINE DESCRIPTIONS
Previous: NDF_TEMP - Obtain a placeholder for a temporary NDF


Starlink User Note 33
R.F. Warren-Smith
11th January 2000
E-mail:rfws@star.rl.ac.uk

Copyright © 2000 Council for the Central Laboratory of the Research Councils