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
Only one user at a time can have an exclusive open active. If the table requires loading and is not yet being loaded, it can be opened only in exclusive mode. The PREFER_SHARED option means that the table will be opened in exclusive mode if loading is required; otherwise, it will be opened in shared mode. The default value for this parameter is 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
The default value for this parameter is 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


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