Log Reading
The ADONIX X3 functions that are likely to run for a certain time, and in particular all those that are likely to function in batch mode, create a log file with a detailed account including any errors.
These log files are created in the sub-directory TRA of the folder directory. They have a name composed in the form F#.tra, where # is a sequential number assigned by a sequence number series [C]NUMIMP.
The first line of the log file is structured as follows:
| #<AdxVJ>@(#)%I%DD-MM-YY hh:mm:ss (user code) Explanatory comment |
The first part of the log (presented in bold) is a standard header; followed by the date and time, the code of the user who launched it, the function and then an explanatory function.
Following this in the log are the lines created by the executed function; these lines are prefixed by the characters > or <, followed by an error number, if the line makes reference to an error found in the function.
Prerequisites
Refer to documentation Implementation
Screen management
On entry into the function, the log file name is entered; a selection window is available to select existing files.
Entry screen
Presentation
The choice being made, the log file read screen opens. This screen is used to display up to 999 lines in the log file. If there are more than this in the file, radio buttons are no longer greyed out, the file being "cut" into logical « pages » containing up to 999 lines. It is then possible to use the radio buttons to move to the next page, or previous, or to go to the first or last page. The current page number and the total number of pages in the file are displayed in the title of the grid containing the lines.
Close
Fields
The following fields are present on this tab :
Grid
| Each of the lines in the grid corresponds to a line in the log file. |
Close
Menu Bar
This button is used to delete the log file from the directory where it was created. A confirmation is demanded. |
Menu Bar
Options / Page
This function is used to move directly to given page. This page number is entered in a window which opens.
Options / Search
This function is used to only display the error lines in the log screen. This display is preceded by the display, in an information box, of the total number of errors contained in the log file.
Options / Errors
When passed to the error log file solely by the preceding function, this function is used to return to the display of the complete log file.
Options / Detail
This function is used to copy the log file to another file, where the path is specified in an absolute fashion. This path is situated by default on the application server. But, by the server@path syntax, it is possible to register it on another server. The #@path syntax is used notably to register it on the client workstation, on the condition that the client workstation is of the Windows type (for Web workstations, the security constraints linked to the Web navigator prevent the operation of this function)
Options / Copy
This function is used to send the log file by e-mail to any group of users. The list of recipient users is entered, as well as the accompanying text (a default text is proposed). The e-mail address associated with a connected user is proposed by default.