Return an APPC mapped session to CICS®.
FREE (APPC)
>>-FREE--+--------------+--+-------------+---------------------><
'-CONVID(name)-' '-STATE(cvda)-'
Conditions:
INVREQ, NOTALLOC
Description
FREE returns an APPC 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 CONVID, 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 APPC mapped 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).
If this option is omitted, the
principal facility is assumed.
- STATE(cvda)
- gets the state of the current conversation. The STATE option
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
- CONFFREE
- CONFRECEIVE
- CONFSEND
- FREE
- PENDFREE
- PENDRECEIVE
- RECEIVE
- ROLLBACK
- SEND
- SYNCFREE
- SYNCRECEIVE
- SYNCSEND
Conditions
- 16 INVREQ
- RESP2 values:
- 200
- A distributed program link server application specified the function-shipping
session (its principal facility) on the CONVID option.
also occurs (RESP2 not set) in any of the following situations:
- The CONVID value specified in the command relates to a basic (unmapped)
APPC conversation.
- The CONVID value specified in the command relates to a CPI-Communications
conversation.
Default action: terminate the task abnormally.
- 61 NOTALLOC
- occurs if the specified CONVID value does not relate to a conversation
owned by the application.
Default action: terminate the task abnormally.