MSG_TUNE

Set an MSG tuning parameter

Description:

The value of the MSG tuning parameter is set appropriately, according to the value given. MSG_TUNE may be called multiple times for the same parameter.

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

Invocation

CALL MSG_TUNE( PARAM, VALUE, STATUS )

Arguments

PARAM = CHARACTER$\ast$($\ast$) (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:
• ’FILTER’ Specifies the required MSG conditional message reporting level. VALUE may be 1, 2 or 3, corresponding with quiet, normal (the default) and verbose levels respectively.
• ’SZOUT’ Specifies a maximum line length to be used in the line wrapping process. By default the message output by MSG is split into chunks of no more than the maximum line length, and each chunk is written on a new line. The split is made at word boundaries if possible. The default maximum line length is 79 characters.

If VALUE is set to 0, no wrapping will occur. If it is set greater than 0, it specifies the maximum output line length.

• ’STREAM’ Specifies whether or not MSG should treat its output unintelligently as a stream of characters. If VALUE is set to 0 (the default) all non-printing characters are replaced by blanks, and line wrapping occurs (subject to SZOUT). If VALUE is set to 1, no cleaning or line wrapping occurs.
• ’ENVIRONMENT’ This is not a true tuning parameter name but causes the environment variables associated with all the true tuning parameters to be used if set. If the environment variable is not set, the tuning parameter is not altered. The VALUE argument is not 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.