z/OS DFSMSrmm Application Programming Interface
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Using the CONTINUE operation in the EDGXCI macro

z/OS DFSMSrmm Application Programming Interface
SC23-6872-00

Use the EDGXCI OPERATION=CONTINUE parameter in your application program to ensure that you obtain all the available data. When you use OPERATION=CONTINUE, you might not receive more output data or you might receive only messages in your output buffer.

The DFSMSrmm API can return control back to your application program before returning all the data you expect because:
  • There is no more room in the output buffer for the additional data.
  • The API stops after returning data for a single resource when you issue a request that uses a SEARCH command with OUTPUT=FIELDS and MULTI=NO is specified (or assumed by default).
  • There is no more data to return to your application program.
The DFSMSrmm API issues return codes and reason codes indicating the results of processing when you specify OPERATION=CONTINUE. Write your application program to check the return codes and reason codes that the DFSMSrmm API returns to your application program.
Table 1. Return codes and reason codes issued when you specify OPERATION=CONTINUE
Return Code Reason Code Processing
0 0 DFSMSrmm issues this return code and reason code in response to a search type subcommand. DFSMSrmm will not return any more records because there are no more records to return or because the search limit has been reached.
0 4 DFSMSrmm issues this return code and reason code when you issue requests specifying the LISTCONTROL subcommand and there are more records to return. Specify the OPERATION=CONTINUE to obtain more records.
4 2 DFSMSrmm issues this return code and reason code in response to a SEARCH type subcommand. The DFSMSrmm API issues these codes when the search limit you set for a DFSMSrmm subcommand has been reached but there might be more records to return.
4 4 DFSMSrmm issues this return code and reason code in response to a search type subcommand. The DFSMSrmm API issues these codes when the search processing indicates fewer records returned than were requested.
4 8 DFSMSrmm issues this return code and reason code in response to a search type subcommand. The DFSMSrmm API issues these codes when no entry meets then search criteria during search processing.

See Controlling output from list and search type requests for an example of the interaction between the size of an output buffer, the amount of output data the API returns, and the LIMIT value you set.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014