Configuring the System Command node
-
On the General tab, specify this information:
- Name
-
The internal name for the node.
- Execution mode
- Command
-
The command to execute within the context specified by the execution mode.
To enable the System Command node to call Landmark commands, a shell script must be called first to set the required Landmark environment variables. On Unix, the shell script is called enter.sh. On Windows, the shell script is called enter.cmd. The following examples show how Landmark commands can be called using the System Command node:
Unix
cd <!ENVDIR> && ../enter.sh && <Landmark command>
Example of calling the Landmark command "listprod" in Unix:
cd <!ENVDIR> && ../enter.sh && listprod -ad
Windows
cd <!ENVDIR> && ..\enter.cmd && <Landmark command>
Example of calling the Landmark command "listprod" in Windows:
cd <!ENVDIR> && ..\enter.cmd && listprod -ad
- Command input
-
Specifies any text to send to the command’s standard input stream. (You could think of this as directing some keyboard input to the command.) This is usually left blank.
- Error on error output
-
When this option is selected, an error will be flagged if the command directs and output to the standard error output. This may be used to detect an error, in cases where the command incorrectly returns an error code of 0 even when an error actually occurs.
- Combine error output into standard output
-
When this option is selected, standard error output from the command is directed to the NODENAME_outputData variable along with regular standard output. When this option is not checked (the default), only regular standard output is directed to the NODENAME_outputData variable. Standard error output from the command is always directed separately to the NODENAME_errorOutput variable.
-
On the On Error tab, specify this information:
- What should happen on an error?
-
Select from the available options.
Specifies whether the flow should be terminated if a command error is detected. An error is detected if the system command returns a non-zero return code. If the Interpret error output as command error option is selected, an error is also detected if the command outputs anything to the standard error output stream.
- Notify
-
Select the check box if you want to send a notification when an error occurs. If this option is selected, you must fill out the notification details.
- Custom log entry
-
Select the check box if you want a custom log entry in addition to the system-generated log entry.