LOBOPTS statement


The LOBOPTS statement controls how 

BMC AMI Log Master

 maintains the LOB VSAM files that it uses to store large object (LOB) data.

BMC AMI Log Master creates one set of VSAM files for each LOB column that occurs in the log records that are selected by a log scan. If a LOB column occurs in a partitioned table space, BMC AMI Log Master creates one set of VSAM files for each partition of each LOB column. BMC AMI Log Master deletes the LOB VSAM files at the end of processing unless the log scan includes an output logical log file.

The following figure shows the LOBOPTS statement syntax:

GUID-2DDB83D9-D18C-417D-9170-541A04E915F4-low.png

Option

Description

TRACKS | CYLINDERS

Specifies the units that BMC AMI Log Master uses to allocate LOB VSAM files.

Value

Description

TRACKS

The LOB VSAM files are allocated in tracks.

CYLINDERS

The LOB VSAM files are allocated in DASD cylinders.

See also LOBALLOC=CYLINDERS.

SPACE (priSpace,secSpace)

Specifies how BMC AMI Log Master allocates disk space for LOB VSAM files. Use this keyword along with the CYLINDERS or TRACKS keyword. BMC AMI Log Master allocates these data sets in the same way that VSAM data sets are allocated in JCL. BMC AMI Log Master allocates priSpace first. If BMC AMI Log Master needs more space, it allocates an additional amount of secSpace (often called an extent). BMC AMI Log Master can allocate up to 128 extents.

See also LOBSPACE=(10,10).

VOLUME (volser)

Specifies the volumes that BMC AMI Log Master uses to store LOB VSAM files. Enter a list of valid volsers. Separate multiple volsers with commas. BMC AMI Log Master uses the volumes that you specify in an IDCAMS DEFINE CLUSTER command.

See also LOBVOLS=.

STORCLAS (storageClass)

Specifies the Data Facility Storage Management System (DFSMS) storage class that BMC AMI Log Master uses to store LOB VSAM files.

See also LOBSTOR=.

MGMTCLAS (mgmtClass)

Specifies the DFSMS management class that BMC AMI Log Master uses to store LOB VSAM files.

See also LOBMGMT=.

DATACLAS (dataClass)

Specifies the DFSMS data class that BMC AMI Log Master uses to store LOB VSAM files.

See also LOBDATA=.

PREFIX (clusterPrefix)

Defines a prefix that BMC AMI Log Master uses in the names of LOB VSAM files. BMC AMI Log Master constructs the data set name by using this prefix, the database identifier (DBID) of the LOB column, the page set identifier (PSID) of the column, and a sequentially incremented data set number. To avoid duplicate data sets during repeated log scans, consider using symbolic values such as &DATE. and &TIME. in the prefix that you define.

See also LOBPREF=&&;SYSUID..LOB.

DUPLICATE DATASET

Determines how BMC AMI Log Master responds to a duplicate data set condition as it attempts to create a LOB VSAM file. This keyword determines the severity of the message that BMC AMI Log Master displays, and whether BMC AMI Log Master continues processing. To avoid duplicate data sets during repeated log scans, consider using symbolic values such as &DATE. and &TIME. in the prefix that you define with the PREFIX keyword.

Value

Description

INFO

Specifies that BMC AMI Log Master issues an informational message, deletes the existing file, creates a new file, and continues processing.

WARN

Specifies that BMC AMI Log Master issues a warning message, deletes the existing file, creates a new file, and continues processing.

ERROR

(Default) Specifies that BMC AMI Log Master issues an error message, saves any temporary LOB VSAM files permanently to disk, and terminates the processing.

See also LOBDUPDS=ERROR.

LOBLIMIT nn

Determines the maximum number of LOB VSAM files that BMC AMI Log Master can create to store the LOB data of one LOB column (or one partition of one LOB column). BMC AMI Log Master allocates a new LOB VSAM file only when it has filled the initial data set and all possible extents, but more LOB column data remains to be written. If the number of data sets (with full extents) that are required to store a LOB column’s data exceeds this limit, BMC AMI Log Master issues an error message, saves any temporary LOB VSAM files permanently to disk, and terminates the processing.

Specify the number of data sets between 1 and 26. The default value is 10.

See also LOBLIMIT=10.


 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*