── NEXT ─┬─────┬─┬───────────┬─────────────────────────────────────────┤
├─ + ─┤ └─<integer>─┘
└─ - ─┘Explanation
The NEXT command initiates page mode and allows movement through the work file while in page mode. By transmitting NEXT on the CANDE command line, the user can invoke page mode and display the first page of records in the work file. Once in page mode, the user can transmit NEXT+<integer> or NEXT–<integer> to shift <integer> pages through the work file forward or backward from the displayed page. The cursor should be positioned immediately after the last character of the NEXT command when the command is transmitted. However, the TAB key can be used to advance the cursor over the next command. If this results in the cursor being positioned beyond the first period (.) of the column indicator line, CANDE ignores the period. The user can transmit NEXT+ or NEXT– from the first column of any line on the displayed page, with the same result.
When a non-page-invoking CANDE command is transmitted, page mode is temporarily interrupted. The user can transmit NEXT to return to page mode, which displays a page the specified number of pages (<integer>) away from the page that was displayed immediately before page mode was interrupted.
The term page used here is synonymous with screenful. The size of the page displayed on the screen is specified by using the TERMINAL command. (For more information, refer to the TERMINAL command.) NEXT+<integer> causes the file to be shifted forward by <integer> multiplied by the number of records in each page. After the shifting is done, a page of records is displayed. If less than a page is left in the file, the remaining lines are displayed along with a line providing the following message:
#DISPLAY COMPLETE
If <integer> is not specified, 1 is assumed. If + or –is not specified, + is assumed.
The token NEXT in the upper left-hand corner of the screen indicates that the user is in page mode. CANDE ignores other tokens on the top line when the user transmits page-mode input. CANDE displays NEXT+ if NEXT+ was just completed and NEXT– if NEXT– was just completed. This information is for the user's information. CANDE ignores this when retransmitted unless the user indicates it is a command by placing the cursor immediately after NEXT+ or NEXT-- and transmitting.
If the user transmits with the cursor in the home position (the upper left-hand corner of the screen) or anywhere other than immediately after NEXT+ or NEXT–, CANDE processes the entire input and displays the next page forward, regardless of whether NEXT+ or NEXT– appears at the top of the screen. Refer to Page Mode Operations for more information.
If a terminal is incapable of page mode, the LIST command should be used to display records in amounts that the terminal is capable of accepting.
Examples
The following examples will display the fifth page forward from the page currently being displayed:
NEXT 5 N +5
The following example will display the page previous to the page currently being displayed:
NEXT -
The following example will display the page that follows the currently displayed page:
N
