VM:Webgateway Release 3.0
Select where you want to go:

Accounting Record

Accounting records are records generated by VM:Webgateway accounting to account for files VM:Webgateway serves. VM:Webgateway produces an accounting record for each file it serves, and adds the record to the accounting punch file (named VMWEBSRV ACCOUNT).

The accounting records that VM:Webgateway generates have the format shown below.

Note: A DSECT for this accounting record is in the file VIWACTBK MACRO, which is included on the VM:Webgateway product tape. The installation procedure loads the VIWACTBK MACRO file to the VM:Webgateway system administrator minidisk (normally VMRMAINT 160).

Name Column Data Type Description
ACTSVMID 1 CL8 Userid of the VM:Webgateway service virtual machine
ACTOWNER 9 CL8 Userid that owns the data that was served (userid to charge)
ACTTOD 17 XL12 TOD clock (XL8 plus 4 pad bytes)

VM:Webgateway generates the record with a STCK value that uses 8 bytes. The field has 12 bytes to allow the post-processor to change the TOD value to a human readable format (mmddyyhhmmss).

ACTCLUID 29 CL8 Userid supplied by the web browser user, or blanks if the web browser user did not supply a userid
  Columns 37-48 identify the TCP connection.
ACTCLIP 37 XL4 IP address of the web browser
ACTCLPOR 41 XL2 TCP port of the web browser
ACTSVIP 43 XL4 IP address of the VM:Webgateway server
ACTSVPOR 47 XL2 TCP port of the VM:Webgateway server
ACTLOGCT 49 XL4 VIWLOG counter value

You can obtain more information about a transaction from the VM:Webgateway console log. Use the TOD clock value (columns 17-28) and the VIWLOG counter value to match VM:Webgateway console records to the accounting records.

  Columns 53-74 contain information about resource usage for the transaction.
ACTSVCPU 53 XL4 Virtual CPU time used by the VM:Webgateway service virtual machine

CPU time is expressed in milliseconds (units of 10**-3 seconds), which is 49.7 days in 32 bits. VM:Webgateway uses this format to reduce the possibility of overflow in the CPU field.

ACTSVIO 57 XL4 I/O used by the VM:Webgateway SVM
ACTWKCPU 61 XL4 Virtual CPU time used by a VM:Webgateway worker

CPU time is expressed in milliseconds (units of 10**-3 seconds), which is 49.7 days in 32 bits.

ACTWKIO 65 XL4 I/O used by a VM:Webgateway worker
ACTBYTES 69 XL4 Number of bytes served through TCP
ACTTRANS 73 XL2 Number of transactions this accounting record represents

This field is always X'0001' when VM:Webgateway generates the accounting record. If you use a post-processor to modify accounting records and the post-processor combines accounting records, you can update this field to indicate how many accounting records were combined.

ACTFLAGS 75 XL1 Flags
X'80' - Reserved for future use
X'40' - Reserved for future use
X'20' - Reserved for future use
X'10' - ACTWKOFF
VM:Webgateway sets this flag if the worker was logged off before VM:Webgateway finished collecting accounting data. When this flag is set, the values in ACTWKCPU and ACTWKIO are inaccurate.
X'08' - ACTDTFMT
If you modify the accounting records by converting the TOD to mmddyyhhmmss format, set this flag.
X'04' - ACTUFLIP
If you modify the accounting record by swapping the value of the userid that owns the data (columns 9-16) with the userid the web browser user supplied (columns 29-36), set this flag.
X'02' - ACTCLUTR
VM:Webgateway sets this flag when it truncates a non-VM userid supplied by the web browser user (columns 29-36).
X'01' - ACTVMDIR
VM:Webgateway sets this flag if it authenticated the userid the web browser user supplied. VM:Webgateway sets this flag only if it authenticated the userid using the VM directory to ensure the web browser user supplied a valid VM userid and password.
ACTPAD 76 XL1 Reserved for future use
ACTRECID 77 XL2 Data type code (VM:Webgateway sets this to AG)
ACTCPRT 79 XL2 Record type code (VM:Webgateway sets this to C0)
Top
Select where you want to go:
Copyright © 1998, Sterling Software, Inc.