FCCT gate, SET function
This function is used to change the attributes of a table. The maximum number of records can be changed, the open mode can be changed to indicate that loading is no longer taking place, and the access mode can be changed from exclusive to shared.
Input Parameters
- ACCESS_MODE
- Optional Parameter
- Specifies whether the table is being opened for exclusive or
shared use. Values for the parameter are:
- EXCLUSIVE
- SHARED
- PREFER_SHARED
- AVAILABLE
- Optional Parameter
- Indicates whether new open requests are currently allowed for
this table. Values for the parameter are:
- YES
- NO
- LOADED
- Optional Parameter
- Indicates whether the table has been loaded. If the table was
created as empty this parameter is set to YES as
if loading had already taken place. Values for the parameter are:
- YES
- NO
- MAXIMUM_RECORDS
- Optional Parameter
- This fullword binary field specifies the maximum number of records that can be stored in the table. If no maximum limit is required, the maximum positive number (hex 7FFFFFFF) can be specified.
- SHARED_ACCESS
- Optional Parameter
- Specifies for an exclusive open mode whether other users are allowed
shared access to the file at the same time. Values for the parameter
are:
- NONE
- READ_ONLY
- READ_WRITE
- TABLE_NAME
- 16-character table name. This name is typically the CICS® file name padded with trailing blanks.
- TABLE_TOKEN
- Optional Parameter
- Token returned by the OPEN function, which must be passed on all subsequent requests against that open table. If the table is currently open, the table token must be specified. If no table token is specified, a security check for table access is performed.
- TRANSACTION_NUMBER
- Optional Parameter
- This 4-character string identifies the requesting task in the debug trace if used.
Output Parameters
- REASON
- The following values are returned when RESPONSE is EXCEPTION:
- SERVER_CONNECTION_FAILED
- ACCESS_NOT_ALLOWED
- TABLE_NOT_FOUND
- SHARED_ACCESS_CONFLICT
- EXCLUSIVE_ACCESS_CONFLICT
- ALREADY_SET
- INCORRECT_STATE
- OPTION_NOT_SUPPORTED
- TABLE_TOKEN_INVALID
- TABLE_DESTROYED
- POOL_STATE_ERROR
- CF_ACCESS_ERROR
- RESPONSE
- Indicates whether the domain call was successful. For more information, see RESPONSE parameter on domain interfaces.
- Values for the parameter are:
- OK
- EXCEPTION
- DISASTER
- INVALID
- KERNERROR
- PURGED