第二十三章 $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重定向关键字后跟一个运算符(=或+=)和一个文件名或文件路径。运算符周围允许有空格。标准输入应该指向一个现有的文件。如果标准输出和标准错误文件不存在,则会创建它们,如果它们已经存在,则会被截断。使用=运算符创建或截断文件,或使用+=运算符追加到现有文件。要使标准错误和标准输出转到同一个文件,请为两个关键字指定同一个文件。