SMF_DSN_MASK_n

SMF_DSN_MASK_n provides a data set mask used to query the z/OS® catalog for sequential format data sets containing SMF data offloaded from the SMF log-files (MANX|MANY) using the IFASMFDP program.

Required
Yes, at least one instance of this keyword is required.
Default
No default
Permitted Values
1 - 10 file names
Description
You must specify at least one instance of this keyword (SMF_DSN_MASK_1). Specify the number of sequential files. The sequential files can be the original files created when offloading the MANX|MANY files, or a copy of these sequential files created by customizing and running AUISMFDF and AUISMFDP jobs located in the product sample data set. In most environments, only one SMF_DSN_MASK are specified, but up to 10 are allowed.
You have the option to use a wildcard character to query data..
Table 1. Masking character rules
Character Rule
% Indicates that only one alphanumeric or national character can occupy that position.
%%% Indicates that more than one character can be substituted, with the number of substitution characters being equal to the number of percent signs specified.
Example 1: specifying a GDG data set in the mask: If you have customized the AUISMFDP job to produce a GDG data set as the SORTOUT DD output data sets, you can choose to specify the fully qualified GDG base name in the mask for system name field. For example, A.B.C. IBM® Security Guardium® S-TAP® for IMS uses catalog services to determine the names of all cataloged GDG entries under this name, for example:
  • A.B.C.G%%%%V%%
Example 2: specifying a data set name explicitly: Provide the generation and version values as a mask. For example, A.B.C.G%%%%V%%. IBM Security Guardium S-TAP for IMS uses catalog services to determine the names of all cataloged data sets that match this mask, for example:
  • A.B.C.G0021V00
  • A.B.C.G0022V00
  • A.B.C.G0023V00
Example 3: specifying a DSN using a DATE/TIME naming convention: If you have customized the AUISMFDP job to produce a data set name that contains date and time values as qualifiers within the data set name as the SORTOUT DD output data sets, you can specify the data set name using a string of percent signs within the date and time qualifier names. For example: HLQ.D%%%%%%.T%%%%%%.SMFDATA. IBM Security Guardium S-TAP for IMS uses catalog services to determine the names of all cataloged data sets matching the mask, for example:
  • HLQ.D091122.T131000.SMFDATA
  • HLQ.D091123.T131100.SMFDATA
  • HLQ.D091124.T131200.SMFDATA
Notes
The percent (%) wildcard character should only be specified for the numeric characters of the generation and version node of GDG data sets, or as the numeric characters of date or time nodes of the SMF dataset.
Syntax
SMF_DSN_MASK_1(SMF.DUMP.DSN)
Example
SMF_DSN_MASK_1(AUI.SMF.DUMP.COPY)
SMF_DSN_MASK_2(AUI.SMF.DUMP.GDG.G%%%%V%%)
SMF_DSN_MASK_3(AUI.SMF.D%%%%%%.T%%%%%%.COPY)