CREATE DOCTEMPLATE

定义一个文档模板。

CREATE DOCTEMPLATE

读取语法图跳过可视语法图CREATE DOCTEMPLATE( data-value) ATTRIBUTES( data-value)ATTRLEN( data-value)LOGNOLOGLOGMESSAGE( CVDA)
CREATE DOCTEMPLATE 属性值
读取语法图跳过可视语法图DESCRIPTION( char58)APPENDCRLF(YES)APPENDCRLF(NO)FILE( char8)TSQUEUE( char16)TDQUEUE( char4)PROGRAM( char8)EXITPGM( char8)MEMBERNAME( char8)DDNAME(DFHHTML)DDNAME( char8)HFSFILE( char255)TEMPLATENAME( char48)

条件: INVREQ , LENGERR 和 NOTAUTH

COBOL 程序员注意事项: 在上述语法中,必须使用 ATTRIBUTES(data-area) 而不是 ATTRIBUTES(data-value)

描述

CREATE DOCTEMPLATE 命令使用命令中指定的属性来安装 DOCTEMPLATE 定义。 它不使用存储在 CSD 中的资源定义。 如果已存在具有您在本地 CICS® 区域中指定的名称的文档模板,那么新定义将替换旧定义; 否则,将添加新定义。

同步点在 CREATE DOCTEMPLATE 处理中是隐式的,除非在处理命令的早期检测到异常条件。 如果 CREATE 成功执行,那么将落实对该任务中的可恢复资源所作的未落实的更改,如果未成功执行,那么将回滚。 有关管理 CREATE 命令的其他常规规则,请参阅 创建资源定义

选项

ATTRIBUTES (data-value)
指定要添加的 DOCTEMPLATE 的属性。 必须使用 DOCTEMPLATE 属性中显示的语法将属性列表编码为单个字符串。 请参阅 ATTRIBUTES 选项 以获取有关指定属性的常规规则,并参阅 DOCTEMPLATE 属性 以获取有关特定属性的详细信息。
ATTRLEN (data-value)
以半字二进制值的形式指定 ATTRIBUTES 选项中提供的字符串的长度 (以字节为单位)。 长度不得超过 32 767 字节。
DOCTEMPLATE (data-value)
指定要添加到 CICS 区域的 DOCTEMPLATE 定义的 8 字符名称。
LOGMESSAGE(cvda)
指定 CICS 是否记录用于所创建资源的属性。 CVDA 值如下:
日志
资源属性将记录到 CSDL 瞬时数据队列中。
NOLOG
未记录资源属性。

条件

INVREQ
RESP2 值:
n
ATTRIBUTES 字符串中存在语法错误,或者在处理的废弃或资源定义阶段发生错误。 有关 RESP2 值的信息,请参阅 CREATE 和 CSD 命令的 RESP2 值
7
LOGMESSAGE cvda 值无效。
200
该命令是在使用 EXECUTIONSET 值 DPLSUBSET 定义的程序中执行的,或在没有 SYNCONRETURN 选项的分布式程序链接从远程系统调用的程序中执行的。
LENGERR
RESP2 值:
1
您在 ATTRLEN 中指定的长度为负数。
NOTAUTH
RESP2 值:
100
未授权与发出任务关联的用户使用此命令。
101
与发出任务关联的用户无权创建具有此名称的 DOCTEMPLATE 资源定义。