INQUIRE STREAMNAME

Retrieve information about a currently connected MVS log stream.

INQUIRE STREAMNAME

Read syntax diagramSkip visual syntax diagramINQUIRE STREAMNAME( data-value)STATUS(cvda)SYSTEMLOG(cvda)USECOUNT(data-area)

Conditions: END, ILLOGIC, NOTAUTH, NOTFND

Description

The INQUIRE STREAMNAME command allows you to look at information about a currently connected MVS log stream.

Browsing

You can also browse through log stream names by using the browse options (START, NEXT, and END) on INQUIRE STREAMNAME commands. See Browsing resource definitions for general information about browsing, including syntax, exception conditions, and examples.

Options

STATUS(cvda)
returns a CVDA value indicating the status of the log stream. CVDA values are:
FAILED
The message logger has detected a problem with the specified log stream.
OK
No errors have been detected.
STREAMNAME(data-value)
specifies an MVS system logger log stream name.

CICS returns a NOTFND condition if the log stream name does not exist, or if there are no longer any users of the log stream in this CICS region (see the USECOUNT option).

SYSTEMLOG(cvda)
returns a CVDA value indicating whether the log stream is the system log. CVDA values are:
NOSYSLOG
The log stream is not the system log.
SYSLOG
The log stream is the system log.
USECOUNT(data-area)
returns the number of CICS journal names and forward recovery logs within this CICS system that are currently using the log stream.

The use count is always at least 1, because CICS does not maintain any information about a log stream that no longer has any users, in which case an INQUIRE STREAMNAME command returns a NOTFND condition.

If the log stream name refers to the CICS system log, the use count is always 1. This is so, even when user application programs write recovery records to the CICS system log.

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.
2
The browse token is not valid.
NOTAUTH
RESP2 values:
100
The user is not authorized for this command.
NOTFND
RESP2 values:
1
The requested log stream name was not found.