runmode
Alter the scheduler’s behaviour at higher scoping level
Due to dynamic nature in which blocks are compiled on demand, traditional try
and trypipe
blocks cannot affect the runtime behaviour of schedulers already invoked (eg for function blocks and modules which try
et al would sit inside). To solve this we need an additional command that is executed by the compiler prior to the block being executed which can define the runmode of the scheduler. This is the purpose of runmode
.
The caveat of being a compiler command rather than a builtin is that runmode
needs be the first command in a block.
runmode try|trypipe function|module
function hello {
# Short conversation, exit on error
runmode try function
read name "What is your name? "
out "Hello $name, pleased to meet you"
read mood "How are you feeling? "
out "I'm feeling $mood too"
}
runmode
’s parameters are ordered:
Always return a zero exit number.
Checks only the last command in the pipeline for errors. However still allows commands in a pipeline to run in parallel.
Checks every command in the pipeline before executing the next. However this blocks pipelines from running every command in parallel.
Checks last command in the pipeline for errors (still allowing commands to run in parallel) plus also checks if stderr contains excessive output.
Checks every command in the pipeline before executing the next (blocking commands from running in parallel) plus also checks if stderr contains excessive output.
Sets the runmode for all blocks within the function when runmode
is placed at the start of the function. This includes privates, autocompletes, events, etc.
Sets the runmode for all blocks within that module when placed at the start of the module. This include any functions, privates, autocompletes, events, etc that are inside that module. They do not need a separate runmode ... function
if runmode ... module
is set.
autocomplete
: Set definitions for tab-completion in the command linecatch
: Handles the exception code raised by try
or trypipe
event
: Event driven programming for shell scriptsfid-list
: Lists all running functions within the current Murex sessionfunction
: Define a function blockout
: Print a string to the stdout with a trailing new line characterprivate
: Define a private function blockread
: read
a line of input from the user and store as a variabletry
: Handles non-zero exits inside a block of codetryerr
: Handles errors inside a block of codetrypipe
: Checks for non-zero exits of each function in a pipelinetrypipeerr
: Checks state of each function in a pipeline and exits block on errorunsafe
: Execute a block of code, always returning a zero exit numberThis document was generated from builtins/core/structs/try_doc.yaml.
This site's content is rebuilt automatically from murex's source code after each merge to the master
branch. Downloadable murex binaries are also built with the website.
Last built on Thu Aug 15 14:38:34 UTC 2024 against commit 50ed9d650ed9d6df391240d3c2c02e623636e508dfcdad1.
Current version is 6.2.4000 which has been verified against tests cases.