Patterns for allocating Trace files
MainView for IP allows you to specify a name pattern for automatically allocating Trace files. When you use the WRITE, RAW, or SNIFF action on the Trace views to write Traces to files, MainView for IP generates the file name by using the name pattern specified on the MVIPCNFD view. The file names that the pattern generates must adhere to the naming conventions and limitations for IBM MVS data sets:
- The generated name cannot exceed 44 characters.
- Each qualifier cannot exceed 8 characters.
- The first character of any qualifier must be an alphanumeric character or or a special character such as $, #, or @.
The product rejects any pattern that would violate the naming conventions for MVS data sets by highlighting the field in red.
The product allows the following symbols only for the file names. As shown in the table, each symbol must begin with an ampersand (&) and end with a period (.).
Symbols | Description |
|---|---|
&USERID. | TSO user ID of the user who is invoking the Trace action on the Trace view |
&SYSNAME. | 4-character system name |
&TYPE. | Type of Trace file being written (WRITE, RAW, or SNIFF) |
&TT. | Type of data set (Data/OSA/SKT/PKT) |
&SEQN. | Sequence number that increments with every successful file allocation |
&YYMMDD. or &MMDDYY. | Date when the file is allocated |
&HHMMSS. | Time when the file is allocated |
Use the date, time or sequence symbols to ensure uniqueness. You can also use an existing Trace file. You can modify the file name on the Multi Platform Dialog (MPD) after the Trace action is invoked.
The default file name pattern is &USERID..MVIP.&SYSNAME..&TYPE..&TT..D&YYMMDD..T&HHMMSS.