第三章 使用$ZF(-100)运行程序或系统命令

第三章 使用$ZF(-100)运行程序或系统命令

$ZF(-100)函数允许 IRIS 进程调用可执行程序或主机操作系统的命令。这是唯一可以在没有特殊的Callout共享库的情况下使用的$ZF函数。

• $ZF(-100)的语法和功能概述。
• 程序执行-程序可以选择异步运行或在操作系统外壳中运行。
• 记录命令和重定向输出——可选设置可以记录命令或重定向I/O。
• 添加%System_Callout:USE特权—使用$ZF(-100)需要此特权。

注意:$ZF(-100)取代了已弃用的函数$ZF(-1)和$ZF(-2)，在所有情况下都应优先使用。

介绍

$ZF(-100)提供类似于命令行接口的功能，允许调用可执行程序或主机操作系统的命令。这个函数的语法是:

status = $ZF(-100, keywords, command, arguments )

第一个参数必须是字面量-100。其他三个参数指定以下信息:

• Keywords - 包含指定各种选项的关键字的字符串。例如，字符串"/ASYNC/LOGCMD"指定程序应该异步运行，并将命令行写入日志文件。
• Command - 指定要调用的程序或系统命令的字符串。如果未指定可执行文件的完整路径，则操作系统将应用标准搜索路径规则。
• 参数 - 命令参数被指定为一系列以逗号分隔的表达式(如下面的示例所示)。

$ZF(-100)函数返回由操作系统和被调用的程序确定的退出状态码。

下面的示例将三个字符串传递给echo命令，然后显示状态码。这个例子没有使用关键字，所以关键字参数是一个空字符串。最后一个命令参数指定一个带引号的字符串(遵循标准的ObjectScript字符串规则):

USER>set status = $ZF(-100,"","echo","hello","world","""goodbye now""")
hello world "goodbye now"

USER>w status                                                          
0

程序执行

$ZF(-100)允许以同步或异步方式运行程序或命令，调用或不调用操作系统shell。默认情况下，同步执行而不调shell。可以通过在函数调用中指定可选关键字来覆盖默认执行。

以下关键字可用于控制程序的执行:

• /ASYNC -指示程序应该异步运行，允许$ZF(-100)调用返回，而无需等待程序完成。
• /SHELL -指示程序应该在操作系统SHELL中运行。

如上一节所述，如果不想使用这两个选项中的任何一个，可以为关键字参数指定一个空字符串。这个例子故意尝试列出不存在的文件，这样就会生成错误码1:

注：$ZF(-100)在Linux中可用。

USER>set status = $ZF(-100,"", "ls","*.scala")
ls: cannot access *.scala: No such file or directory

USER>write status
1

如果我们异步运行相同的命令，则不会显示输出并且status为undefined，因为没有返回错误代码:

USER>kill status
USER>set status = $ZF(-100,"/ASYNC", "ls","*.scala")
USER>write status
WRITE status
^
<UNDEFINED> *status
``