For ROBAR-CL-DCAM (BS2000), logging to trace files is activated when the program SYSPRG.ROBAR-CL.<ver>.DCAM is called. The program is called with the start procedure SYSPRC.ROBAR-CL.<ver>. Specifying the parameter TRACE-NBR=<n> defines the number of trace entries. <n> defines the number of records written to the trace file; the value 0 (default value) means that no trace files are generated). No trace files are generated if the parameter is not specified.
The file attributes of primary and secondary file assignments can be defined via the parameters PRIMARY=PP und SECONDARY=PP. By default PRIMARY=60 and SECONDARY=30. Both values must be matched to the number of records that are to be written to a trace file (TRACE-NBR=<n> parameter).
The trace files are created by default under the current user ID. The parameter TRACE in the start file allows you to create the files for a specific user ID (e.g. $TRA) and with a specific prefix (e.g. ROBTRACE instead of ROBAR)(TRACE=$TRA.ROBTRACE). The trace file is generated by default under the following name:
$TSOS.ROBAR.TRACE.<DCAM-name>.<tsn>.<day>-<hour><minute>[.<seq_no>]
Once the defined number of written records is reached, the file is swapped automatically. If the file is swapped in the same minute as the previous trace file was generated, a catalog entry for a file whose name element <seq_no> is increased by 1 is generated (this should be a rare occurrence if a sufficiently large value was selected for the TRACE-NBR parameter).
The ROBAR-CL start procedure deletes trace files which were created more than 7 days ago.