Previous Topic: SyntaxNext Topic: Usage

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

Parameters

dmcl-name

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

journal-file-name

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

Journal-file-name must be unique within the DMCL.

BLOCK SIZE character-count

Specifies the number of characters in each block of the archive journal file. This clause is required on a CREATE statement.

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

Operating System

Block Size Range (in bytes)

Comments

z/OS

512 - 327641

Must be greater than or equal to the journal buffer page size and should be sized for efficient tape file storage and access.

z/VSE

512 - 32764

Same as for z/OS.

z/VM

4096

 

Note: Maximum for an IBM 3380 device is 32760.

ASSIGN TO

Associates the archive journal file with an external file name. This clause is required on a CREATE statement. The external file name must be unique within the DMCL.

ddname

Specifies the external name for the file under z/OS or z/VM. ddname must be a 1- through 8-character value that follows operating system conventions for ddnames.

filename

Specifies the external name for the file under z/VSE. Filename must be a 1- through 7-character value that follows operating system conventions for filenames.

DETails

Displays or punches details about the archive journal.

HIStory

Displays or punches:

ALL

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

NONe

Displays or punches the name of the archive journal.