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>