$ZF Callout
快速参考$ZF()
函数提供了一组由一个或两个数字参数标识的从属函数(例如,$ZF(-100)
从属函数运行外部程序或系统命令,$ZF(-4,1)
从属函数加载Callout library
)。以下列表仅显示了标识特定$ZF()
从属函数的参数。这些函数中的大多数还带有附加参数,如每个函数的详细条目中所述。
详细的功能描述按以下标题组织:
$ZF(-100)
:运行程序或系统命令
$ZF(-100)
-执行程序或系统命令。$ZF()
:调用iriszf
库
$ZF()
(无从属函数参数)-从位于当前实例的bin
目录中名为iriszf
的自定义标注库中调用函数。$ZF(-3)
: Call by Name
$ZF(-3)
-加载Callout library
并调用库函数。$ZF(-5)
:通过系统ID调用
$ZF(-5)
-从由系统定义的ID
号引用的Callout library
中调用函数。
$ZF(-4,1)
-加载由名称指定的标注库,并返回其ID
号。$ZF(-4,2)
-卸载由ID号指定的详图索引库,或卸载所有库。$ZF(-4,3)
-返回指定库中函数的ID号。$ZF(-6)
:按用户索引调用
$ZF(-6)
-从由用户指定的索引号引用的Callout library
中调用函数。
$ZF(-4,4)
-卸载由索引号指定的Callout library
。$ZF(-4,5)
-在标注系统索引表中创建一个条目$ZF(-4,6)
-删除标注系统索引表中的条目$ZF(-4,7)
-在标注过程索引表中创建一个条目$ZF(-4,8)
-删除标注过程索引表中的条目$ZF(-100)
:运行程序或系统命令$ZF(-100)
函数用于运行外部程序或系统命令,或者启动操作系统外壳。这是唯一一个可以在没有标注库的情况下使用的$ZF函数。
$ZF(-100)
执行程序或操作系统命令。
$ZF(-100, keyword_flags, program, arguments )
参数:
keyword_flags
—(可选)由/keyword
形式的标志序列组成的字符串表达式。关键字可以是大写或小写,标志之间允许有空格。I/O
重定向关键字后跟一个运算符和一个路径字符串(/keyword=path
或/keyword+=path
)。program
—指定要执行的程序。它可以是完整路径,也可以只是一个名称,在这种情况下,将遵循通常的操作系统搜索路径规则。arguments
—(可选)逗号分隔的程序参数列表。也可以用arg
指定可变数量的参数…语法。返回:
-1
—出现操作系统错误,详细信息记录在SYSLOG
中。0
—如果指定了/ASYNCH
,表示程序已成功启动。status
—如果未指定/ASYNCH
,则status
是程序结束时返回的退出代码(0
或正数)。指定关键字
以下关键字控制程序执行和日志记录:
/SHELL
-指示应该在操作系统/SHELL
中调用程序。默认情况下不使用shell
。/ASYNC
—指示程序应该异步运行,允许$ZF(-100)
调用不等待它完成就返回。/LOGCMD
-使程序命令行记录在messages.log
中。这是一个调试工具,提供了一种查看程序收到的参数的方式。下列关键字和文件说明符控制I/O
重定向:
/STDIN=input-file
/STDOUT=output-file or /STDOUT+=output-file
/STDERR=error-file or /STDERR+=error-file
I/O
重定向关键字后跟一个运算符(=
或+=
)和一个文件名或文件路径。运算符周围允许有空格。标准输入应该指向一个现有的文件。如果标准输出和标准错误文件不存在,则会创建它们,如果它们已经存在,则会被截断。使用=
运算符创建或截断文件,或使用+=
运算符追加到现有文件。要使标准错误和标准输出转到同一个文件,请为两个关键字指定同一个文件。