SMAR gate, ALLOCATE_TRANSACTION_STG function

The ALLOCATE_TRANSACTION_STG function of the SMAR gate is used at task initialization to add the task-lifetime storage subpools.

Input Parameters

ISOLATE
Indicates whether CICS isolates the user-key task-lifetime storage of the transaction to provide application-to-application protection, as specified by the ISOLATE attribute on the associated TRANSACTION resource definition.
Values for the parameter are as follows:
  • NO
  • YES
STORAGE_CLEAR
Indicates whether to clear task-lifetime storage to zeros when it is released by a FREEMAIN request.
Values for the parameter are as follows:
  • NO
  • YES
STORAGE_FREEZE
Indicates whether to delay task-lifetime storage FREEMAIN requests until task termination.
Values for the parameter are as follows:
  • NO
  • YES
TASK_DATAKEY
Indicates the storage key for the task-lifetime storage and program-related storage (for all programs that run under the transaction) for the transaction, as specified by the TASKDATAKEY attribute on the associated TRANSACTION resource definition.
Values for the parameter are as follows:
  • CICS
  • USER
TASK_DATALOC
Indicates the location of task data for the transaction, as specified by the TASKDATALOC attribute on the associated TRANSACTION resource definition.
Values for the parameter are as follows:
  • ANY
  • BELOW

Output Parameters

REASON
The following values are returned when RESPONSE is DISASTER:
  • ABEND
  • INSUFFICIENT_STORAGE
RESPONSE
Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.


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