LOGSCAN output definition
The following figure shows the Output definition syntax of the LOGSCAN statement.
Specifies a data set where Log Master creates the output. The dataSetName follows operating system guidelines for data set names. Depending on the keyword that you use (SHR, MOD, OLD, or NEW), you can specify a partitioned data set, a sequential data set, or a member of a generation data group (GDG) . If the dataSetName is eight bytes or less, Log Master treats the name as a DD name.
You can also use the normal product symbolic substitutions in data set names. For more information, see Symbolic substitutions.
|( - nn )|
Defines the data set as an existing entry in the GDG group specified by dataSetName. The -nn value refers to the entry using a relative numeric value. Refer to the most recent entry with the suffix of zero (0). Refer to the preceding generation with the suffix of (-1), and so on.
|( + nn )|
Defines the data set as a new entry to the GDG group specified by dataSetName. The +nn value refers to the entry using a relative numeric value. To create a new entry, use a suffix of +1.
|( member )|
Defines a member of a partitioned data set. Use this keyword only for SQL, DDL, logical log control, load control, and report data sets.
Defines the disposition of the data set. SHR indicates that dataSetName already exists and that it can be shared.
Defines the disposition of the data set. OLD indicates that dataSetName already exists, but it cannot be shared.
Defines the disposition of the data set. MOD indicates the following behavior:
In either case, access to the data set cannot be shared.
Directs Log Master to create a new sequential data set. You cannot specify a partitioned data set as NEW. For more information about what Log Master does if you do not specify allocation parameters for a new data set, see Allocation parameters.
If a data set is specified as NEW (or if it is specified as MOD, but the data set does not exist) you can specify parameters to allocate the data set. For more information about how to specify the parameters, see Allocation parameters.
BMC Software recommends that you specify allocation parameters for either a NEW data set or a MOD data set that does not exist. If you do not specify allocation parameters, Log Master creates a new data set, but the data set’s attributes depend on the storage management policies in your environment, and might not be optimal for the output that Log Master creates.
This section contains the following topic: