CLOSE-LOG( ) method

Closes the current log file, which stops an interactive or batch client from writing messages to the log file.

The CLOSE-LOG( ) method writes a message to the log file indicating that the client intentionally closed the log file, so that the user knows why there are no more messages in the log file.

Return type: LOGICAL

Applies to: LOG-MANAGER system handle

Syntax

CLOSE-LOG( )

If the CLOSE-LOG( ) method successfully closes the open log file, it returns TRUE.

If the CLOSE-LOG( ) method fails, it returns FALSE and displays a warning message indicating the reason for the failure.

If there is no client log file, the CLOSE-LOG( ) method returns TRUE and does not display a warning message.

Note: This method is valid only for interactive and batch clients. WebSpeed agents and AppServer servers write a message to the server log file indicating that it is invalid to use the CLOSE-LOG( ) method to close a WebSpeed or AppServer server log file. In this case, the method returns FALSE. Unlike the other LOG-MANAGER methods, you cannot use this method with the DSLOG-MANAGER system handle.