SET JOURNALNAME

Description

The SET JOURNALNAME command allows you to enable or disable a CICS user journal.

SET JOURNALNAME has no effect on a journal that is being used as the forward recovery log or autojournal for a VSAM file until the next time the file is opened. It has no effect on the system log.

You can use SET JOURNALNAME for a journal name that is not currently known to CICS. CICS dynamically creates an entry for the specified journal and, if necessary, defines it to the MVS™ system logger using a matching JOURNALMODEL definition.

The ability to issue SET JOURNALNAME commands for journal names not known to CICS enables you to perform log stream connection processing before the corresponding journals are first referenced. For example, you could do this during a PLT program at initialization to avoid the delay that normally occurs at first reference.

Options

ACTION(cvda)

specifies the action you want CICS to take for the specified journal name. CVDA values are:

FLUSH

The log buffers are written out to the log stream, but the journal is not closed.

You can use this option to ensure that all current records are written out to the log stream before processing the stream using a batch utility.

In the case of autojournals and forward recovery logs, the FLUSH is forced if the file is open (the FLUSH does not wait until the next time the file is opened).

RESET

The journal is disconnected from its log stream, but can be reopened by a journal write.

Note: ACTION and STATUS are mutually exclusive options. If you specify ACTION, you cannot also specify STATUS.

JOURNALNAME(data-value)

specifies the name of the journal.

To modify journals defined with a numeric identifier in the range 1–99, specify journal name DFHJnn, where nn is the journal number.

You cannot specify DFHLOG or DFHSHUNT, because you are not allowed to modify the status of the system log.

STATUS(cvda)

specifies the new status for the journal. The CVDA values are:

DISABLED

The journal is flushed then disabled. It cannot be used again until it is reenabled by the STATUS(ENABLED) or ACTION(RESET) options on a SET JOURNALNAME command.

ENABLED

The journal is open and is available for use.

Note: STATUS and ACTION are mutually exclusive options. If you specify STATUS, you cannot also specify ACTION.

Conditions

INVREQ

RESP2 values:

2

The request is invalid.

3

The system log cannot be changed.

4

The ACTION option has an invalid CVDA value.

5

The STATUS option has an invalid CVDA value.

7

The ACTION option specifies FLUSH or RESET for a journal that is not currently connected to a log stream.

IOERR

RESP2 values:

6

The log stream associated with the journal name cannot be connected to, or the journal cannot be opened, or an unrecoverable error has occurred during the flushing of the log buffer to the log stream.

JIDERR

RESP2 values:

1

The specified journal name was not found.

2

An error occurred during an attempt to define the log stream associated with the journal name, or the journal name has been incorrectly specified.

3

The specified journal name refers to a DASD-only log stream to which a CICS region in another MVS image is currently connected.

NOTAUTH

RESP2 values:

100

The user associated with the issuing task is not authorized to use this command.

101

The user associated with the issuing task is not authorized to access this particular resource in the way required by this command.