Retrieves information about a session group within a connection.

Syntaxe:

INQUIRE MODENAME
 
>>-INQUIRE MODENAME(data-value)--------------------------------->
 
   .----------------------------.
   V                            |
>----+------------------------+-+------------------------------><
     +-ACTIVE(data-area)------+
     +-AUTOCONNECT(cvda)------+
     +-AVAILABLE(data-area)---+
     +-CONNECTION(data-value)-+
     +-MAXIMUM(data-area)-----+
     +-MAXWINNERS(data-area)--+
     '-MODENAME(data-value)---'
 
 

For more information about the use of CICS-value data areas (CVDAs), see Appendix F, CVDAs recognized by the translator.

Descrição:

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 that is specified in the Communications Definitions (CD) entry for the connection.
Information about the specified MODENAME is obtained from the SNA product that supports the session.
The MODENAME values are unique within a given connection, but not across connections.
Therefore, to look at a particular session group, you must specify data values for the MODENAME and CONNECTION options.

Comentarios:

You can also browse through all the session 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 the MODENAME and CONNECTION options on an INQUIRE MODENAME NEXT command.
The value for 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 value 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.
CICS uses the data-area value to return the connection name.

Opções

ACTIVE(data-area)
• Returns a 16-bit binary field that gives the number of sessions within the group that are currently in use.

AUTOCONNECT(cvda)
• Returns a CVDA value that indicates whether the sessions that are in this group are to be bound automatically whenever CICS starts communication with the SNA product.
• The CVDA values are:
  • ALLCONN
    • CICS tries to bind all sessions.
  • AUTOCONN
    • CICS tries to bind only sessions for which it is the designated contention winner.
  • NONAUTOCONN
    • CICS does not try to bind any sessions.
    • TXSeries for Multiplatforms always returns this value.

AVAILABLE(data-area)
• Returns a 16-bit binary field that gives the current number of sessions that are in the group.

CONNECTION(data-value)
• Specifies the 4-character identifier of the remote system with which this group of sessions is associated (the name of the Communications Definitions (CD) stanza entry for that system).

MAXIMUM(data-area)
• Returns a 16-bit binary field that gives the maximum number of sessions that the definition of the session group permits.

MAXWINNERS(data-area)
• Returns a 16-bit binary field that gives the maximum number of sessions that the definition of the session group permits to be contention winners.

MODENAME(data-value)
• Specifies the eight-character identifier of the group of sessions about which you are inquiring.
• This is the name of a mode as defined to the SNA product.

Condições:

END
• RESP2 values:
  • No more resource definitions of this type exist (RESP2=2).

ILLOGIC
• RESP2 values:
  • You have issued a START command when a browse of this resource type is already in progress, or you have issued a NEXT or an END command when a browse of this resource type is not in progress (RESP2=1).

SYSIDERR
• RESP2 values:
  • The connection cannot be found (RESP2=1).
  • The MODENAME within the connection cannot be found, or the SNA product is not active (RESP2=2).
  • The connection specified on an INQUIRE MODENAME NEXT cannot be found. The data set cannot be found (RESP2=3).