Retrieve information about a session group within a connection.
INQUIRE MODENAME >>-INQUIRE MODENAME(data-value)--CONNECTION(data-value)---------> .---------------------------. V | >----+-----------------------+-+------------------------------->< +-ACTIVE(data-area)-----+ +-AUTOCONNECT(cvda)-----+ +-AVAILABLE(data-area)--+ +-MAXIMUM(data-area)----+ '-MAXWINNERS(data-area)-'
Conditions: END, ILLOGIC, NOTAUTH, SYSIDERR
For more information about the use of CVDAs, see CICS-value data areas (CVDAs).
The INQUIRE MODENAME command returns information about a group of sessions (sometimes called a "mode") that has been defined within a connection to a remote system. (The MODENAME for the group is the name assigned to the SESSIONS resource definition that creates it.)
MODENAMEs are unique within a given connection, but not across connections. Therefore, to look at a particular session group, you must specify data values for both the MODENAME and CONNECTION options.
You can also browse through all of the session groups for a particular connection, or all groups for all connections, by using the browse options (START, NEXT, and END) on INQUIRE MODENAME commands.
As in a single INQUIRE MODENAME command, you must include both the MODENAME and CONNECTION options on an INQUIRE MODENAME NEXT command. The data-area for MODENAME is optional; if you provide it, CICS uses it to return the name of the session group. The data-area for CONNECTION is required, however. If you want to limit your browse to a single connection, specify its name there. To see all groups, initialize this value to nulls on each INQUIRE MODENAME NEXT command, and CICS will use the data-area to return the connection name.
See Browsing resource definitions for general information about browsing, including syntax, exception conditions, and examples.