To run the Diagnostic Log utility, perform one of the following:
Sign on to CANDE under the required usercode. Enter:
RUN $NGEN28/DLOG [ON pack]; FILE LINCLOG (TITLE = [(usercode)]system/LINCLOG/nnn [ON log-pack]) [;VALUE = rrrrrr] [;SW1] [;FILE LOGLIB (FAMILYNAME = lib-pack)]
Alternatively, from MARC, enter:
RUN NGEN28/DLOG [ON pack]; FILE LINCLOG (TITLE = [(usercode)]system/LINCLOG/nnn [ON log-pack]) [;VALUE = rrrrrr] [;SW1] [;FILE LOGLIB (FAMILYNAME = lib-pack)]
From the ODT, enter:
USER= dlog-usercode/password;
Then enter the same command format as shown for MARC.
The parameters used in these instructions are detailed in the following table.
| Parameter | Description |
|---|---|
| pack | Pack on which the NGEN28/DLOG program resides. Omit ON pack if it is on a family pack for that usercode. |
| log-pack | Pack on which the log file resides. Omit ON log-pack if it is on a family pack for that usercode. |
| usercode | Usercode of the log file, if different to the usercode you are running under. Refer to Note 2. |
| system | Name of your application. |
| nnn | Log file number (01 through 998). |
| rrrrrr | Optional entry of the starting position within the log file. If you omit VALUE = rrrrrr, the entire log is printed, which might require considerable processing. By default, if an rrrrrr value is entered, the DLOG run starts where specified and complete at the end of the LINCLOG file. For all possible rrrrrr values, refer to the following table of starting point values. Also, refer to Note 1. If an end point is to be specified, enter SW1. This causes the DLOG program to take input from an accept prompt (Accept logic command). |
SW1 | Optional entry of the starting and ending positions within the log file. If you omit SW1 and VALUE = rrrrrr, the entire log is printed, which might require considerable processing. If you omit SW1, the end point defaults to the end of file. Including VALUE = rrrrrr enables you to define a start position. Including SW1 enables you to define both start and end positions. If you enter SW1, the DLOG program takes input of start and end positions through an Accept prompt. Also, refer to Note 1. |
lib-pack | Pack on which the LOGLIBRARY resides. Omit this file specification if it is on a family pack for that usercode. Refer to LOGLIBRARY File and Note 2. |
Notes:
If the Run command included SW1, then your parameters are to be given through an Accept prompt. Reply to the Accept prompt with:
AX start/end
Refer to Starting Point Parameter and Accept Parameter Syntax for more information.
The Diagnostic Log program attempts to find the LOGLIBRARY under the usercode of the log file and on the pack family given as the lib-pack parameter. If the program is running against a built application and cannot find the appropriate LOGLIBRARY, it looks under the same usercode and packs for the Generate LOGLIBRARY, which can also be used.
Refer to LOGLIBRARY File for more information.
To specify a different pack family for the LINCLOG file location, you can file equate the FAMILYNAME of the LINCLOG file. For example, the syntax for running the LOG utility:
RUN $NGEN28/LOG on (<options>);FILE LINCLOG(FAMILYNAME=<linclog pack>)Starting Point Parameter
Values that you can specify for the starting point parameter are listed in the following table.
If You Want To… | Then… |
|---|---|
Start from a physical log record number | Enter the record number, a value in the range 1 through 999999 |
Start from a particular pivot number | Enter the pivot number, in the format nnn rrrrrr l
|
Indicate that you wish to enter start/end values through an Accept prompt | Include SW1 to enable entry of start and stop points, and selection by station. Refer to Accept Parameter Syntax for more information. |
Start from the beginning of the Log file | Do not enter any value. Do not include SW1. |
Accept Parameter Syntax
If you wish to analyze a defined range of log file records, you might specify a ten-digit start or stop pivot number, or both. You must include any leading zeros, and the first three digits must correspond to the log file number. For example, Log 1, physical record 297, and logical record 3 is represented as 0010002973. Refer to Activity Log for more information on pivot number.
This is summarized as follows:
[ START pivot1 ] [ STOP pivot2 ] [ STATION station ]
| Parameter | Description |
|---|---|
| Start pivot1 | The beginning of the log file analysis. If omitted, the analysis starts at the beginning of the log file. |
| STOP pivot2 | The end pivot for the log file analysis. If omitted, the analysis terminates at the end of the log file. |
| STATION station | Selects log information for the specified station only. STN is a valid abbreviation of STATION. |
Alternatively, enter End if you wish to terminate the NGEN28/DLOG program without analyzing any of the log file. This is summarized as follows:
END
Note: If you specify the current log file 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.