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.


dfhs3_SMMCfreemain.html | Timestamp icon Last updated: Monday, 5 June 2017