INQUIRE STREAMNAME
Retrieve information about a currently connected MVS log stream.
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.