Log file types

This section describes each type of log file.

In local mode, and some remote mode logs (as specified in the log description), the file name is in the form:

nzae-IDENTIFIER-<transaction ID>-<parent process ID>-<child process ID>-<session
ID>.<type>

In the remaining remote mode logs, the file name is in the form:

nzae-IDENTIFIER-<transaction ID>-<parent process ID>-<child process ID>-remote-
<pointer to the AE>-<session ID>.<type>

Local Mode: Child Log

The file name for a child log in local mode is in the form, for example:
nzae-IDENTIFIER-0-11510-11512-17070.txt
The contents of this file include:
  • A listing of the environment variable active when the child is created.
  • Information about the process, including process ID, thread ID, binary, shared libraries and command line. For example:
    process id=16442, thread id=16442
    /u01/home/nz/workspaces/dev-ae/main/src/ae/build/cpp_ae/host/testmax \
          75682 Mon Apr 26 11:19:04 2010
    /u01/home/nz/workspaces/usr-bdrosen-
    tfunc/main/simdata/base/200103/library/209623/host/libnzaecpp3.so 1619222 \
          Mon Apr 26 11:17:02 2010
    /u01/home/nz/workspaces/usr-bdrosen-
    tfunc/main/simdata/base/200103/library/200652/host/libnzaechild.so 501191 \
          Mon Apr 26 11:17:02 2010
    /lib/libpthread.so.0                         125612 Mon Jan 5 19:53:27 2009
    /usr/lib/libstdc++.so.6                     936908 Thu Sep 18 14:06:28 2008
    /lib/libm.so.6                               208352 Mon Jan 5 19:53:27 2009
    /lib/libgcc_s.so.1                           46476 Thu Sep 18 14:06:28 2008
    /lib/libc.so.6                              1606808 Mon Jan 5 19:53:26 2009
    /lib/ld-linux.so.2                           125736 Mon Jan 5 19:53:26 2009
    --- Process Command Line
    /u01/home/nz/workspaces/dev
    ae/main/src/ae/languages/cpp/../../build/cpp_ae//host/testmax parm1
    --- End of Command Line
  • A log of startup of the AE from the child’s point of view. For example:
    ==INFO AE initialization requested
    ==INFO AE Build = 5
    ==INFO --- Shared Library Info ---
    Number of shared libraries = 4
    LIBNZAEADAPTERS  libnzaeadapters.so         3439259 Mon Apr 26 11:17:02 2010
    LIBNZAECHILD     libnzaechild.so            501191 Mon Apr 26 11:17:02 2010
    LIBNZAECPP2      libnzaecpp3.so             1619222 Mon Apr 26 11:17:02 2010
    LIBNZAEPARENT    libnzaeparent.so           920241 Mon Apr 26 11:17:01 2010
    ==INFO child _nzaerepchild version: 7
    ==INFO child in nzrep pass thru mode
  • A log of the various AE messages sent between the parent and the child. For example:
    before nzrepSend #2 NZREP_REQUEST (6) length=0 nzaemessage.c:13
    after nzrepSend #2 nzaemessage.c:18
    before nzrepReceive #1 nzaemessage.c:20
    after nzrepReceive #1 NZREP_DATA (1) length=80 nzaemessage.c:25
    

Local Mode: Parent Log

The file name for a parent log in local mode is in the form, for example:
nzae-IDENTIFIER-0-11510-11512-17070.txt_parent.txt

This file contains a log of the various AE messages sent between the parent and the child. Output is basically the same as from the child log, but may have slight differences.

Local Mode: Child Stderr

The file name for a child standard error log is in the form, for example:

nzae-IDENTIFIER-0-13894-13975-16934.txt_stderr.txt

This contains the standard error output from the child.

Local Mode: Child Stdout

The file name for a child standard output log is in the form, for example:

nzae-IDENTIFIER-0-13894-13975-16934.txt_stdout.txt

This file contains the standard output from the child.

Remote Mode: Child Request Log

The file name for a remote mode child request log is in the form, for example:

nzae-IDENTIFIER-0-942-0-remote-179982496-16184.txt

Because this is remote AE mode, the child process ID is always 0. Because the child process ID cannot be used to distinguish between multiple AEs in the same parent process, you must use the pointer to make it unique.

The contents of this file are similar to the local mode child log, except it is missing the process information.

Remote Mode: Parent Request Log

The file name is in the form:
nzae-IDENTIFIER-0-942-0-remote-179982496-16184.txt_parent.txt

Because this is remote AE mode, the child process ID is always 0 and because you can’t use the child process id to distinguish between multiple AEs in the same parent process; you must use the pointer to make it unique.

The contents of this file are similar to or the same as the local mode parent log.

Remote Launch Mode: Parent Log

The file name is in the form described in the local mode file format, with the addition of the launch keyword:

nzae-IDENTIFIER-6060-943-949-launch-16184.txt_parent.txt

The contents of this file contain a few launch AE messages sent between the parent and this child.

Remote Launch Mode: Transient Child Log

The file name is in the form described in the local mode file format, with the addition of the launch keyword:

nzae-IDENTIFIER-6060-943-949-launch-noexecae-16184.txt_parent.txt

The contents of this file contain a few AE messages sent between the parent and the transient child. The transient child is created for a brief time. It is between the first fork and the second fork when launching a remote AE. Two forks are used to disassociate the remote AE from the parent process that launched it and put it into a different process group.

Remote Launch Mode: Child Log

The file name is in the form described in the local mode file format, with the addition of the launch keyword:

nzae-IDENTIFIER-6060-943-952-launch-16184.txt

The contents of this file contain the environment and library information.

Remote Launch Mode: Child Stderr

The file name is in the form described in the local mode file format, with the addition of the launch keyword:

nzae-IDENTIFIER-6060-943-952-launch-16184.txt_stderr.txt

The contents of this file contain the standard error output from the remote AE throughout its lifetime.

Remote Launch Mode: Child Stdout

The file name is in the form described in the local mode file format, with the addition of the launch keyword:

nzae-IDENTIFIER-6060-943-952-launch-16184.txt_stdout.txt

The contents of this file contain the standard output from the remote AE throughout its lifetime.