positionCursorRequest

Positions the cursor for the next read. The positionCursorRequest can be called only if a cursor has been created by calling createCursorRequest.

Request

<positionCursorRequest>
   <container type="types:uid"/>
   <cursor type="int"/>
   <seek type="types:CursorSeek"/>
   <offset type="int"/>
</positionCursorRequest>

Response

<positionCursorResponse>
   <status type="types:Status"/>
</positionCursorResponse>

Elements

container

(required) Specifies the ID of the container.

cursor

Specifies the value returned from createCursorRequest.

seek

Specifies the anchor position of the cursor: current, start, or end.

offset

Specifies the offset from the anchor position of the cursor.

code

Returns the error number related to the event. 0 indicates that the request was successful.

status

Returns the success or failure of the method.

Example

<positionCursorRequest> 
   <container>7.domain1.po1.100.0.1.0.1@16</container> 
   <cursor>1184919325</cursor> 
   <seek>end</seek> 
   <offset>5</offset> 
</positionCursorRequest>

<positionCursorResponse> 
   <status> 
      <code>0</code> 
   </status> 
</positionCursorResponse>