Emits an error message to a logger

This utility macro is designed to emit an error message to a specified logger. It validates the 'loggername' and 'message' parameters to ensure they are not empty. If the parameters are valid, it uses the SAS^© function `log4sas^©_logevent` to log the message at 'Error' level. A return code check is performed, and an error message is issued if the call to `log4sas^©_logevent` fails. This macro is part of the SASUnit framework.

Data Analysis

Type : CREATION_INTERNE

The data (loggername and message) are provided as macro parameters and do not come from external sources or SAS tables. There is no traditional data creation or reading.

1 Code Block

MACRO

Explanation :
This code block defines a SAS macro named `_issueErrorMessage` that takes two arguments: `loggername` (the logger's name) and `message` (the error message). The macro starts by validating if these two parameters are provided. If either parameter is empty, a warning is issued, and the macro terminates. If the parameters are valid, it calls the `%sysfunc(log4sas_logevent(...))` function to send the error message to the specified logger. Finally, it checks the return code of this function and displays an error message if the logging operation was unsuccessful.

Copied!

1	%macro _issueErrorMessage(loggername, message);
2	%IF (%LENGTH(&loggername.)=0) %THEN %DO;
3	%put WARNING: loggername is null;
4	%return;
5	%END;
6	%IF (%LENGTH(&message.)=0) %THEN %DO;
7	%put WARNING: message is null;
8	%return;
9	%END;
10	%let _rc = %sysfunc(log4sas_logevent(&loggername., Error, &message.));
11	%IF (&_rc ne 0) %THEN %DO;
12	%put ERROR: _rc is NOT null: &_rc.;
13	%END;
14	%mend _issueErrorMessage;

This material is provided "as is" by We Are Cas. There are no warranties, expressed or implied, as to merchantability or fitness for a particular purpose regarding the materials or code contained herein. We Are Cas is not responsible for errors in this material as it now exists or will exist, nor does We Are Cas provide technical support for it.

Copyright Info : Copyright 2010-2023 HMS Analytical Software GmbH, http://www.analytical-software.de This file is part of SASUnit, the Unit testing framework for SAS(R) programs. For copyright information and terms of usage under the GNU Lesser General Public License see included file README.md or https://github.com/HMS-Analytical-Software/SASUnit/wiki/readme/.

Retour à la liste