Return LUTYPE6.1 sessions to CICS®.
FREE (LUTYPE6.1)
>>-FREE--+---------------+-------------------------------------><
+-CONVID(name)--+
'-SESSION(name)-'
Conditions: INVREQ, NOTALLOC
Description
FREE returns an LUTYPE6.1 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 LUTYPE6.1 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.
Conditions
- 16 INVREQ
- Occurs
if the session specified in the command was allocated for a basic
(unmapped) APPC conversation.
See also EIBRCODE in EIB fields.
Default action: terminate
the task abnormally.
- 61 NOTALLOC
- Occurs
if the session specified in the command is not owned by the application.
Default action: terminate the task abnormally.