UP - Terminal Paging Utility

The Com-plete terminal paging utility UP enables you to view data in a terminal paging data set created by an online program.


Terminal paging data sets are temporary disk-resident SD data sets, created when needed by an application program. Data sets created by an application program for this purpose are automatically deleted by Com-plete when the application program terminates and another program (or the same program) is invoked.

The application program arranges the data in a paging data set for convenient viewing at a terminal using the UP terminal paging utility. The data is organized into sections called pages. Note that with UP, you can only access this data and display the individual pages at the terminal from which the paging data set was created.

Command Format

To invoke UP, either use a terminal command or PF keys. The command format is:


where option is a one-character code indicating the UP display request to be performed. The available options are:

C When you initially access the terminal paging file, displays the current page defined by the application program that created the file.
 After you initially access the terminal paging file, displays the most recently displayed page.
n Displays the page whose page number is n. Note that n must be an integer equal to or larger than one.
N Displays the next page.
H Displays the highest page in the terminal paging file.
P Displays the page before the currently displayed page.

The PF key assignments for UP are defined in the following table.

Key Display Function Command
PF1 Display next page *UP/N
PF2 Display previous page *UP/P
PF3 Display page one *UP/1
PF4 Display last page *UP/H
PF5 Display current page *UP/C

The PF key assignments are valid only if the application program currently in use has not issued the SETEID function (which intercepts usage of the PF keys).

Functional Considerations

The pages in a terminal paging file are numbered sequentially beginning with one. The application program that created the file may have defined a particular page as the current page. This page is displayed at the terminal when you initially access the paging file with a current page request. Note that once another page is displayed, however, it becomes the current page.

To request display of individual pages from the paging file created by an application program, use the paging commands summarized in the table above.

These commands allow you to access only the file that the program has created for the terminal you are using. You must access page files created for other terminals from those terminals.

Note that using the UP paging command functions will not cause the application program in use to be terminated. All paging requests are serviced by the Com-plete terminal paging subtask which executes independently of the application program task. After you have made one or more paging requests, press ENTER to cause control to be returned to the application program.

While you are using the paging commands, Com-plete may issue an error message stating that you have made an invalid page request. This message usually indicates that you have requested a non-existent page number for display.