Syntax
openloglog_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.
| Info |
|---|
|
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:
To open a log file with an absolute path, execute:
| Panel |
|---|
openlog "c:\document and settings\user\logs\mylog.txt" |
To open a log file with a relative path, execute:
| Panel |
|---|
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:
| Panel |
|---|
openlog mylog.txt append=yes |
