Introduction to the Log Printing Utility
You can print a Log file using the Log Printing Utility to examine the information sent or received by an application. You can print either the entire log or select specific parts of the log; for example, log number, date, Ispec, station, errors, Maint property value, and so on.
Secure properties are shown as a sequence of pound (#) symbols to preserve the confidentiality of such items (for example, passwords).
Note: If you specify the log file currently in use, your output will not include the most recent entries that remain in the buffer. To ensure that all entries are included, use the :REL LOG Administration command (or take your application down) to close the log file at the required point.
Initiating a Print Log Request
You can initiate a print log request by initiating the LINC/LOG program in one of the following ways:
Using a parameter screen
Building a parameter string
When the NGEN28/LOG program initiates, it calls the Log Library for all accesses to the Log file. When the Log Library initializes, the following message is displayed:
LOG STARTING FROM nnn rrrrrr l
This identifies the pivot number from which the log printing commences. Refer to Pivot Numbers for more information about the structure of the pivot number.
Files Used When Printing the Log
The Log Printing program accesses the files listed in the following table.
File | Description |
---|---|
system/LINCCNTL | Determined from the pack and usercode defined on the input screen if run with screen input, or from the pack and usercode entered options; normally on the Dictionary pack. |
system/LINCGLI | Defines the items found in the LINCLOG; must be on the same pack and under the same usercode as LINCCNTL. |
system/LINCLOG/nnn | Contains the log information, found by obtaining the LOG pack from the LINCCNTL file. |
<system>/LINCSUPPORT | Contains procedures used by the process to print the LOG. |
system/1/LOGLIBRARY | The library codefile called to perform the actual accessing of the LINCLOG file. |
NGEN28/UTILITY/ LINCFORM | Only used if it is found and if the Log printing program is run in screen input mode; contains optional translations for the LOG program displays. |
NGEN28/MLSLIBRARY | Contains messages and errors. |