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.