openFT generates trace files for the configuration user ID of the openFT instance (default: $SYSFJAM).
Format of the trace files
The file names end with the suffix .FTTF and have the following format:
Smddhhmm.Sssccc.I000.FTTF'
Control task.Smddhhmm.Sssccc.Iiii.FTTF'
Server task for inbound and asynchronous outbound requests, i= 001,002, ...Ymddhhmm.Sssccc.Pnnnn.FTTF'
User task for synchronous outbound requests.
mddhhmm.Sssccc specifies the creation time of the trace file. Here, m indicates the month (1 = January, 2 = February, ... A= October, B=November, C = December), dd the day, hhmm the time in hours (hh) and minutes (mm), ssccc the time in seconds (ss) and milliseconds (ccc). nnnn is the TSN of a task for outbound requests.
The trace files contain openFT, FTAM, FTP and ADM requests that have been processed in the corresponding task.
Trace files in the event of errors
If a trace file cannot be written without errors due to a memory bottleneck, a DLOG record and a console message are output.
If a record of the trace file cannot be written as a result of an infringement of the maximum record length, the trace file is closed and the subsequent records are written to a new continuation file with the additional suffix.Liii, e.g.:
S8101010.S33222.I001.FTTF (first trace file)
S8101010.S33222.I001.L001.FTTF (continuation file)
START-FTTRACE
Traces are evaluated with START-FTTRACE:
START-FTTRACE |
INPUT = <filename 1..54> ,OUTPUT = <filename 1..54> / *SYSLST ,TRACE-OPTION = <c-string 1..50 with-lower-case> ,SHOW-FILE = *NO / *YES ,PRINT-FILE = *NO / *YES |
Operand description
INPUT = <filename 1..54>
Filename of the trace file to be evaluated $SYSFJAM.SYSFLF.Dyymmdd.Thhmmss.tsn.
OUTPUT = <filename 1..54>
Filename of the output file.
OUTPUT = *SYSLST
Output to SYSLST, e.g. during preprocessing. This also implicitly sets the SHOW-FILE operand to *NO.
TRACE-OPTION = <c-string 1..50 with-lower-case>
Specifies the options for the trace evaluation in the following format:.
[-d] [-sl=n | sl=l | sl=m | sl=h] [-cxid=<context-id>] [-f=hh:mm:ss] [-t=hh:mm:ss]
-d
Specifies that the trace files are to be output in hexadecimal format (dump format).
Data that is critical for security (transfer admissions, passwords etc.) is not “masked” in dump format. The specification of a security level or levels is irrelevant here.
-sl=n | -sl=l | -sl=m | -sl=h
Specifies the security level for the output:
n (no)
No security requirements, i.e. all the data is output. This includes IDs, passwords, transfer admissions, file names etc.
l (low)
Passwords are overwritten with XXX.
m (medium)
Passwords, user IDs, transfer admissions, account numbers and follow-up processing commands are overwritten with XXX. Default value.
h (high)
Passwords, user IDs, transfer admissions, account numbers, follow-up processing commands and file names are overwritten with XXX.
This parameter is not relevant in the case of dump format.
-cxid=<context id>
Selects the trace entries on the basis of the context ID. If you omit -cxid or specify -cxid= without a context ID then all the trace entries are output.
-f=hh:mm:ss (from)
Specifies the time as of which trace entries in the trace file are to be evaluated. You enter the time in the format hours:minutes:seconds (2 digits each). If you do not specify a start time then trace entries are output from the beginning of the file.
-t=hh:mm:ss (to)
Specifies the time up to which trace entries in the trace file are to be evaluated. You enter the time in the format hours:minutes:seconds (2 digits each). If you do not specify an end time then trace entries are output up to the end of the file.
SHOW-FILE =
Specifies if the evaluated trace file should be displayed with the command SHOW-FILE.
SHOW-FILE = *NO
The evaluated trace file is not displayed. Default value in batch mode.
SHOW-FILE = *YES
The evaluated trace file is displayed. Default value in dialog mode.
PRINT-FILE =
Specifies whether the evaluated trace file should be printed.
PRINT-FILE = *NO
The evaluated trace file is not printed.
PRINT-FILE = *YES
The evaluated trace file is printed.