Running XSORT [ HP RPG/XL Utilities-Part 1 XSORT ] MPE/iX 5.0 Documentation
HP RPG/XL Utilities-Part 1 XSORT
Running XSORT
Extra Function Sort for RPG can be run in job stream or interactively.
Streaming is the recommended method because the program does not
presently prompt for input.
On the following pages are examples of the MPE commands needed to run the
program in several modes. The grid below indicates the alternatives open
to you. The vertical column on the left presents the ways in which the
specifications can be entered--either in job streams with specifications
imbedded (or using the formal file designator, XSORTEXT); or in sessions
in which the data is entered interactively (or again, using XSORTEXT). In
the examples, the file equation XSORTEXT=$STDIN has been left out where
it would otherwise be used as that is the default setting for XSORTEXT.
The horizontal columns at the top of the grid show the choices open to
you concerning input and output files as well as the Count-only sort
(SORTC) designated Example #9.
Each box in the grid contains the number of the example (or combination
of examples) to refer to for the sort to be run. To use the grid, you
must determine what kind of sort you will require (whether it is an in
place sort or one using multiple input files, for example). Then you
must determine your method of running the program (in job stream using
XSORTEXT, for example). You can find the means by which this work can be
successfully accomplished in the pages that follow and, if your needs are
not explicitly covered, it is possible to combine the information
included in the examples to enter your requirements into the system.
-------------------------------------------------------------------------------------------------------
| | | | | | |
| | Single file | Single file | Single file | Multiple input | SORTC |
| | input | input | input | | (count-only)* |
| | to different | -- inplace | to different | | |
| | output | | output | | |
| | (doesn't | | (already | | |
| | already exist) | | exists) | | |
| | | | | | |
-------------------------------------------------------------------------------------------------------
| | | | | | |
| Job Stream: | #1 | #6 | #7 | #8 | #9 |
| Specs | | | | | |
| Imbedded | | | | | |
| | | | | | |
-------------------------------------------------------------------------------------------------------
| | | | | | |
| Job Stream: | #2 | (Combine) | (Combine) | (Combine) | (Combine) |
| XSORTEXT | | #2 & #6 | #2 & #7 | #2 & #8 | #2 & #9 |
| | | | | | |
-------------------------------------------------------------------------------------------------------
| | | | | | |
| Session: Specs| #3 | (Combine) | (Combine) | (Combine) | (Combine) |
| Interactive | | #3 & #6 | #3 & #7 | #3 & #8 | #3 & #9 |
| | | | | | |
-------------------------------------------------------------------------------------------------------
| | | | | | |
| Session: | #4 | (Combine) | (Combine) | (Combine) | (Combine) |
| XSORTEXT | | #4 & #6 | #4 & #7 | #4 & #8 | #4 & #9 |
| (Case 1) | | | | | |
| | | | | | |
-------------------------------------------------------------------------------------------------------
| | | | | | |
| Session | #5 | (Combine) | (Combine) | (Combine) | (Combine) |
| XSORTEXT | | #5 & #6 | #5 & #7 | #5 & #8 | #5 & #9 |
| (Case 2) | | | | | |
| | | | | | |
-------------------------------------------------------------------------------------------------------
Case 1 - XSORTIN-and XSORTOUT are disk files.
Case 2 - XSORTIN=$STDIN and XSORTOUT=$STDLIST.
* Example #9 uses single file input. Count-only (SORTC) can also be
used with multiple file input. To determine the appropriate commands
for a multiple file SORTC, see Example #8 regarding how it specifies
multiple input files (XSORTIN1...XSORTIN9).
MPE/iX 5.0 Documentation