INQUIRE JOURNALNAME

Description

The INQUIRE JOURNALNAME command returns information about the journals (including the system log and general logs) on your system.

Browsing

You can also browse through all the journal entries in the journal names table on your system by using the browse options (START, NEXT, and END) on INQUIRE JOURNALNAME commands. See Browsing resource definitions for general information about browsing, including syntax, exception conditions, and examples.

Options

JOURNALNAME(data-value)

specifies a 1- to 8-character journal name.

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

To inquire on the system log, specify DFHLOG.

STATUS(cvda)

indicates the status of the journal. CVDA values are:

DISABLED

The journal has been disabled by a CEMT, or EXEC CICS®, SET JOURNALNAME(…) command. It cannot be used until it is reenabled by the STATUS(ENABLED) or ACTION(RESET) options on a SET JOURNALNAME command.

ENABLED

The journal is installed and is available for use.

FAILED

The journal has experienced a log stream failure. It cannot be used until it is reenabled by the STATUS(ENABLED) or ACTION(RESET) options on a SET JOURNALNAME command, or until after the next CICS restart. The log stream should be deleted from the MVS™ system logger inventory before being used again.

STREAMNAME(data-area)

returns the MVS logger log stream name (LSN) associated with the journal name.

The name can be up to 26 characters in length. Names less than 26 character are padded with trailing blanks (X'40'). If the journal is defined by a journal model that specifies a type of DUMMY or SMF, CICS returns 26 blanks.

TYPE(cvda)

Indicates the type of log stream format. CVDA values are:

DUMMY

Records are not written to any log stream.

MVS

Records are written to an MVS logger log stream.

SMF

Records are written to the MVS SMF log stream.

Conditions

END

RESP2 values:

2

All authorized resource definitions have been retrieved. All data areas specified on this command are left unchanged.

ILLOGIC

RESP2 values:

1

A START has been given when a browse is already in progress, or a NEXT, or an END, has been given without a preceding START.

JIDERR

RESP2 values:

1

The specified journal name was not found.

NOTAUTH

RESP2 values:

100

The user is not authorized for this command.

101

The user does not have the required access to the specified journal. (Not applicable to INQUIRE JOURNALNAME START, INQUIRE JOURNALNAME NEXT, or INQUIRE JOURNALNAME END commands.)