GETLASTERRORQQ

Portability Function: Returns the last error set by a run-time procedure.

Module

USE IFPORT

result = GETLASTERRORQQ( )

Results

The result type is INTEGER(4). The result is the most recent error code generated by a run-time procedure.

Library functions that return a logical or integer value sometimes also provide an error code that identifies the cause of errors. GETLASTERRORQQ retrieves the most recent error message. The error constants are defined in IFPORT.F90. The following table shows some library routines and the errors each routine produces:

Library routine	Errors produced
BEEPQQ	no error
BSEARCHQQ	ERR$INVAL
CHANGEDIRQQ	ERR$NOMEM, ERR$NOENT
CHANGEDRIVEQQ	ERR$INVAL, ERR$NOENT
COMMITQQ	ERR$BADF
DELDIRQQ	ERR$NOMEM, ERR$ACCES, ERR$NOENT
DELFILESQQ	ERR$NOMEM, ERR$ACCES, ERR$NOENT, ERR$INVAL
FINDFILEQQ	ERR$NOMEM, ERR$NOENT
FULLPATHQQ	ERR$NOMEM, ERR$INVAL
GETCHARQQ	no error
GETDRIVEDIRQQ	ERR$NOMEM, ERR$RANGE
GETDRIVESIZEQQ	ERR$INVAL, ERR$NOENT
GETDRIVESQQ	no error
GETENVQQ	ERR$NOMEM, ERR$NOENT
GETFILEINFOQQ	ERR$NOMEM, ERR$NOENT, ERR$INVAL
GETLASTERRORQQ	no error
GETSTRQQ	no error
MAKEDIRQQ	ERR$NOMEM, ERR$ACCES, ERR$EXIST, ERR$NOENT
PACKTIMEQQ	no error
PEEKCHARQQ	no error
RENAMEFILEQQ	ERR$NOMEM, ERR$ACCES, ERR$NOENT, ERR$XDEV
RUNQQ	ERR$NOMEM, ERR$2BIG, ERR$INVAL, ERR$NOENT, ERR$NOEXEC
SETERRORMODEQQ	no error
SETENVQQ	ERR$NOMEM, ERR$INVAL
SETFILEACCESSQQ	ERR$NOMEM, ERR$INVAL, ERR$ACCES
SETFILETIMEQQ	ERR$NOMEM, ERR$ACCES, ERR$INVAL, ERR$MFILE, ERR$NOENT
SLEEPQQ	no error
SORTQQ	ERR$INVAL
SPLITPATHQQ	ERR$NOMEM, ERR$INVAL
SYSTEMQQ	ERR$NOMEM, ERR$2BIG, ERR$NOENT, ERR$NOEXEC
UNPACKTIMEQQ	no error