Return MRO sessions to CICS®.

FREE (MRO)
>>-FREE--+---------------+--+-------------+--------------------><
+-CONVID(name)--+ '-STATE(cvda)-'
'-SESSION(name)-'
Conditions: INVREQ, NOTALLOC
Description
FREE returns an MRO session to CICS
when a transaction owning it no longer requires it. The session can then be
allocated for use by other transactions.
If you omit both CONVID and
SESSION, the principal facility is freed. Facilities not freed explicitly
are freed by CICS when the task terminates.
If you are running EDF,
and the transaction frees the principal facility, EDF is terminated.
Options
- CONVID(name)
- identifies
the MRO session to be freed. The 4-character name identifies either the token
returned by a previously executed ALLOCATE command in EIBRSRCE in the EIB,
or the token representing the principal session (returned by a previously
executed ASSIGN command).
- SESSION(name)
- specifies
the symbolic identifier (1–4 characters) of a session TCTTE. This option specifies
the alternate facility to be used.
- STATE(cvda)
- gets
the state of the current conversation. The STATE on a FREE command returns
a cvda code of 00 if there is no longer an active conversation. The other
output cvda values are:
- ALLOCATED
- FREE
- PENDFREE
- RECEIVE
- ROLLBACK
- SEND
- SYNCFREE
- SYNCRECEIVE
- SYNCSEND
Conditions
- INVREQ
- occurs
in any one of the following situations:
- The session specified in the command was allocated for a basic (unmapped)
APPC conversation
- The session is in the wrong state to be freed.
(See also EIBRCODE in EXEC interface block.)
Default
action: terminate the task abnormally.
- NOTALLOC
- occurs
if the session specified in the command is not owned by the application.
Default
action: terminate the task abnormally.