Get the formatted system error message

WTSupported in traditional Synergy on Windows
WNSupported in Synergy .NET on Windows
USupported on UNIX
VSupported on OpenVMS
text = %SYN_SYSERRTXT([error_num])

Return value


The formatted operating system error message associated with the last system error or the specified error number. (a)



(optional) The number of the system error for which you want to return message text. (n)


%SYN_SYSERRTXT looks at the last system error or the specified error number and returns the message text for that error. The number of the last system error can be returned by calling %SYSERR.

If you want the text for the last system error, %SYN_SYSERRTXT must be called immediately following the ONERROR label of the trapped error. No intervening Synergy statements should be executed, or random results may occur due to other low-level calls affecting the system error code.


    onerror openfail
    open(1, o, "cust.ddf")
    text = %syn_syserrtxt
    display(15, "ERROR: " + %string(%ernum) + " system error: " + text)