MSG-OUTPUT

Controls the output of the DBH

Definition

A lower-level DBH option of ADMINISTRATION

Function

You can use the DBH option MSG-OUTPUT to request SESAM/SQL DBH outputs to SYSOUT or the console of the BS2000 system administrator or to SYSLST. Specific output can be suppressed.
You can completely suppress OPEN and CLOSE messages for logical files. You can also enter specifications for transferring information by email.

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.

You can adjust the values of the operands during the DBH session by means of the MODIFY-MSG-OUTPUT administration statement (see "MODIFY-MSG-OUTPUT").

MSG-OUTPUT

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

Operands

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 default setting always applies during the initialization of the DBH or until completion of an external restart. DBH output cannot be redirected during this time. This corresponds to specifying MSG-OUTPUT=*PARAMETERS(MSG=*ALL,OPEN-CLOSE-MSG=*NONE).

MSG-OUTPUT = *ALL
The DBH output, except for OPEN and CLOSE messages, is sent to SYSOUT or the console and SYSLST.
This corresponds to specifying MSG-OUTPUT=*PARAMETERS(MSG=*ALL, OPEN-CLOSE-MSG=*ALL).

MSG-OUTPUT = *PARAMETERS(...)

MSG =
Controls the output of messages.

MSG = *ALL
The DBH output, except for OPEN and CLOSE messages, is sent to SYSOUT or the console and SYSLST.

MSG = list-poss(2): *SYSOUT / *SYSLST
The DBH output, except for OPEN and CLOSE messages, is sent to SYSOUT or the console or SYSLST. Output sent to an unspecified destination is suppressed.

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

OPEN-CLOSE-MSG = *NONE
This is the default. Suppresses OPEN and CLOSE messages completely.

OPEN-CLOSE-MSG = *ALL
The DBH outputs the OPEN and CLOSE messages as specified by the MSG= operand.

OPEN-CLOSE-MSG = list-poss(2): *SYSOUT / *SYSLST
The DBH outputs OPEN and CLOSE messages only to SYSOUT or SYSLST, provided the operand MSG= permits it.

MAIL =

Controls the output of information by email.

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

MAIL = *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.

Example

If OPEN and CLOSE messages are only to be output to *SYSLST, the DBH option could contain the following values:

MSG-OUTPUT=*PARAMETERS(MSG=*ALL,OPEN-CLOSE-MSG=*SYSLST)

Within the framework defined by MSG=*ALL, it is possible to restrict the output of OPEN and CLOSE messages to *SYSLST.

Output of OPEN and CLOSE messages to *SYSLST is not possible if the DBH option contains the following values:

MSG-OUTPUT=*PARAMETERS(MSG=*SYSOUT,OPEN-CLOSE-MSG=*SYSLST)

In this case, MSG=*SYSOUT defines a framework that does not permit output to SYSLST.