next up previous 211
Next: Deprecated Routine ERR_OUT
Up: Subroutine Specifications
Previous: ERR_SYSER - Assign an operating system error message to a token


ERR_TUNE - Set an ERR tuning parameter

Description:
The value of the ERR tuning parameter is set appropriately, according to the value given. ERR_TUNE may be called multiple times for the same parameter.

The given value can be overridden by setting an environment variable, ERR_PARAM (where PARAM is the tuning parameter name in upper case), at run time.

The routine will attempt to execute regardless of the given value of STATUS. If the given value is not SAI__OK, then it is left unchanged, even if the routine fails to complete. If the STATUS is SAI__OK on entry and the routine fails to complete, STATUS will be set and an error report made.


Invocation:
CALL ERR_TUNE( PARAM, VALUE, STATUS )

Arguments:

PARAM = CHARACTER*(*) (Given)
The tuning parameter to be set (case insensitive).
VALUE = INTEGER (Given)
The desired value (see Notes).
STATUS = INTEGER (Given and Returned)
The global status.

Notes:
1. The following values of PARAM may be used:

2. The tuning parameters for MSG and ERR operate partially at the EMS level and may conflict in their requirements of EMS.

3. The use of SZOUT and STREAM may be affected by the message delivery system in use. For example there may be a limit on the the size of a line output by a Fortran WRITE and automatic line wrapping may occur. In particular, a NULL character will terminate a message delivered by the ADAM message system.

4. With REVEAL, messages are displayed at the time of the ANNUL. As REVEAL operates at the EMS level they are displayed with Fortran WRITE statements so, depending upon the delivery mechanism for normal messages, they may appear out of order.



next up previous 211
Next: Deprecated Routine ERR_OUT
Up: Subroutine Specifications
Previous: ERR_SYSER - Assign an operating system error message to a token

MERS (MSG and ERR) Message and Error Reporting Systems
Starlink User Note 104
P C T Rees
A J Chipperfield
22 October 2001
E-mail:ussc@star.rl.ac.uk

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