create sbspace with log argument: Create an sbspace with transaction logging (SQL administration API)

Use the create sbspace with log argument with the admin() or task() function to create an sbspace with transaction logging turned on.

Syntax


1  EXECUTE FUNCTION
1 admin
1 task
2  (
2  "create? unencrypted? with_check sbspace with log" , "sbspace" , "path_name"
2?  , "initial_chunk_size"?  , "offset"
2  ) ;
Element Description Key Considerations
initial_chunk_size The size, in kilobytes, of the initial chunk of the new sbspace. See admin() and task() Argument Size Specifications.
offset The offset, in kilobytes, into the disk partition or into the device to reach the initial chunk of the new sbspace.
path_name The disk partition or unbuffered device of the initial chunk of the sbspace.
sbspace The name of the sbspace to be created.

Usage

Use the create with_check sbspace with log argument to check the specified path name and return an error if it does not exist.

Use the create unencrypted sbspace with log argument to create an unencrypted sbspace when encryption is enabled by the DISK_ENCRYPTION configuration parameter.

This function is equivalent to the onspaces -c -S command to create an sbspace with the option for turning logging on.

Example

The following example creates a new sbspace with transaction logging turned on. This sbspace has a size of 20 MB with an offset of 0:

EXECUTE FUNCTION task ("create sbspace with log","sbspace2", 
"$INFORMIXDIR/WORK/sbspace2","20 M","0");