HPlogo MPE/iX Intrinsics Reference Manual > Chapter 10 Command Definitions (QUIT-ZSIZE)

SORTOUTPUT

MPE documents

Complete PDF
Table of Contents
Index

Edition 7 E0701 ♥
Edition 7 E0300
Edition 6 E0195

NM and CM callable.

Provides an alternative method of specifying how records are output from the SORT program.

Syntax



              CA      I16
  SORTOUTPUT (record, length);

Parameters


record

16-bit character array

Returns the next output record. The format of this record is specified in the outputoption parameter of the SORTINIT intrinsic.

length

16-bit signed integer

Returns the length of the record parameter value. When no more records remain, the value of this parameter is set to -1.

Operation Notes


SORTOUTPUT signals the beginning of the SORT program and receives each output record from the SORT program into an array specified by the record parameter. SORTOUTPUT signals the end of the input process if SORTINPUT intrinsic is called. Use SORTOUTPUT only if the outputfiles parameter in a call to the SORTINIT intrinsic is not specified. If SORTINPUT is called, then SORTOUTPUT is called only after SORTINPUT has passed all records. A call to SORTOUTPUT always precedes a call to the SORTEND intrinsic.


NOTE: If you are coding a CM application, you must call SORTEND in the same routine in which you call the SORTINIT intrinsic. This is not the case when you code an NM application.

Condition Codes


CCE (2)Request granted. No error occurred during the SORT program.
CCG (0)Not returned.
CCL (1)Request denied. An error occurred during the SORT program.

Related Information


Intrinsics SORTEND, SORTERRORMESS, SORTINIT, SORTINPUT, SORTSTAT, SORTTITLE, HPSORTEND, HPSORTERRORMESS, HPSORTINIT, HPSORTINPUT, HPSORTOUTPUT, HPSORTSTAT, HPSORTTITLE
Manuals SORT-MERGE/XL Programmer's Guide




SORTINPUT


SORTSTAT