Configuring the System Command node

  1. On the General tab, specify this information:
    Name

    The internal name for the node.

    Execution mode

    See Execution mode details.

    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.

  2. 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.