SMMC gate, FREEMAIN function
The FREEMAIN function of the SMMC gate is used to release an element of storage.
Input Parameters
- ADDRESS | ADDRESS_64
- ADDRESS
- The address of the element to be released, for an element in 24-bit or 31-bit storage.
- ADDRESS_64
- The address of the element to be released, for an element in 64-bit storage.
- CALLER
- Optional Parameter
- Indicates the caller of the function.
- Values for the parameter are as follows:
- EXEC
- MACRO
- SYSTEM
- EXEC_KEY
- Optional Parameter
- The execution key of the program that issued the EXEC FREEMAIN request.
- Values for the parameter are as follows:
- CICS
- USER
- REMARK
- Optional Parameter
- An optional 8-character field that identifies the FREEMAIN operation for problem determination. This field is highlighted when the FREEMAIN trace is interpreted. Typically, it is the name of the control block whose storage is being released.
- STORAGE_CLASS
- Optional Parameter
- Identifies the class of storage that is released.
- Values for the parameter are as follows:
- CICS
- CICS24
- CICS24_SAA
- CONTROL
- LINE
- SHARED_CICS
- SHARED_CICS24
- SHARED_CICS24_SAA
- SHARED_USER
- SHARED_USER24
- TACLE
- TASK
- TASK24
- TASK31
- TEMPSTG
- TERMINAL
- TERMINAL24
- TRANSDATA
- USER
- USER24
- TCTTE_ADDRESS
- Optional Parameter
- An optional field that must be specified if the FREEMAIN request is for storage of class LINE, TERMINAL, or TERMINAL24.
Output Parameters
- REASON
- The following values are returned when RESPONSE is DISASTER:
- DEACTIVATE_FAILURE
- The following values are returned when RESPONSE is EXCEPTION:
- INVALID_EXEC_KEY
- The following values are returned when RESPONSE is INVALID:
- INVALID_ADDRESS
- INVALID_CLASS_ADDRESS
- NO_TCTTE_ADDRESS
- RESPONSE
- Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.