[ MODNAME = [d:][path]Name ]
[ MAJOR = nnnnn ]
[ MAXDATALENGTH = nnnn ]
[ TDFID = nn ]
where:
MODNAME=[d:][path]Name
d:
is the drive containing the module. If not specified the current drive is used.
is the path to the module. If not specified the current path is used.
is the name of the executable module to be traced. If an extension is not specified and the Name is not OS2KRNL, an extension of DLL is appended to Name.
Path information may be specified but is normally discarded before storing module name information in the TDF unless the /P switch is specified on the command line. TRCUST uses the path information to locate and read the load module while processing the TSF. If either the name or path differs from the module's installed name or path then the /L= command line option may be use to direct TRCUST on while module file name to read.
defines the major trace ID allocated to this module. It may be in the range 1 to 65535 decimal or specified 0x1 to 0xffff hex. The default value is 1. The major trace ID is part of the data placed in the trace buffer when a tracepoint is executed.
Only one major code is permitted per module.
Notes:
Prior to fix pack 35 for OS/2 Warp V3.0 and for OS/2 Warp V4.0 only major codes 0x1 - 0xff may be used. After fix pack 35 for OS/2 Warp V3.0 the major code range of 0x1 - 0xffff permissible. TRCUST version 2.2 or later is required if the extended range of major codes is to be used.
Also note that the default major code (1) is reserved by OS2 for dekko tracepoints. Ranges available to the user are: 245-255 and 0x8000-0xffff.
Major code 0 is permissible but only with the /RAS switch specified on the command line. However this is reserved for specific use by system use and should not noramlly be used.
defines the maximum amount of data that a single tracepoint call will insert into the trace buffer.
The length may be in the range 20 to 4099 decimal or specified 0x14 to 0x1003 hex. The default value is 512.
Note:
Prior to fix pack 35 for OS/2 Warp V3.0 and fix pack 10 for OS/2 Warp V4.0 MAXDATALENTH defaults to 128 and may only specify a value in the range of 20 to 512.
defines an identifer in the range 0 to 65565 for use with the GETVARS and QUERY functions of the DTRACE command. The default TDFID is 0 and is normally allowed to default.