3.1.2 Configuration

A new option, -a, is added to servopts(5) for providing more various accounting information output fields:

-a FILENAME[[$FIELD]...]

If -a option is set, the Tuxedo server prints accounting information into the file specified by FILENAME.

The accounting file is generated daily with a file name in the format of [FILENAME].mmddyy.

The fields that can be specified for -a option are as follows:

  • DID: Indicates the Tuxedo Domain ID of the server process.
  • LMID: Indicates the LMID of the server process.
  • GRPID: Indicates the Tuxedo Group ID of the server process.
  • GRPNAME: Indicates the Tuxedo Group name of the server process.
  • SID: Indicates the Tuxedo Server ID of the server process.
  • PID: Indicates the process ID of the Tuxedo server process.
  • PNAME: Indicates the process name of the Tuxedo server process.
  • SVC: Indicates the name of the service being invoked. It always appears in the output fields when -a is specified.
  • GID: Indicates the Tuxedo user group invoking the service.
  • UID: Indicates the Tuxedo user ID invoking the service.
  • CLIENT: Indicates the Tuxedo client invoking the service.
  • STIME: Indicates the time entering the service routing. The output of this field is in the format of tv_sec/tv_usec, where two values are expressed as seconds and microseconds since 00:00 Coordinated Universal Time (UTC), January 1, 1970 respectively. It always appears in the output fields when -ais specified.
  • ETIME: Indicates the time leaving the service routing. The output of this field is in the format of “tv_sec/tv_usec”, where two values are expressed as seconds and microseconds since 00:00 Coordinated Universal Time (UTC), January 1, 1970 respectively. It always appears in the output fields when “-a” is specified.
  • TIME: Indicates the total CPU time (in microsecond) consumed by the service call.
  • SYSTIME: Indicates the System CPU time (in microsecond) consumed by the service call.
  • USRTIME: Indicates the User CPU time (in microsecond) consumed by the service call.
  • ERRNO: Indicates the ERRNO returned to the service invoker.
  • URCODE: Indicates the URCODE returned to the service invoker.
  • SIZE: Indicates the size of the request message (in byte).
  • WTIME: Indicates the waiting time of the request message in a queue (in microsecond).
  • ALL: Indicates all fields above.

    If no filed is specified for -a option, these fields are included in sequence by default: UID, SVC,STIME, ETIME, SYSTIME, USRTIME.

    If a duplicate field name is specified, it is ignored and a warning message is printed in ULOG: ERROR: duplicate field xxx for -a option.

    If an invalid field is specified, it is ignored and an error message is printed in ULOG ERROR: xxx is not a valid field for -a option.

    The fields separated by TAB character are listed in the first line of a new accounting file. Following is a sample:

    #UID SVC STIME ETIME SYSTIME USRTIME

    Subsequently a line is printed for every service call in the same sequence of the field names and values are separated by a TAB character as well. If a field value is not available, it will be left empty.

    Note:

    • A Log file cannot be re-created if it has been deleted when Tuxedo is running.
    • If multiple server instances output accounting information to the same file, the same fields in the same sequence must be specified for all relevant servers, otherwise accrpt cannot work.
    • The services in system server, such as BBL, GWTDOMAIN, TMS, etc. or the system services with the name starting with '.' cannot generate accounting records. The following Oracle Tuxedo Application Runtime for CICS servers are supported:
      • ARTATR1
      • ARTATRN
      • ARTCNX
      • ARTDPL
      • ARTSTR1
      • ARTTDQ
      • ARTTSQ
    • A multithread server (built with -t option) reports no TIME, SYSTIME or USRTIME.
    • A server with the NONE or APP_PW value of the SECURITY parameter in TUXCONFIG file reports no GID, UID or CLIENT.

Parent topic: Accounting Information Output