嵌入式模板命令

CICS 文档处理程序可识别可嵌入在文档模板中的三个命令。 支持的三个命令是 #set, #echo 和 #include。

嵌入式模板命令的语法

嵌入式模板命令遵循 "服务器端包含" 命令的语法规则。 "服务器端包含" 命令以字符左角括号,感叹号,连字符,连字符,数字符号 (散列) 开头,后跟该命令。 它以字符连字符,连字符,直角支架终止。 例如:
<!--#command-->

用于启动和结束 "服务器端包含" 的字符必须在代码页 037 中,否则将忽略该命令。 这些字符序列的十六进制等效项为 X'4C5A60607B'和 X'60606E'。

#echo 命令

#echo 命令标识在将模板插入文档时必须替换的符号。 例如,此 #echo 命令标识要在命令位置替换到文档中的符号 ASYM:
This is the <!--#echo var=ASYM--> symbol.

使用模板时,包含 #echo 命令的字符串将完全替换为为符号定义的值。 如果未随该名称提供符号定义,那么 #echo 命令将保留在输出数据中。 符号的值可以由应用程序定义,也可以由模板中的 #set 命令定义为缺省值。

#set 命令

#set 命令用于设置符号的值。 它对于设置符号的缺省值很有用。 例如,此 #set 命令指定符号 ASYM 的缺省值 "first":
<!--#set var=ASYM value='first'-->

#set 命令可以覆盖另一个 #set 命令。 如果在同一符号名称的模板中包含多个 #set 命令,那么将使用最后一个命令。

如果已使用 DOCUMENT SET 命令为模板中的 #set 命令应用的符号提供了值,那么将忽略该命令。 使用 DOCUMENT SET 命令指定了值的符号只能通过发出另一个 DOCUMENT SET 命令来更改。

The #set command can be used in combination with the #echo command, or it can apply to a symbol reference that has been specified by preceding the symbol name with an ampersand (&) and terminating it with a semicolon (;).

#include 命令

#include 命令允许将模板嵌入到另一个模板中。 最多允许 32 个级别的嵌入。

例如:

<!--#include template=
templatename-->
templatename 是在 DOCTEMPLATE 资源定义中定义的模板的名称 (48 字节名称)。 模板名称也可以用双引号括起。