IBM SC34-6814-04 User Manual

Page of 953
STORAGE_CLASS(CICS|CICS24|SHARED_CICS|SHARED_CICS24|
SHARED_USER|SHARED_USER24|USER|USER24|TERMINAL)
specifies the class of the storage that is the subject of the call. The values you
can assign to this option, and the type of storage each represents, are listed in
Table 20.
Table 20. CICS storage classes
STORAGE_CLASS
Type of storage
CICS
Task-lifetime CICS-key storage above 16MB
CICS24
Task-lifetime CICS-key storage below 16MB
SHARED_CICS
Shared CICS-key storage above 16MB
SHARED_CICS24
Shared CICS-key storage below 16MB
SHARED_USER
Shared user-key storage above 16MB
SHARED_USER24
Shared user-key storage below 16MB
TERMINAL
This class of storage has an 8-byte SAA.
USER
Task-lifetime user-key storage above 16MB
USER24
Task-lifetime user-key storage below 16MB
You must specify a storage class on a GETMAIN request. On a FREEMAIN
request it is an optional parameter, and any value that you specify is not
checked by CICS.
SUSPEND(YES|NO)
specifies whether to suspend your request if there is less storage available than
you have asked for on the GET_LENGTH option.
TCTTE_ADDRESS(name4 | (Ra))
specifies the address of the terminal control table terminal entry (TCTTE). On
GETMAIN requests, you must code this option if, on the STORAGE_CLASS
option, you specify a class of TERMINAL. On FREEMAIN requests, you must
code it if you are freeing TERMINAL-class storage.
Note: Before obtaining TERMINAL class storage, check TCAFCI bit 7 to
ensure that the TCA is running under a terminal.
name4
The name of a fullword containing the address
(Ra)
A register that points to the TCTTE.
RESPONSE and REASON values for GETMAIN:
RESPONSE
REASON
OK
None
EXCEPTION
INSUFFICIENT_STORAGE
DISASTER
None
INVALID
None
KERNERROR
None
PURGED
None
Note:
1. For more detail, refer to the explanation of RESPONSE and REASON in
394
Customization Guide