Printing Log Files

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:

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.