II_PUT Operation--Add a New Segment
This operation adds a new segment to the end of a new peripheral object. This operation takes, as input, the segments of a peripheral object, and returns a completed coupon. When there are multiple segments in an object, the coupon is not complete until the last invocation of the II_PUT operation.
The underlying data type must be provided by the caller, and describes how the underlying data must be represented. See the pop_underdv field in the table below. For example, long varchar objects are stored as varchar segments.
Inputs
The input fields for the II_PUT operation are the parts of the peripheral control block structure that tell the DBMS Server what and how to pass the information. The inputs are as follows:
op_code
The value of II_PUT.
pop_cb
A pointer to the peripheral operations control block, II_POP_CB (for calling).
pop_continuation
Indicates the state of the object. On the first call of a multicall operation, II_C_BEGIN_MASK is set. On the last call, II_C_END_MASK is set. A single call can be either the first call, last call, both, or neither.
pop_coupon
Pointer to the coupon to be created.
pop_segment
A pointer to a data area from which data is taken (to be put into the large object).
pop_underdv
A pointer to a II_DATA_VALUE that describes the data type to be used for each segment.
pop_temporary
Must be II_POP_SHORT_TEMP.
pop_user_arg
Workspace area used by the server. The caller knows nothing of the contents here, but is expected to preserve its contents across multipass calls. Failure to do so results in errors.
Outputs
The output fields for the II_PUT operation describe the results returned by the DBMS Server. The outputs are as follows:
pop_cb
A pointer to the peripheral operations control block, II_POP_CB (for calling).
pop_coupon
For temporaries, are completely filled. This portion cannot be complete until the last call of a multipass operation is completed.
pop_user_arg
Is filled in with server specific information to be preserved and returned by the caller if II_PUT is not a coupon and pop_continuation is not II_C_END_MASK.
pop_error
The DBMS Server fills this field with the error value, if there is any.
Returns
II_STATUS
Last modified date: 08/14/2024