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.

XMLOPTS statement

The XMLOPTS statement controls how Log Master maintains the XML VSAM files that it uses to store data from XML columns.

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

The XML VSAM files are different than the external files that Log Master can write when an XML column is included in generated output load files. For more information about the external files, see TEMPLATE.

Note

Log Master does not support partially logged XML documents that are associated with XML multi-versioning and XML update processing.

XMLOPTS statement syntax diagram

OptionDescription

TRACKS | CYLINDERS

Specifies the units that Log Master uses to allocate XML VSAM files.

ValueDescription
TRACKSThe XML VSAM files are allocated in tracks.
CYLINDERSThe XML VSAM files are allocated in DASD cylinders.

See also LOBALLOC=CYLINDERS.

SPACE (priSpace, secSpace)

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

See also LOBSPACE=(10,10).

VOLUME (volser)

Specifies the volumes that Log Master uses to store XML VSAM files. Enter a list of valid volsers. Separate multiple volsers with commas. 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 Log Master uses to store XML VSAM files.

See also LOBSTOR=.

MGMTCLAS (mgmtClass)

Specifies the DFSMS management class that Log Master uses to store XML VSAM files.

See also LOBMGMT=.

DATACLAS (dataClass)

Specifies the DFSMS data class that Log Master uses to store XML VSAM files.

See also LOBDATA=.

PREFIX (clusterPrefix)

Defines a prefix that Log Master uses in the names of XML VSAM files. Log Master constructs the data set name by using this prefix, the database identifier (DBID) of the XML 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 XMLPREF=&&SYSUID..XML.

DUPLICATE DATASET

Determines how Log Master responds to a duplicate data set condition as it attempts to create an XML VSAM file. This keyword determines the severity of the message that Log Master displays, and whether 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.

ValueDescription
INFOSpecifies that Log Master issues an informational message, deletes the existing file, creates a new file, and continues processing.
WARN Specifies that Log Master issues a warning message, deletes the existing file, creates a new file, and continues processing.
ERROR(default) Specifies that Log Master issues an error message, saves any temporary XML VSAM files permanently to disk, and terminates processing.

See also LOBDUPDS=ERROR.

XMLLIMIT nn

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

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

See also LOBLIMIT=10.


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

Comments