onspaces -a: Add a chunk to a dbspace or blobspace

Figure 1. Syntax:
(1)
Notes:
  • 1 Windows only

Use onspaces -a to add a chunk to a dbspace or blobspace.

Element Purpose Key considerations
-a Indicates that a chunk is to be added You can have up to 32766 chunks in an instance. You can put all those chunks in one storage space, or spread them among multiple storage spaces.
drive Specifies the Windows drive to allocate as unbuffered disk space The format can be either \\.\<drive>, where drive is the drive letter assigned to a disk partition, or \\.\PhysicalDrive<number>, where PhysicalDrive is a constant value and number is the physical drive number. For more information, see Allocating raw disk space on Windows.

Example: \\.\F:

For path name syntax, see your operating-system documentation.

-m pathname offset Specifies an optional path name and offset to the chunk that mirrors the new chunk Also see the entries for pathname and offset in this table. For more information, see Adding a chunk to a dbspace or blobspace.
-o offset After the -a option, offset indicates, in kilobytes, the offset into the disk partition or into the device to reach the initial chunk of the new blobspace or dbspace Unsigned integer. The starting offset must be equal to or greater than 0. The starting offset plus the chunk size cannot exceed the maximum chunk size. The maximum offset is 4 terabytes.

For more information, see Allocating raw disk space on UNIX.

-p pathname Indicates the disk partition or unbuffered device of the initial chunk of the blobspace or dbspace that you are adding

The chunk must be an existing unbuffered device or buffered file.

The chunk path name can be up to 256 bytes. When you specify a path name, you can use either a full path name or a relative path name. However, if you use a relative path name, it must be relative to the directory that was the current directory when you initialized the database server.

UNIX example (unbuffered device): /dev/rdsk/c0t3d0s4 UNIX example (buffered device): /ix/ids9.2/db1chunk

Windows example: c:\Ifmxdata\ol_icecream\mychunk1.dat

For path name syntax, see your operating-system documentation.

-s size Indicates, in kilobytes, the size of the new blobspace or dbspace chunk Unsigned integer. The size must be equal to or greater than 1000 kilobytes and a multiple of the page size. The starting offset plus the chunk size cannot exceed the maximum chunk size. The maximum offset is 4 terabytes.
blobspace Names the blobspace to which you are adding a chunk See Adding a chunk to a dbspace or blobspace.

Syntax must conform to the Identifier.

dbspace Names the dbspace to which you are adding a chunk See Adding a chunk to a dbspace or blobspace.

Syntax must conform to the Identifier.

This command has an equivalent SQL administration API function.