SORT

The SORT instruction provides all of the capabilities of the SUNSORT utility. The instruction uses the following syntax:

Where:

label

Optional. A Program Execution Label.

cmd

Required. A Character String Variable or Literal containing the command string.

{ip}

Optional. A Character String Variable or Literal defining the TCP/IP address and port number of the SUNDM Data Manager where the instruction is executed.

{cancel}

Optional. A Numeric Variable, or decimal number, or a BUTTON object that identifies a user interface that cancels the processing for the instruction.

{dlist}

Optional. A DATALIST object that receives operational output for the instruction.

Flags Affected: OVER

Note the following:

1. The logical string for {cmd} is the same as the SUNSORT utility command line excluding the executable name.

2. Examples of the {ip} string are as follows:

 

127.0.0.1:3934

127.0.0.1

 

3. The OVER flag is set if the utility instruction encounters a failure. If the OVER flag is set, the S$ERROR$ variable contains the error code as defined in the PL/B Runtime Reference. If the OVER flag is cleared, the instruction executed successfully and the 'S00' data string is stored in the S$ERROR$ variable.

4. An internal Q option (-Q{logname}) allows the utility to append displayed data to a {logname} log file.

5. If TMPDIR=path is defined in the User Environment Table when the SORT instruction is executed, the specified path is used as the default path for creating the temporary files.

6. SORT searches for operational keywords using the following sequence:

    the {inifile} if the '-I{inifile}' option is specified in the {cmd} string

    the default runtime INI file

    the User Environment Table (UET)

7. Refer to the SUNSORT topic in the PL/B Utilities Reference for command line specifications.

See Also: Example Code, Utility Instructions