Arguments

 

code

   OpenVMS usage:longword_unsigned
   type:         longword (unsigned)
   access:       read only
   mechanism:    by reference
   SORT/MERGE statistic code. The code argument is the address of
   a longword containing the code that identifies the statistic
   you want returned in the result argument. The following table
   describes the values that are accepted.

   Note: The high-performance Sort/Merge utility currently supports
   only the following subset of these values: SOR$K_REC_INP, SOR$K_
   REC_SOR, SOR$K_REC_OUT, SOR$K_LRL_INP.

   Code             Description

   SOR$K_IDENT      Address of ASCII string for version number
   SOR$K_REC_INP    Number of records input
   SOR$K_REC_SOR    Records sorted
   SOR$K_REC_OUT    Records output
   SOR$K_LRL_INP    Longest record length (LRL) for input
   SOR$K_LRL_INT    Internal LRL
   SOR$K_LRL_OUT    LRL for output
   SOR$K_NODES      Nodes in sort tree
   SOR$K_INI_RUNS   Initial dispersion runs
   SOR$K_MRG_       Maximum merge order
   ORDER
   SOR$K_MRG_       Number of merge passes
   PASSES
   SOR$K_WRK_ALQ    Work file allocation
   SOR$K_MBC_INP    Multiblock count for input
   SOR$K_MBC_OUT    Multiblock count for output
   SOR$K_MBF_INP    Multibuffer count for input
   SOR$K_MBF_OUT    Multibuffer count for output

   Note that performance statistics (such as direct I/O, buffered
   I/O, and elapsed and CPU times) are not available because user-
   written routines may affect those values. However, they are
   available if you call LIB$GETJPI.
 

result

   OpenVMS usage:longword_unsigned
   type:         longword (unsigned)
   access:       write only
   mechanism:    by reference
   SORT/MERGE statistic value. The result argument is the address
   of a longword into which SORT/MERGE writes the value of the
   statistic identified by the code argument.
 

context

   OpenVMS usage:context
   type:         longword (unsigned)
   access:       modify
   mechanism:    by reference
   Value that distinguishes between multiple, concurrent SORT/MERGE
   operations. The context argument is the address of a longword
   containing the context value. When your program makes its first
   call to a SORT/MERGE routine for a particular sort or merge
   operation, the context longword must equal zero. SORT/MERGE
   then stores a value in the longword to identify the operation
   just initiated. When you make subsequent routine calls for the
   same operation, you must pass the context value supplied by
   SORT/MERGE.