Filter by data set name

After the Usage Monitor has ascertained the name of the data set from which a used program is fetched, it is used to decide if the usage data is retained for collection or discarded. To perform this process, three lists of data set name masks are scanned; the first is the default data set name exclusion list, the second is the dynamic data setname inclusion list, and the third is the dynamic data set name exclusion list.

The default data set name exclusion list is built during Usage Monitor initialization, and consists of the SCEERUN library, the SCEERUN2 library, SYS1.CMDLIB (containing TSO commands) and SYS1.CSSLIB (containing callable services modules). The data set names of the SCEERUN and SCEERUN2 Language Environment libraries are determined by searching the link list for specific LE modules. You can use the XDD command to deactivate any of these default exclusion entries. You can use the XDS(*DFLT*) command to reactivate the default data set exclude list without affecting the status of masks in other lists.

The other two lists are constructed from commands you specify either in the HZAZIN file or dynamically via the system MODIFY command.

To avoid excessive storage and processor resource consumption, it is preferable to keep the number of elements in each list to a minimum. This is achieved by using generic masks to cover many data set names. The inclusion mask list is provided so that specific exceptions to broad exclusion rules can be specified. If you do not supply any data set name exclusion masks, the inclusion list does not affect data collection, but can still be used as a convenient way to collect relative usage statistics from the regular Usage Monitor status reports.

Data set name filtering occurs in the following sequence:

  1. Excludes usage if the data set name matches a default exclusion mask, otherwise proceeds to step 2.
  2. Includes usage if the data set name matches a mask supplied by anIDS command, otherwise proceeds to step 3.
  3. Excludes usage if the data set name matches a mask supplied by an XDS command, otherwise proceeds to step4.
  4. Includes usage if the data set name does not match any of the masks. Data set mask elements reside in key zero common storage. Each element occupies 56 bytes, and contains a data set name mask up to 44 bytes in length. You can use the percent sign as a wildcard to match a single character. You can use a trailing asterisk to match the rest of the data set name.
In order to add, reset, remove, or display the entries to the tables, use these commands:
XDS
To add a data set name mask to the exclusionlist.
IDS
To add a data set name mask to the inclusionlist.
XDD
To deactivate a data set name exclusion mask. IDD To deactivate a data set name inclusion mask.
D-D
To display all active data set namemasks.
Both of the non-default lists have no elements until an XDS or IDS command is processed. Storage is dynamically acquired for each element as required. To ensure system integrity, XDD and IDD commands do not cause the storage of a deactivated element to be freed, but mark the element as inactive. When a deactivated mask is reactivated, the existing entry is marked as active without the further acquisition of storage.

When the Usage Monitor address space first initializes, all elements of lists that remain in storage from a previous run are freed before the processing of initial commands and the commencement of data collection. There is no requirement to use either data set name mask list at any stage.