xcall

Purpose The xcall statement is used to invoke another Superx++ program from within a Superx++ program. The xcall can pass the same input stream that it has or it can pass another one or none at all to the remote Superx++ program.
Format xcall({file path}, {remote input stream});

xcall({file path}, {remote input stream}) noxout;

noxout (optional) if absent then the contents of the output stream of the remote program will be merged into the output stream of the calling program.
{file path} the path or URL of the Superx++ program to be invoked
{remote input stream} the input stream to be passed from the caller to the remote Superx++ program
Example #1 Consider that the file C:\\MyDir\\MyProg.xml contains the following code:
xpp {
   xout("\r\nIn the remote program");
}

Now consider the following caller program code snippet:
xout("In the caller");
xcall("C:\\MyDir\\MyProg.xml", "");
xout("\r\nBack in the caller");

The result is that the following text is written to the output stream of the caller program:
In the caller
In the remote program
Back in the caller

Example #2 Consider that the file C:\\MyDir\\MyProg.xml contains the following code:
xpp {
   xout("\r\nIn the remote program");
}

Now consider the following caller program code snippet:
xout("In the caller");
xcall("C:\\MyDir\\MyProg.xml", "") noxout;
xout("\r\nBack in the caller");

The result is that the following text is written to the output stream of the caller program:
In the caller
Back in the caller

The reason for the omission of the output stream contents of the remote program is that the noxout token is specified.