INQUIRE JOURNALMODEL

Retrieve information about installed journal models, thus enabling you to obtain corresponding log stream names.

Read syntax diagramSkip visual syntax diagramINQUIRE JOURNALMODEL
 
>>-| INQL1 |--+-----------+--+-----------+--+-----------+------><
              '-| INQL2 |-'  '-| INQL4 |-'  '-| INQL3 |-'
 
INQL1
 
|--INQUIRE JOURNALMODEL(data-value)-----------------------------|
 
INQL2
 
|--JOURNALNAME(data-area)---------------------------------------|
 
INQL4
 
|--STREAMNAME(data-area)----------------------------------------|
 
INQL3
 
|--TYPE(cvda)---------------------------------------------------|
 

Conditions: END, ILLOGIC, NOTAUTH, NOTFND

Description

The INQUIRE JOURNALMODEL command returns information about a particular installed journal model and enables you to obtain corresponding log stream names.

Browsing

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

CICS returns journal models in alphanumeric sequence of the JOURNALNAMEs specified in the journal model, but with specific names being returned before the generic names. The following examples of journal names defined on journal models show the order in which the journal models are returned on a browse JOURNALMODEL operation:

  DFHJ15
  DFHJ25
  DFHJ%0
  DFH*
  USERJNL1
  USERJNL2
  USERJNL*

Options

JOURNALMODEL(data-value)
specifies the 1- to 8-character name of an installed journal model.
JOURNALNAME(data-area)
returns the 1- to 8-character journal name, which can be a specific or a generic name. See the CICS® Resource Definition Guide for further information about the JOURNALNAME operand.
STREAMNAME(data-area)
returns the MVS log stream name (LSN) associated with the JOURNALMODEL entry.

The name can be a specific LSN, or a template using a maximum of any 3 of the 4 symbols symbols &USERID, &APPLID, &JNAME and &SYSID.

The name, LSN or template, can be up to 26 characters in length. Names less than 26 character are padded with trailing blanks (X'40').

TYPE(cvda)
indicates the log stream type. The CVDA values are:
DUMMY
Records are not written to any log stream.
MVS
Records are written to an MVS log stream.
SMF
Records are written to the MVS SMF log stream.

Conditions

END
RESP2 values:
2
All authorized resources 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 END has been given without a preceding START.
2
The browse token is not valid.
NOTAUTH
RESP2 values:
100
The user is not authorized for this command.
NOTFND
RESP2 values:
1
The specified journal model was not found.
[[ Contents Previous Page | Next Page Index ]]