Physical Database DDL Statements › JOURNAL BUFFER Statements › Entity Currency › Parameters

Parameters

dmcl-name

Identifies the DMCL with which the journal buffer is associated. Dmcl-name must name an existing DMCL defined to the dictionary. If you don't specify a DMCL name, you must establish a current DMCL as described in 7.3.3, "Entity Currency" earlier in this chapter.

journal-buffer-name

Specifies the name of the journal buffer. Journal-buffer-name must be a 1- through 18-character name that follows the conventions described in 7.3, "Naming Conventions".

PAGE SIZE character-count

Specifies the number of bytes in each page of the buffer. This clause is required on a CREATE statement. The buffer page size determines the block size for all disk or tape journal files defined in the DMCL. If VSAM disk journals are used, the page size must be 8 bytes less than the file's control interval.

If a page is smaller than 256 bytes, then no data storage is possible. We recommend that a minimum page size of 512 bytes or larger be used.

The value of character-count depends upon the operating system:

BUFFER PAGES page-count

Specifies the number of pages to be included in the buffer. This clause is required on a CREATE statement. Page-count must be an integer in the range 1 through 32,767.

DETails

Displays or punches details about the journal buffer.

HIStory

Displays or punches:

• The user who defined the journal buffer
• The user who last updated the journal buffer
• The date the journal buffer was created
• The date the journal buffer was last updated

ALL

Displays or punches all information about the journal buffer. ALL is the default action for a DISPLAY or PUNCH verb.

NONe

Displays or punches the name of the journal buffer.