11.04.2013 Views

UniBasic Commands Reference - Rocket Software

UniBasic Commands Reference - Rocket Software

UniBasic Commands Reference - Rocket Software

SHOW MORE
SHOW LESS

Create successful ePaper yourself

Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.

PCPERFORM<br />

Syntax<br />

PCPERFORM str.expr [CAPTURING, dyn.array.var]<br />

Description<br />

The <strong>UniBasic</strong> PCPERFORM command executes an operating system command<br />

from within a <strong>UniBasic</strong> program.<br />

PCPERFORM is similar to the EXECUTE and PERFORM commands except that<br />

PCPERFORM executes an operating system command.<br />

If PCPERFORM is successful, UniData sets @SYSTEM.RETURN.CODE to 0. If<br />

unsuccessful, UniData sets @SYSTEM.RETURN.CODE to -1.<br />

Note: The settings of UDT.OPTIONS affect the way ECL commands execute. For<br />

information about these options, see the UDT.OPTIONS <strong>Commands</strong> <strong>Reference</strong>. For<br />

information about UDT.OPTIONS that could affect that command, see the<br />

appropriate ECL command in UniData <strong>Commands</strong> <strong>Reference</strong>.<br />

Parameters<br />

The following table describes each parameter of the syntax.<br />

Parameter Description<br />

1-567 <strong>UniBasic</strong> <strong>Commands</strong> <strong>Reference</strong><br />

str.expr Specifies a string to execute as a host operating system command.<br />

CAPTURING,<br />

dyn.array.var<br />

Specifies a target dynamic array to capture the output of the host<br />

operating system command.<br />

PCPERFORM Parameters

Hooray! Your file is uploaded and ready to be published.

Saved successfully!

Ooh no, something went wrong!