Juniper SYSTEM BASICS - CONFIGURATION GUIDE V 11.1.X User Manual

host1# macro verbose macro1.mac callAnotherMacro
host1#!Macro 'callAnotherMacro' in the file 'macro1.mac' starting execution (Id: 55)
macro macro2.mac macroName2 5 string1
!Macro 'macroName2' in the file 'macro2.mac' starting execution
!Macro 'macroName2' in the file 'macro2.mac' ending execution
host1#!Macro 'callAnotherMacro' in the file 'macro1.mac' ending execution (Id: 55)
The invoked macro cannot invoke a third macro from another file. Only a single level
of invocation is supported.
Detecting and Recording Macro Errors
You can control how a macro responds when an error occurs during execution. By
creating and adding an onError macro to your macro file, you can specify that, on
the occurrence of an error, macro execution within the current macro stops and the
onError macro is invoked. An onError macro can call other macros. If another error
occurs after the onError macro is invoked, macro execution stops again and the
onError macro is invoked again. This process continues either until the onError macro
completes or until reaching the recursion limit of 10.
Detectable Macro Errors
CLI macros detect various errors when a macro is executed. Some of these errors
are detected without the use of an onError macro; they include the following:
■ Macro file not found
■ Macro not found
■ Macro compilation error
■ Macro does not complete error due to excessive looping or recursion
The following errors are detected only when a CLI macro file contains an onError
macro:
■ Syntactic error in executed CLI command
■ Runtime error in executed CLI command
In addition to these detectable errors, you can use the following environment
commands to return textual error information to the macroData log file:
■ env.getErrorCommand
■ env.getErrorStatus
CAUTION: Though you can use the env.getErrorCommand and env.getErrorStatus
commands in any macro, the only appropriate place from which to execute these
commands is from an onError macro.
Detecting and Recording Macro Errors ■ 491
Chapter 8: Writing CLI Macros

Juniper SYSTEM BASICS - CONFIGURATION GUIDE V 11.1.X Specifications

General

Brand	Juniper
Model	SYSTEM BASICS - CONFIGURATION GUIDE V 11.1.X
Category	Software
Language	English