TRANSFER Installation and Management Guide

Creating the Traffic Log
Managing a TRANSFER System
068837, Update 1 to 013198 Tandem Computers Incorporated 11–17
Creating the Traffic Log. The name of the file to be used as the network traffic log is
communicated to the TWORK and TRECV processes through an ASSIGN. The file
must be created before the processes start up.
If the ASSIGN is not specified, logging does not occur. If the ASSIGN is specified and
the file does not exist or if there is some other problem opening the file, no logging
occurs. If a file error occurs when writing to the file, it is logged to the server’s OUT
file.
Only one file needs to be created for all TWORKs or TRECVs on a particular node.
The file is opened in a shared mode so that all can write to the file at the same time.
The file record structure is as follows:
Def TRAFFIC-LOG.
02 RECORD-KEY.
04 START-TIME type binary 64.
04 NODE-NAME PIC X(8).
04 DIRECTION PIC X.
04 TYPE-OF-WORK PIC X.
04 PROCESS-NAME PIC X(8).
02 ITEM-ID PIC X(12).
02 ITEM-CREATOR PIC X(120).
02 SUBJECT PIC X(70).
02 RECIP-LIST PIC X(70).
02 NUMBER-OF-BYTES type binary 32 unsigned.
02 NUMBER-OF-IPCS type binary 16 unsigned.
02 SUCCESS PIC X.
02 FILLER PIC X.
02 END-TIME type binary 64.
end.
Record TRAFFIC-LOG-REC.
file is "TRAFLOG" key-sequenced.
def is TRAFFIC-LOG.
key is RECORD-KEY.
end.
The Tandem supplied GDDL file contains the file definition for this file.
After you have specified the ASSIGN, use the following FUP commands to create the
network logging file:
SET TYPE K
SET REC 314
SET KEYLEN 26
Set the extent sizes according to the needs of your site.
If there is a problem opening the file, the servers report the following message on
startup and continue with the traffic log disabled:
Error nnn opening the traffic log file yyyyy .
where nnn is the file error number and yyyyy is the file name.