Syntax
| Wiki Markup |
|---|
*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.
| 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
| HTML Table |
|---|
| cellspacing | 0 |
|---|
| style | text-align: left; width: 100%; |
|---|
| class | Table_with_Header |
|---|
|
| Table Row (tr) |
|---|
| Table Cell (td) |
|---|
| style | background-color: #F0F0F0; border-bottom-color: #E8E8E8; border-bottom-style: solid; border-bottom-width: 1px; border-left-color: #E8E8E8; border-left-style: solid; border-left-width: 1px; border-right-color: #E8E8E8; border-right-style: solid; border-right-width: 1px; border-top-color: #E8E8E8; border-top-style: solid; border-top-width: 1px; padding-bottom: 3pt; padding-left: 4pt; padding-right: 4pt; padding-top: 4pt; vertical-align: middle; width: 144pt; |
|---|
| | Parameter |
| Table Cell (td) |
|---|
| style | background-color: #F0F0F0; border-bottom-color: #E8E8E8; border-bottom-style: solid; border-bottom-width: 1px; border-left-color: #E8E8E8; border-left-style: solid; border-left-width: 1px; border-right-color: #E8E8E8; border-right-style: solid; border-right-width: 1px; border-top-color: #E8E8E8; border-top-style: solid; border-top-width: 1px; padding-bottom: 3pt; padding-left: 4pt; padding-right: 4pt; padding-top: 4pt; vertical-align: middle; width: 360pt; |
|---|
| | Description |
|
| Table Row (tr) |
|---|
| Table Cell (td) |
|---|
| style | border-bottom-color: #E8E8E8; border-bottom-style: solid; border-bottom-width: 1px; border-left-color: #E8E8E8; border-left-style: solid; border-left-width: 1px; border-right-color: #E8E8E8; border-right-style: solid; border-right-width: 1px; border-top-color: #E8E8E8; border-top-style: solid; border-top-width: 1px; padding-bottom: 3pt; padding-left: 4pt; padding-right: 4pt; padding-top: 4pt; vertical-align: top; |
|---|
| | log_file_path |
| Table Cell (td) |
|---|
| style | border-bottom-color: #E8E8E8; border-bottom-style: solid; border-bottom-width: 1px; border-left-color: #E8E8E8; border-left-style: solid; border-left-width: 1px; border-right-color: #E8E8E8; border-right-style: solid; border-right-width: 1px; border-top-color: #E8E8E8; border-top-style: solid; border-top-width: 1px; padding-bottom: 3pt; padding-left: 4pt; padding-right: 4pt; padding-top: 4pt; vertical-align: top; |
|---|
| | Pathname of the log file to open. |
|
| Table Row (tr) |
|---|
| Table Cell (td) |
|---|
| style | border-bottom-color: #E8E8E8; border-bottom-style: solid; border-bottom-width: 1px; border-left-color: #E8E8E8; border-left-style: solid; border-left-width: 1px; border-right-color: #E8E8E8; border-right-style: solid; border-right-width: 1px; border-top-color: #E8E8E8; border-top-style: solid; border-top-width: 1px; padding-bottom: 3pt; padding-left: 4pt; padding-right: 4pt; padding-top: 4pt; vertical-align: top; |
|---|
| | append=yes | no |
| Table Cell (td) |
|---|
| style | border-bottom-color: #E8E8E8; border-bottom-style: solid; border-bottom-width: 1px; border-left-color: #E8E8E8; border-left-style: solid; border-left-width: 1px; border-right-color: #E8E8E8; border-right-style: solid; border-right-width: 1px; border-top-color: #E8E8E8; border-top-style: solid; border-top-width: 1px; padding-bottom: 3pt; padding-left: 4pt; padding-right: 4pt; padding-top: 4pt; vertical-align: top; |
|---|
| | 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:
To open a log file with a relative path, execute:
To open a log file so that new entries are appended to the end of the existing data in the file, execute: