FREE (MRO)

Return MRO sessions to CICS®.

FREE (MRO)

Conditions: INVREQ, NOTALLOC

Description

FREE returns an MRO session to CICS when a transaction that owns 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

16 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.