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

文章目录

  • 第三章 使用$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

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

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

你可能感兴趣的:(调用操作系统命令,服务器,M,IRIS,Cache,数据库)