openlog - UDM Command

Syntax

openlog log_file_path[append=yes|no]

Description

The openlog command opens a log file on disk for writing custom log information.


IBM i

The log file must be a LIB file system file; openlog does not support the HFS file system.

Windows

The log file is open shared so that other processes can read it from while it is still open by UDM.

z/OS

The log file must be allocated as part of the job. The log file name takes the format of dd:ddname.


Only one log file can be open at any one time in UDM. If the user issues an openlog command while a log file is open, the user receives an error. The user can explicitly close the open log file by issuing a closelog command; otherwise the log file will be closed automatically when the manager ends.


UNIX, Windows

An optional append parameter indicates whether or not an existing log file should be appended to.

  • If append is set to YES and the log file exists, any log statements written are appended to the end of that file.
  • If append is set to NO and the log file exists, the file is truncated to zero length as part of the open operation.
  • If append is set to either YES or NO, and the log file does not exist, it will be created.
  • If append is not included in an issued openlog command, the log file is opened as if append were set to NO.

Parameters

Parameter

Description

log_file_path

Pathname of the log file to open.

append=yes | no

Specification for whether or not to append log statements to an existing log file.

Examples

To open a log file under z/OS, execute:

openlog dd:mylog


To open a log file with an absolute path, execute:

openlog "c:\document and settings\user\logs\mylog.txt"


To open a log file with a relative path, execute:

openlog logs/mylog.txt


To open a log file so that new entries are appended to the end of the existing data in the file, execute:

openlog mylog.txt append=yes