Space announcements

   

This space provides the same content as before, but the organization of the home page has changed. The content is now organized based on logical branches instead of legacy book titles. We hope that the new structure will help you quickly find the content that you need.

LOGSCAN output definition

Use this syntax to control the location and type of data sets that Log Master creates as output.

The following figure shows the Output definition syntax of the LOGSCAN statement.


dataSetName

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.

SHR

Defines the disposition of the data set. SHR indicates that dataSetName already exists and that it can be shared.

OLD

Defines the disposition of the data set. OLD indicates that dataSetName already exists, but it cannot be shared.

MOD

Defines the disposition of the data set. MOD indicates the following behavior:

  • If dataSetName already exists, Log Master appends any output to the end of the data set.

  • If dataSetName does not exist, Log Master creates a new sequential data set.

    For more information about what Log Master does when the data set does not exists and you do not specify allocation parameters, see Allocation parameters.

In either case, access to the data set cannot be shared.

NEW

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.

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:

Related topic



Was this page helpful? Yes No Submitting... Thank you

Comments