nextPage(conversation, parameterValues, options)

Use this method to retrieve the next page of the result set.

This method may return the following values in the bibus » asynchReply » status property:

You may make secondary requests after using this method, depending on the server response. For more information about the asynchronous conversation status and secondary requests in asynchronous conversations, see Secondary requests.

Signatures

Java and Apache Axis
 
public  com.cognos.developer.schemas.bibus._3.AsynchReply  nextPage( 
com.cognos.developer.schemas.bibus._3.AsynchRequest  conversation, 
com.cognos.developer.schemas.bibus._3.ParameterValue[] 
parameterValues,  com.cognos.developer.schemas.bibus._3.Option[] 
options) 
C# .NET
 
public  asynchReply  nextPage(asynchRequest  conversation, 
parameterValue[]  parameterValues,  option[]  options) 
Example: Using the nextPage(conversation, parameterValues, options) Method with the Report Service in Java

The following Java code snippet demonstrates how to use the paging » nextPage(conversation, parameterValues, options) method with the report service.

To see this code in context, view the Java sample ExecReports/RunReport.java. For more information about the samples, see Code samples and language-specific coding practices.

 
rsr  = 
	connection.getReportService().nextPage( 
		rsr.getPrimaryRequest(), 
		new  ParameterValue[]  {}, 
		new  Option[]  {}); 
 

References

Part of the following method sets:
Implemented by the following services:

The services that implement the nextPage method, along with the associated SOAP actions, are listed in the following table.

Table 1. Services implementing the nextPage method.

Service

SOAP Action
batchReportService

http://www.ibm.com/xmlns/prod/cognos/batchReportService/201404/.high
eventManagementService

http://www.ibm.com/xmlns/prod/cognos/eventManagementService/201404/.high
indexSearchService

http://www.ibm.com/xmlns/prod/cognos/indexSearchService/201404/.high
monitorService

http://www.ibm.com/xmlns/prod/cognos/monitorService/201404/.high
reportService

http://www.ibm.com/xmlns/prod/cognos/reportService/201404/.high

batchReportService and reportService information

This information is specific to the batchReportService and reportService services.

Use this method to retrieve the next page of report output. The output is stored in an instance of bibus » asynchDetailReportOutput, which is returned in the bibus » asynchReply » details property when the request is complete.

If the request causes a query that has not already run to do so, and if that query must prompt the user for new parameter values, this method returns a value of prompting in the bibus » asynchDetailReportStatus » status property. An instance of this class will be returned in the bibus » asynchReply » details property.

eventManagementService information

This information is specific to the eventManagementService service.

Use this method to retrieve the next page of the result set. An instance of bibus » asynchDetailEventRecord is returned in the bibus » asynchReply » details property for each event when the request is complete.

New in Version 8.3 — Schedule Management

The documentation has been updated to indicate that this service now supports this method.

monitorService information

This information is specific to the monitorService service.

Use this method to retrieve the next page of the result set. An instance of bibus » asynchDetailEventRecord is returned in the bibus » asynchReply » details property for each event when the request is complete.

New in Version 8.3 — Schedule Management

The documentation has been updated to indicate that this service now supports this method.

Input parameters

Use the following parameters when calling this method.

conversation

Specifies the current state of the asynchronous conversation. All methods that begin an asynchronous conversation, and most methods used within an asynchronous conversation, return this information as the value of the bibus » asynchReply » primaryRequest property.

The value of this parameter should be obtained from the most recent instance of the bibus » asynchReply » primaryRequest property returned from a method for the same conversation.

This argument

parameterValues

Specifies the parameter values for the request.

Parameter values can also be specified in other locations. For more information, see Specifying Options and Parameters.

This argument

options

Specifies the options for the request.

Options can also be specified in other locations. For more information, see Specifying Options and Parameters.

This argument

  • is an array of type bibus » option

    is encoded as type tns:optionArray

Return values

This method returns the following values.

result

Returns the state of the asynchronous conversation. Possible asynchronous conversation states are defined in the bibus » asynchReplyStatusEnum enumeration set.

Any data requested can be obtained by examining the bibus » asynchReply » details property.

This result