COBOL Manual for TNS/E Programs (H06.08+, J06.03+)

library-reference
is a mnemonic-name in the SPECIAL-NAMES paragraph. This mnemonic-name is associated
with the DLL containing an object copy of COBOL_RETURN_SORT_ERRORS_.
sd-name
is the COBOL name of a file defined in an SD entry. The specification of the remaining
parameter is applied to any subsequent SORT or MERGE statements that refer to this file name.
If a subsequent call to the same routine refers to the same sd-name, that call resets the
specifications for any subsequent SORT or MERGE statements that refer to the same file name.
error-report
is an 01 level item with this structure:
01 error-info
02 error-message-text PIC X(64).
02 error-message-length NATIVE-2.
02 error-code.
03 file-system-code NATIVE-2.
03 input-file-index NATIVE-2.
03 sort-code NATIVE-2.
02 error-source NATIVE-2.
02 subsort-index NATIVE-2.
02 subsort-id NATIVE-2
For the meaning of these fields, see the FastSort Manual discussion of SORTERRORSUM. The
input-file-index and sort-code are partial word fields in that section, but are full
word fields in the above record. If this parameter is omitted, any previously set error reporting
is cleared.
return-code
is an identifier of a numeric data item in which an error value will be returned. The expected
values and their respective meanings are:
MeaningValue
The call was correct.0
file-name does not name a sort-merge file.1
error-report is not the correct length.2
Space for the options block cannot be allocated.5
ZCOBDLL Routines 619