MODIFY-MSG-OUTPUT

Changes the DBH output

Scope of validity

DBH administration

See also

The DBH option MSG-OUTPUT on "MSG-OUTPUT"

Function

You use the MODIFY-MSG-OUTPUT statement to change the outputs of the SESAM/SQL DBH. You can change the output destination and mask out specific outputs.

You can completely suppress OPEN and CLOSE messages for logical files.

When using the linked-in DBH, it can be a good idea to request that DBH outputs only be written to SYSOUT so that outputs of the application program to SYSLST are not interspersed with DBH outputs.

Consistency checks and the end-of-program message are always output to the console and cannot be suppressed.

MODIFY-MSG-OUTPUT

MSG-OUTPUT = *STD / *MSG(...) / *OPEN-CLOSE-MSG(...) / *MAIL(...)
	*MSG(...)
		|	OUTPUT = *ALL / *SYSOUT / *SYSLST
	*OPEN-CLOSE-MSG(...)
		|	OUTPUT = *NONE / *ALL / *SYSOUT / *SYSLST
	*MAIL(...)
		|	OUTPUT = *NONE / *PARAMETERS(...)
		|		*PARAMETERS(...)
		|			|	COLLECT = *NO / *YES
		|			|	,IMMEDIATE = *NO / *YES

Operands

MSG-OUTPUT = *STD / *MSG(...) / *OPEN-CLOSE-MSG(...) / *MAIL(...)

Changes the DBH output.

MSG-OUTPUT = *STD
The DBH output, except for OPEN and CLOSE messages, is sent to SYSOUT or the console and SYSLST. OPEN and CLOSE messages are completely suppressed. This output corresponds to the default value of the DBH option MSG-OUTPUT. This corresponds to specifying *MSG(OUTPUT=*ALL) and *OPEN-CLOSE-
MSG(OUTPUT=*NONE).

MSG-OUTPUT = *MSG(OUTPUT = *ALL / *SYSOUT / *SYSLST)
Defines the output medium for the DBH - except for OPEN and CLOSE messages.

OUTPUT = *ALL
The DBH output is sent to SYSOUT or the console and SYSLST.

OUTPUT = *SYSOUT

The DBH output is sent to SYSOUT or the console.

OUTPUT = *SYSLST
The DBH output is only sent to SYSOUT.

MSG-OUTPUT = *OPEN-CLOSE-MSG(OUTPUT = *NONE / *ALL / *SYSOUT / *SYSLST)

The output of OPEN and CLOSE messages from SES1001, SES1011, SES1201, SES2015 and SES2023 can be suppressed within the framework defined by the MSG= parameter. OPEN and CLOSE messages for databases are not affected by this.

OUTPUT = *NONE
Suppresses OPEN and CLOSE messages completely.

OUTPUT = *ALL
The DBH outputs the OPEN and CLOSE messages as specified by the *MSG(...) parameter.

OUTPUT = *SYSOUT
The DBH outputs OPEN and CLOSE messages only to SYSOUT, provided the parameter *MSG(...) permits it.

OUTPUT = *SYSLST
The DBH outputs OPEN and CLOSE messages only to SYSLST, provided the parameter *MSG(...) permits it.

MSG-OUTPUT = *MAIL(OUTPUT = *NONE / *PARAMETERS)

Controls the output of information by email.

OUTPUT = *NONE
The information is not sent by email.

OUTPUT = *PARAMETERS(...)
Controls the volume of information which is sent by email.

COLLECT = *NO
Outputs to SYSLST are not sent by email.

COLLECT = *YES
All outputs to SYSLST are also stored in a temporary file. The temporary file is updated until an administration command MODIFY-MSG-OUTPUT is issued or to the end of the DBH session. Then the temporary file is sent by email to the address which is entered in the MAIL parameter file (see "Sending important information of the DBH session by email"). The MAIL parameter file must have been assigned with the link name SESMAIL when the DBH started.

“SYSLST(DBH)” is entered under “Subject:”.
The sender is the sender address entered in the MAIL parameter file under “SENDER=”. The temporary file is attached to the email.

IMMEDIATE = *NO
Messages are not sent by email.

IMMEDIATE = *YES
All messages with message numbers which are entered in the MAIL parameter file (see "Sending important information of the DBH session by email") are immediately sent by email to the address which is entered in the MAIL parameter file. The MAIL parameter file must have been assigned with the link name SESMAIL when the DBH started.

The message number is entered under “Subject:”. The sender is the sender address entered in the MAIL parameter file under “SENDER=”. The text of the email contains the message.

When running in the batch mode, the DBH output is sent to the console when *SYSOUT is specified.

Administration command in ISP format and at the CALL DML interface

The OPT,MSG-OUTPUT administration command corresponds to the MODIFY-MSG-OUTPUT administration statement here.

OPT,MSG-OUTPUT,output
output ::= {STD | M[SG]={ALL|SYSOUT|SYSLST} |
            O[PEN-CLOSE-MSG]={NONE|ALL|SYSOUT|SYSLST} |
            MAIL={NONE|COLLECT|IMMEDIATE|ALL}}

MAIL=ALL corresponds to COLLECT=*YES and IMMEDIATE=*YES in the operand description above.