next up previous
Next: NDF_HCRE - Ensure that a history component exists for an NDF
Up: FORTRAN ROUTINE DESCRIPTIONS
Previous: NDF_GTWCS - Obtain world coordinate system information from an NDF

   
NDF_HAPPN - Declare a new application name for NDF history recording

Description:
The routine declares a new application name to be used as the default for subsequent recording of NDF history information. The name supplied will subsequently be used when creating new history records whenever a blank application name is passed to a routine which writes new history information. It will also be used as the application name when recording default history information.

If this routine is not called, then a system-supplied default name will be used in its place.

Invocation:
CALL NDF_HAPPN( APPN, STATUS )

Arguments:
APPN = CHARACTER * ( * ) (Given)
Name of the new application. If a blank value is supplied, then the name will revert to the system-supplied default.
STATUS = INTEGER (Given and Returned)
The global status.

Notes:
  • This routine should normally only be called to set up an application name in cases where better information is available than is provided by the default. For example, writers of environment-level software may be able to include a software version number in the name so that individual applications need not duplicate this in their own calls to NDF history routines.
  • The maximum number of application name characters which can be stored by this routine is given by the constant NDF__SZAPP. The name supplied will be truncated without error if more then this number of characters are supplied. The NDF__SZAPP constant is defined in the include file NDF_PAR.



next up previous
Next: NDF_HCRE - Ensure that a history component exists for an NDF
Up: FORTRAN ROUTINE DESCRIPTIONS
Previous: NDF_GTWCS - Obtain world coordinate system information from an 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