Retrieving the next resource

In the second step of a browse, you issue the INQUIRE command repeatedly with another option, NEXT. CICS returns one resource definition for each INQUIRE NEXT.

The general format is:

INQUIRE resource-type(data-area) NEXT option...option

Apart from the addition of NEXT, the options are almost the same on an INQUIRE NEXT command as on a single INQUIRE for the same type of resource. Again, however, there are some differences:

Instead of specifying the name of the resource (a data-value), you provide a data-area of the same length for CICS to return the name of the next resource to you.
Options by which CICS returns data to you are used in the same way as on the single-resource form.
A few options, such as the CONNECTION option on INQUIRE MODENAME, change their roles in a browse. These differences also are noted in the commands to which they apply.

If your INQUIRE START command used the APPLICATION, APPLMAJORVER, APPLMINORVER, APPLMICROVER, and PLATFORM options to specify an application context for a browse of private resources, do not specify these options again on the INQUIRE NEXT command. You only need to specify these options when starting the browse.

You repeat the INQUIRE NEXT command until you have seen the resource definitions you want or have exhausted the definitions. After you have retrieved the last of them, CICS raises the END condition on subsequent INQUIRE NEXTs, leaving any data-areas you provided unchanged. However, you do not have to retrieve all the definitions; you can stop the browse at any time.