INQUIRE JOURNALMODEL

Description

The INQUIRE JOURNALMODEL command returns information about a particular installed journal model so that you can 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:

The resource signature

You can use this command to retrieve the resource signature fields. You can use these fields to manage resources by capturing details of when the resource was defined, installed, and last changed. For more information, see Auditing resources. The resource signature fields are BUNDLE, CHANGEAGENT, CHANGEAGREL, CHANGETIME, CHANGEUSRID, DEFINESOURCE, DEFINETIME, INSTALLAGENT, INSTALLTIME, and INSTALLUSRID. See Summary of the resource signature field values for detailed information about the content of the resource signature fields.

Options

CHANGEAGENT(cvda)

Returns a CVDA value that identifies the agent that made the last change to the resource definition. The possible values are as follows:

CREATESPI

The resource definition was last changed by an EXEC CICS CREATE command.

CSDAPI

The resource definition was last changed by a CEDA transaction or the programmable interface to DFHEDAP.

CSDBATCH

The resource definition was last changed by a DFHCSDUP job.

DREPAPI

The resource definition was last changed by a CICSPlex SM BAS API command.

CHANGEAGREL(data-area)

Returns a 4-digit number of the CICS release that was running when the resource definition was last changed.

CHANGETIME(data-area)

Returns an ABSTIME value that represents the time stamp when the resource definition was last changed. For more information about the format of the ABSTIME value, see FORMATTIME.

CHANGEUSRID(data-area)

Returns the 8-character user ID that ran the change agent.

DEFINESOURCE(data-area)

Returns the 8-character source of the resource definition. The DEFINESOURCE value depends on the CHANGEAGENT value. For more information, see Summary of the resource signature field values.

DEFINETIME(data-area)

Returns an ABSTIME value that represents the time stamp when the resource definition was created.

INSTALLAGENT(cvda)

Returns a CVDA value that identifies the agent that installed the resource. The possible values are as follows:

CREATESPI

The resource was installed by an EXEC CICS CREATE command.

CSDAPI

The resource was installed by a CEDA transaction or the programmable interface to DFHEDAP.

GRPLIST

The resource was installed by GRPLIST INSTALL.

INSTALLTIME(data-area)

Returns an ABSTIME value that represents the time stamp when the resource was installed.

INSTALLUSRID(data-area)

Returns the 8-character user ID that installed the resource.

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 JOURNALMODEL definition attributes 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 three of the four symbols &USERID, &APPLID, &JNAME, and &SYSID.

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

TYPE(cvda)

Indicates the log stream type. The CVDA values are as follows:

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.