Automation Engine Script Guide > Ordered by Function > Error Handling and Messages > SYS_LAST_ERR_NR

SYS_LAST_ERR_NR

Script Function: Returns the number of the last error

Syntax

SYS_LAST_ERR_NR()

Return codes

Error number of the last error
"0" - No error has occurred

Comments

Some scriptA particular Automation Engine object type. elements facilitate continued script processing in the case of occurring errors when:ON_ERROR is used. The error number can then be retrieved with this script functionPre-defined run book template in the Automation Engine. One single step only, e.g. Start Windows Service, Copy file,….

Example

The example shown below intends to check the memory of a hard drive. An error occurs if this hard drive does not exist or cannot be accessed. The corresponding error number and variableIt stores or retrieves values dynamically at runtime. An individual Automation Engine object type. message part are read and the entire AE error message can be determined and sent to a userIn the Automation Engine, a user is an instance of a User object, and generally the user is a specific person who works with Automic products. The User object is assigned a user ID and then a set of access rights to various parts of the Automation Engine system and product suite. These access rights come in the form of Automation Engine authorizations and privileges, Decision user roles and EventBase rights and ARA web application object rights. You can manage all these centrally in the ECC user management functions. See also, Unified user management..

:SET &CHECK# = GET_FILESYSTEM("WIN21G", "Z:\", FILESYSTEM_SPACE_TOTAL)
:
SET &ERRNR# = SYS_LAST_ERR_NR()
:
IF &ERRNR# NE "0"
:   
SET &ERRINS#  = SYS_LAST_ERR_INS()
:   
SET &MESSAGE# = GET_MSG_TXT (&ERRNR#,&ERRINS#)
:   
SEND_MSG BU,BU, &MESSAGE#
:
ENDIF

 

See also:

Script element Description

GET_MSG_TXT

Retrieves the message text of the last error

GET_MSG_TYPE

Retrieves the type of a message number

SYS_LAST_ERR_INS

Supplies the variable message part of the last error

SYS_LAST_ERR_SYSTXT

Retrieves the last error message of the OS

Script Elements - Error Handling and Messages

Sample Collection:
Retrieving Error Message and Number

About Scripts
Script Elements - Alphabetical Listing

Script Elements - Ordered by Function

 


Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support

Copyright © 2016 Automic Software GmbH