WEB CONVERSE
由 CICS® 作为 HTTP 客户机发送 HTTP 请求,并使用单个命令从服务器接收响应。 对于作为 HTTP 客户机的 CICS,WEB CONVERSE 可替代 WEB SEND 和 WEB RECEIVE 命令。
条件: CHANNELERR , CONTAINERERR , IOERR , INVREQ , ENGERR , NOTAUTH , NOTFND , NOTOPEN , TIMEDOUT 和 TOKENERR
此命令是线程安全的。
描述
- HTTP 客户机请求 是使用已使用 WEB OPEN 命令打开的连接进行的。 可以使用 WEB CONVERSE 命令代替 WEB SEND 命令来编写和发送请求。
- 来自服务器的响应 由 CICS Web Support 接收并传递到应用程序。 可以使用 WEB CONVERSE 命令来代替 WEB RECEIVE 命令,使应用程序等待并接收 HTTP 响应。 可以使用 WEB READ HTTPHEADER 命令或 HTTP 头浏览命令单独检查 HTTP 响应的头。注: 为启动用户应用程序的事务指定的 RTIMOUT 值指示应用程序准备等待接收入局消息的时间。 (在事务概要文件定义上指定 RTIMOUT)。 当 RTIMOUT 指定的时间段到期时, CICS 会向应用程序返回 TIMEDOUT 响应。 RTIMOUT 值为零意味着应用程序准备无限地等待下去。 事务概要文件定义上 RTIMOUT 的缺省设置为零,因此检查并更改发出 HTTP 客户机请求的应用程序的该设置很重要。
向服务器发送消息时,请求也可能超时。 在这种情况下,将应用 TRANSACTION 定义的 DTIMOUT 属性中指定的死锁超时时间间隔,并且 CICS 会向应用程序返回 TIMEDOUT 响应。
WEB CONVERSE 命令不支持对请求进行分块传输编码,因为这需要一系列发送操作,而 WEB CONVERSE 命令提供单个发送操作。 如果要发送分块消息,请使用 WEB SEND 命令发送,使用 WEB RECEIVE 命令接收。 如果服务器发送分块响应,那么可以使用 WEB CONVERSE 命令接收此响应。
在关闭与服务器的连接之后,不能使用 WEB CONVERSE 命令。 如果需要测试服务器是否已请求终止连接,请使用 WEB READ HTTPHEADER 命令在服务器的最后一条消息中查找 Connection: close 头。
WEB CONVERSE 命令执行单次发送操作和单次接收操作,它被设计用来代替 WEB SEND 命令和 WEB RECEIVE 命令。 您可以使用 WEB SEND 和 WEB RECEIVE 命令以及与相同连接 (即,具有相同 SESSTOKEN) 相关的 WEB CONVERSE 命令。 但是,如果您正在传送请求 (即,发送一系列请求而不等待响应) ,那么不得使用 WEB CONVERSE 命令跟随 WEB SEND 命令。 CICS 在程序运行时检查每个 WEB SEND 命令在发出任何 WEB CONVERSE 命令之前是否具有后续 WEB RECEIVE 命令。 例如,如果使用 WEB SEND 命令三次来发出由管道传送的请求序列,那么必须使用 WEB RECEIVE 命令三次来接收这些请求的响应,然后才能使用 WEB CONVERSE 命令。
用于发送 HTTP 客户机请求的选项
- 操作(cvda)
- 此选项用于指定应如何发送消息。 CVDA 值如下所示:
- Expect
- 使 CICS 发送 Expect 头以及请求的请求行和头,并在将消息体发送到服务器之前等待 100-Continue 响应。 如果接收到除 "100-继续" 以外的响应,那么 CICS 将通知应用程序并取消发送。 如果在等待一段时间后未收到响应,那么 CICS 仍将发送消息体。
HTTP/1.1下的服务器不支持 "期望" 头。 如果 CICS 尚不知道服务器的 HTTP 版本,那么 CICS 会在发送请求之前发出额外的请求,以确定服务器的 HTTP 版本。 如果 Expect 头不合适,那么 CICS 将在没有 Expect 头的情况下发送您的请求。
仅当您的请求有消息体时才能使用该选项。
- AUTHENTICATE(cvda)
- 此选项允许您指定用户认证详细信息 (凭证) ,以控制对受限数据的访问。 CVDA 值如下:
- NONE
- 指定访问此数据没有任何限制,因此不需要凭证。 这是 AUTHENTICATE 的缺省值。
- basicAuth
- 指定此会话需要 HTTP 基本认证凭证。 可以在命令中提供这些详细信息,也可以使用 XWBAUTH 全局用户出口提供这些详细信息。
- CHANNEL(数据值)
- 指定容器所属的通道的名称。 通道的名称最多可包含 16 个字母数字字符,包括相应的标点符号。 不允许前导空白和嵌入空白。 如果名称少于 16 个字符,那么将使用尾部空格来填充该名称。 可以指定通道名称 DFHTRANSACTION 以使用事务通道。
如果指定了 CONTAINER 选项,那么 CHANNEL 是可选的。
如果未指定 CHANNEL 选项,那么 CICS 将采用当前通道。
- CHARACTERSET(数据值)
- 指定一个字符集, CICS 在发送之前将命令发送的项的实体主体转换为该字符集。 字符集的名称最多可包含 40 个字母数字字符,包括相应的标点符号。 CICS 不支持 IANA 指定的所有字符集。 HTML 编码字符集 列出了 CICS 支持进行代码页转换的 IANA 字符集。
要允许实体主体的代码页转换,必须将 CLIENTCONV 选项设置 (或允许设置为缺省值) 为 CLICONVERT。 如果指定了 NOCLICONVERT 选项,那么将不会进行代码页转换。 如果请求转换并且未指定 CHARACTERSET ,那么将使用 ISO-8859-1 作为缺省字符集。
- CLOSESTATUS(cvda)
- 指定是否应在请求中包含带有 "close" 连接选项 (Connection: close) 的 Connection 头。 缺省值是不包含头。 CVDA 值如下:
- 关闭
- 使 CICS 写此请求的 Connection: close 头。 头通知服务器应在服务器发送其对请求的响应后关闭连接。 (对于处于 HTTP/1.0 级别的服务器, CICS 通过省略 Connection: keep-Alive 头来实现相同的效果。) 如果在 URIMAP 资源中为此连接实现了连接池,请勿指定此选项,因为无法合用已关闭的连接以供复用。 仅当这是对服务器的最终请求并且您未使用连接池时,才应指定此选项。
- 未关闭
- 表示 Connection: close 头不用于此请求。 如果服务器标识为 HTTP/1.0,那么 CICS 将发送带有 "Keep-Alive" 连接选项 (Connection: Keep-Alive) 的 Connection 头,以通知需要持久连接。
- CONTAINER(数据值)
- 指定在将 HTTP 主体发送到服务器之前保存该 HTTP 主体的容器的名称。 容器的名称最多可以包含 16 个字母数字字符,包括相应的标点符号。 不允许前导空白和嵌入空白。 如果名称短于 16 个字符,那么将使用尾部空格来填充该名称。
- DOCSTATUS(cvda)
- 指示在处理 WEB CONVERSE 命令期间是否应该删除文档。 CVDA 值如下:
- DOCDELETE
- 保存文档内容以进行发送后, CICS 会删除该文档。 将立即释放为文档分配的存储空间。 如果您对文档发出后续请求,那么这些请求将生成 TOKENERR 响应。
- NODOCDELETE
- 在处理 WEB CONVERSE 命令期间, CICS 不会删除文档。 这是 DOCSTATUS 的缺省值。
- DOCTOKEN(数据值)
- 指定要作为消息体发送的文档的 16 字节二进制令牌。 必须使用 CICS 文档接口,使用 EXEC CICS DOCUMENT CREATE, INSERT和 SET 命令创建文档。 FROM 选项提供了创建消息体的替代方法。
- FROM(数据区)
- 指定保存消息体的数据缓冲区。 消息体由应用程序构建。 指定 FROM 选项时,请使用 FROMLENGTH 选项来指定数据缓冲区的长度。 DOCTOKEN 选项提供了创建消息体的替代方法。
对于数据区的大小没有设置最大限制,但其大小在实践中受到存储注意事项的限制。 为 HTTP 消息生成实体主体 具有有关存储注意事项的更多信息。
- FROMLENGTH(数据区)
- 指定在 FROM 选项 (消息体) 上提供的数据缓冲区的长度 (作为全字二进制值)。 正确声明此值很重要,因为不正确的数据长度可能会导致消息接收方发生问题。
- MEDIATYPE(数据区)
- 指定提供的任何消息体的数据内容,例如
text/xml。 必须为 MEDIATYPE指定 56 字节区域。 介质类型最多包含 56 个字母数字字符,包括相应的标点符号,但不包括空格。 有关介质类型的更多信息,请参阅 IANA 介质类型和字符集。 CICS 会检查介质类型的格式是否正确,但不会针对数据内容检查介质类型的有效性。 CICS 使用此信息为消息生成 Content-Type 头。对于需要主体的请求,必须指定 MEDIATYPE 选项。 没有缺省值。 但是,如果所需的 Content-Type 头需要包含空格或超过 56 个字符,那么应用程序可以使用 WEB WRITE HTTPHEADER 命令来提供该头。 在这种情况下,请勿指定 MEDIATYPE 选项。
提供的介质类型用于确定在以下情况下是否需要代码页转换:- 如果要从缓冲区发送消息,请使用 FROM 选项,并且未指定 CLIENTCONV 和 CHARACTERSET 选项。
- 如果要从文档发送消息,请使用 DOCTOKEN 选项,并且未指定 CLIENTCONV 和 CHARACTERSET 选项。
- 如果要从指定的容器发送消息,请使用 CONTAINER 选项,并且指定了 CLICONVERT 或未指定 CLIENTCONV 和 CHARACTERSET 选项。
MEDIATYPE 选项用于 WEB CONVERSE 命令的发送和接收功能。 如果使用值指定该值,那么该值用于构造请求中的 Content-Type 头,而同一字段用于接收服务器返回的响应的介质类型。 如果在没有值的情况下指定它,那么它仅用于接收响应的介质类型。
- METHOD(cvda)
- 指定请求的 HTTP 方法。
此命令支持 GET , HEAD , POST , PUT , TRACE , OPTIONS 和 DELETE 方法。 但是,某些 HTTP 服务器 (尤其是 HTTP/1.0 服务器) 可能未实现所有这些方法。
为 HTTP 消息生成实体主体 具有有关正确使用方法 (包括适用于每个方法的 HTTP 版本) 的更多信息。
对于不适当的方法, CICS 会禁止发送消息体,对于适当的方法,会要求发送消息体。
CVDA 值如下:- GET
- 从服务器获取资源。 不允许请求主体。
- HEAD
- 获取资源的 HTTP 头,但不获取响应主体。 不允许请求主体。
- POST
- 将数据发送到服务器。 需要请求主体。
- PUT
- 创建或修改服务器上的资源。 需要请求主体。
- TRACE
- 跟踪请求到服务器的路径。 不允许请求主体。
- 选项
- 获取有关服务器的信息。 允许请求主体,但该主体没有定义的用途。 如果使用请求主体,那么必须指定介质类型。
- DELETE
- 删除服务器上的资源。 不允许请求主体。
- PASSWORD(数据值)
- 指定与允许访问此数据的用户标识或登录名相关联的密码。 仅当使用 USERNAME 选项时, PASSWORD 选项才是必需的。 如果指定的密码超过 8 个字符长,那么在将其发送到 z/OS® 系统时,会将其视为密码短语。
- PASSWORDLEN(数据值)
- 将为 PASSWORD 选项提供的缓冲区长度指定为全字二进制变量。
- PATH(数据区)
- 指定应用程序需要访问的服务器中特定资源的路径信息。
如果 URIMAP 选项用于在 WEB OPEN 命令上为此连接指定现有 URIMAP 定义,那么该 URIMAP 定义中指定的路径是 WEB SEND 命令的缺省路径。 在这些情况下,如果未在 WEB SEND 命令上指定路径信息,那么将使用来自 URIMAP 定义的路径。 如果指定的路径与 URIMAP 定义中给出的路径不同,那么这将覆盖 URIMAP 定义中的路径。
如果未在 WEB OPEN 命令上使用 URIMAP 选项,那么没有缺省路径,您必须提供路径信息。 可以使用 WEB PARSE URL 命令从已知 URL 中抽取路径信息。
作为使用 PATH 选项提供路径信息的替代方法,您可以使用 WEB CONVERSE 命令上的 URIMAP 选项来指定直接获取路径信息的 URIMAP 定义。
- PATHLENGTH(数据值)
- 指定路径的长度,作为全字二进制值。 如果使用 PATH 选项提供路径信息,那么需要指定 PATHLENGTH 选项。 如果使用 WEB PARSE URL 命令来解析 URL ,那么将返回路径长度信息。
- QUERYSTRING(数据区)
- 指定要作为请求的一部分提供给服务器的查询字符串。 您不需要在查询字符串开头包含问号 (?); 如果不包含该问号,那么 CICS 会在构造请求时自动为您提供该问号。 如果在查询字符串中包含转义字符,那么 CICS 会将其以转义格式传递到服务器。
- QUERYSTRLEN(数据值)
- 指定 QUERYSTRING 选项上提供的查询字符串的长度,作为全字二进制值。
- SESSTOKEN(数据值)
- 指定会话令牌,这是一个 8 字节的二进制值,用于唯一地标识 CICS 与服务器之间的此连接。 此值由作为 HTTP 客户机的 CICS 的 WEB OPEN 命令返回。 会话令牌 说明如何使用会话令牌。
- URIMAP(数据值)
- 指定 URIMAP 定义的名称 (最多 8 个字符,大小写混合) ,该定义提供应用程序需要访问的服务器中特定资源的路径信息。 URIMAP 定义必须用于作为 HTTP 客户机的 CICS (指定了 USAGE (CLIENT))。 其 HOST 属性必须与此连接的 WEB OPEN 命令上指定的 URIMAP 定义的 HOST 属性相同,或者与此连接的 WEB OPEN 命令上的 HOST 选项中指定的主机名相同。 在 WEB CONVERSE 命令上指定的 URIMAP 定义仅适用于此请求。
如果指定了 URIMAP 选项,请勿指定 PATH 或 PATHLENGTH 选项。
- USERNAME(数据值)
- 指定允许访问此数据的用户标识或登录名。 如果指定了 USERNAME ,那么还需要使用 PASSWORD 选项。
- USERNAMELEN(数据值)
- 将为 USERNAME 选项提供的缓冲区长度指定为全字二进制变量。
用于接收服务器响应的选项
- BODYCHARSET(数据区)
- 指定 HTTP 响应主体的字符集。
- INTO(数据区)
- 指定要包含正在接收的数据的缓冲区。
- MAXLENGTH(数据值)
- 指定 CICS 要传递给应用程序的最大数据量 (作为全字二进制值)。 MAXLENGTH 选项适用于是否指定了 INTO 或 SET 选项来接收数据。 如果数据是使用分块的传输编码发送的,那么 CICS 在将块传递到应用程序之前会将其组合到单个消息中,因此 MAXLENGTH 选项适用于分块的消息的总长度,而不是每个单独的块。 在进行任何代码页转换后测量数据。
如果数据长度超过指定的值,并且未指定 NOTRUNCATE 选项,那么数据将截断为该值,并且将废弃其余数据。
如果数据长度超过指定的值并且指定了 NOTRUNCATE 选项,那么 CICS 将保留其余数据并可以使用它来满足后续 RECEIVE 命令。
- MEDIATYPE(数据区)
- 指定 56 个字符的数据区以接收主体的介质类型 (即,数据内容类型) ,例如
text/xml。 有关媒体类型的更多信息,请参阅 IANA 媒体类型和字符集 。MEDIATYPE 选项用于 WEB CONVERSE 命令的发送和接收功能。 如果使用值指定该值,那么该值用于构造请求中的 Content-Type 头,而同一字段用于接收服务器返回的响应的介质类型。 如果在没有值的情况下指定它,那么它仅用于接收响应的介质类型。
- NOTRUNCATE
- 指定当可用数据超过 MAXLENGTH 选项上请求的长度时,不会立即废弃其余数据,而是保留这些数据以供后续 RECEIVE 命令检索。 (如果未发出进一步的 RECEIVE 命令,那么在事务终止期间将废弃数据。)
使用 SET 选项且不使用 MAXLENGTH 选项的单个 RECEIVE 命令接收所有剩余数据,无论其长度如何。 或者,您也可以使用一连串 RECEIVE 命令(带 NOTRUNCATE 选项)接收相应块中的剩余数据。 继续发出 RECEIVE 命令,直到您不再获取 LENGERR 响应为止。 请记住,如果接收到的长度小于 MAXLENGTH 选项上请求的长度,那么这不一定表示数据结束; 如果 CICS 需要避免在数据结束时返回部分字符,那么可能会发生此情况。
- SET(ptr-ref)
- 指定要设置为所接收数据的地址的指针引用。 指针引用有效,直到使用同一会话令牌发出的下一个 RECEIVE 命令或任务结束为止。
- STATUSCODE(数据区)
- 指定数据区以接收服务器发送的 HTTP 状态码。 代码是二进制半字值。 示例为 200 (正常) 或 404 (未找到)。 接收状态码是可选的,但在以下情况下,您应该始终接收并检查状态码:
- 如果您打算现在或者在将来连接时向服务器发送相同的请求。
- 如果您打算使用该连接向服务器发送更多请求。
- 如果您的应用程序正在执行任何进一步的处理,而该处理取决于响应中接收的信息。
CICS Web Support 的 HTTP 状态码参考 提供了有关应用程序在响应 HTTP/1.1的状态码时要执行的相应操作的基本指导。
- STATUSLEN(数据值)
- 以全字二进制值的形式指定接收服务器返回的任何文本以描述状态码的数据区的长度 (STATUSTEXT 选项)。 该文本称为原因短语。 建议用于 HTTP 的大多数原因短语都很短,但此处建议的数据区长度为 256 个字符,以防服务器将建议的原因短语替换为更详细的信息。
- STATUSTEXT(数据区)
- 指定数据区以接收服务器返回的用于描述状态码的任何文本。 该文本称为原因短语。 例如, "OK" (随附 200 状态码) 或 "Bad Request" (随附 400 状态码)。 STATUSLEN 选项给出文本允许的长度。
- TOCHANNEL(数据值)
- 指定容器所属的通道的名称。 通道的名称最多可包含 16 个字母数字字符,包括相应的标点符号。 The acceptable characters are A-Z a-z 0-9 $ @ # / % & ? ! : | " = , ; < > . - and _. Leading and embedded blanks are not permitted. 如果名称少于 16 个字符,那么将使用尾部空格来填充该名称。 如果通道不存在,那么将创建该通道。 此新通道将保留在作用域中,直到链接级别发生更改为止。 有关通道作用域的更多信息,请参阅 通道作用域。
If you plan to ship your channels between CICS regions, bear in mind that you should restrict your characters to standard alphanumeric characters (A-Z 0-9 & : = , ; <>. - _) to ensure they are represented in the same way by all EBCDIC code pages.
可以指定通道名称 DFHTRANSACTION 以使用事务通道。 当链路级别发生更改时,事务通道不会超出作用域: 在事务中始终可访问该通道。 有关更多信息,请参阅 通道和容器。
如果未指定 TOCHANNEL 选项,那么 CICS 将采用当前通道。
- TOCONTAINER(数据值)
- 指定放置数据的容器的名称。 容器的名称最多可以包含 16 个字母数字字符,包括相应的标点符号。 The acceptable characters are A-Z a-z 0-9 $ @ # / % & ? ! : | " = , ; < > . - and _. Leading and embedded blanks are not permitted. 如果名称少于 16 个字符,那么将使用尾部空格填充该名称。
If you plan to ship your containers between CICS regions, bear in mind that you should restrict your characters to standard alphanumeric characters (A-Z 0-9 & : = , ; <>. - _) to ensure they are represented in the same way by all EBCDIC code pages.
请勿使用以 "DFH" 开头的容器名称,除非 CICS请求这样做。
- TOL型长度(数据区)
- 指定设置为 CICS 返回到应用程序的数据量的全字二进制变量。 请注意,这可能略小于您使用 MAXLENGTH 选项设置的限制,尤其是在涉及双字节或多字节字符集时,因为 CICS 不会在数据末尾返回部分字符。
- 如果未指定 NOTRUNCATE 选项,那么将废弃消息中存在的任何其他数据。 如果存在更多数据,那么将返回 RESP2 值为 57 的 LENGERR 响应。
- 如果指定了 NOTRUNCATE 选项,那么将保留任何其他数据。 如果有其他可用数据,那么将返回 RESP2 值为 36 的 LENGERR 响应。 NOTRUNCATE 选项的描述告诉您在这种情况下要执行的操作。
如果您正在使用 TOCONTAINER 选项,请不要指定TOL思选项。
用于转换已发送和已接收项的选项
- CLIENTCONV(cvda)
- 指定 CICS 在发送之前是否转换 HTTP 请求的实体主体,并转换服务器响应的实体主体。 缺省值是在发出请求时和接收响应时都转换实体主体 (CLICONVERT)。
如果要将数据接收到指定的容器 (由 TOCONTAINER 选项指定) 中,那么不会进行转换。
- 对于请求主体,可以在此命令上使用 CHARACTERSET 选项来指定适合服务器的字符集。 如果请求转换 (或作为缺省值发生) 但未指定字符集,那么缺省情况是 CICS 将实体主体转换为 ISO-8859-1 字符集。
- 对于响应主体,您不需要指定服务器使用的字符集。 CICS 通过检查消息的 Content-Type 头来识别此消息。 如果头未提供此信息,或者 CICS 不支持指定的字符集进行代码页转换,那么将使用 ISO-8859-1 字符集。
- 对于应用程序的代码页,将使用本地 CICS 区域的缺省代码页 (如 LOCALCCSID 系统初始化参数中所指定) 或您在 WEB OPEN COMMAND 上指定的备用 EBCDIC 代码页。
- 陈词滥调
- CICS 将请求的实体主体转换为您为服务器标识的字符集,并将响应的实体主体转换为适合应用程序的代码页。
如果指定了 TOCONTAINER 选项,那么在接收到 HTTP 响应时不会进行转换。 相反, HTTP 响应头的介质类型确定 HTTP 主体是存储在 BIT 还是 CHAR 容器中。 如果介质类型是文本介质类型,那么主体将存储在 CHAR 容器中。 如果介质类型是非文本介质类型,那么主体将存储在 BIT 容器中。 如果 HTTP 响应不包含媒体类型信息,那么将采用文本媒体类型的缺省值。
- 无转换
- CICS 将请求的实体主体转换为您为服务器标识的字符集。 但是, CICS 不会转换响应的实体主体,它将以服务器使用的字符集传递到应用程序。
如果指定了 TOCONTAINER 选项,那么在接收到 HTTP 响应时不会进行转换。 相反, HTTP 响应头的介质类型确定 HTTP 主体是存储在 BIT 还是 CHAR 容器中。 如果介质类型是文本介质类型,那么主体将存储在 CHAR 容器中。 如果介质类型是非文本介质类型,那么主体将存储在 BIT 容器中。 如果 HTTP 响应不包含媒体类型信息,那么将采用文本媒体类型的缺省值。
- NOOUTCONVERT
- CICS 不会转换请求的实体主体,而是以应用程序使用的代码页将其发送到服务器。 但是, CICS 会将响应的实体主体转换为适合应用程序的代码页。
如果指定了 TOCONTAINER 选项,那么在接收到 HTTP 响应时不会进行转换。 相反, HTTP 响应头的介质类型确定 HTTP 主体是存储在 BIT 还是 CHAR 容器中。 如果介质类型是文本介质类型,那么主体将存储在 CHAR 容器中。 如果介质类型是非文本介质类型,那么主体将存储在 BIT 容器中。 如果 HTTP 响应不包含媒体类型信息,那么将采用文本媒体类型的缺省值。
- NOCLICONVERT
- CICS 不会转换请求的实体主体,而是以应用程序使用的代码页将其发送到服务器。 CICS 不会转换响应的实体主体,它将以服务器使用的字符集传递到应用程序。
如果指定了 TOCONTAINER 选项,那么在接收到 HTTP 响应时不会进行转换。 相反, HTTP 响应头的介质类型确定 HTTP 主体是存储在 BIT 还是 CHAR 容器中。 如果介质类型是文本介质类型,那么主体将存储在 CHAR 容器中。 如果介质类型是非文本介质类型,那么主体将存储在 BIT 容器中。 如果 HTTP 响应不包含媒体类型信息,那么将采用文本媒体类型的缺省值。
条件
- 122 CHANNELERR
- RESP2 值有:
- 1
- TOCHANNEL 选项指定的名称包含非法字符或字符组合。
- 2
- 找不到在 CHANNEL 选项上指定的通道。
- 110 CONTAINERERR
- RESP2 值有:
- 1
- TOCONTAINER 选项指定的名称包含非法字符或字符组合。
- 2
- 找不到 CONTAINER 选项指定的容器。
- 19 NOTOPEN
- RESP2 值有:
- 27
- 无效的会话令牌。
- 16 INVREQ
- RESP2 值有:
- 10
- 响应头无效。
- 11
- 操作码无效。
- 13
- 关闭状态无效。
- 15
- 代码页转换失败。
- 17 日
- Expect-100 请求已被服务器拒绝。
- 22
- 区块大小无效。
- 32
- 介质类型无效。
- 33
- 方法不支持主体。
- 34
- 方法需要一个主体。
- 41
- 连接已关闭。
- 43
- 指定的 DOCSTATUS 值无效。
- 45
- 指定的字符集无效。
- 46
- CLIENTCONV 选项无效。
- 49
- 路径选项的格式无效。
- 54
- HTTP 方法无效。
- 63
- URIMAP 对象已禁用。
- 64
- URIMAP 定义中的主机与打开此会话时指定的主机不匹配。
- 67
- 响应的内容不符合 HTTP 格式。 生成此错误是因为存在语法问题。
- 74
- 连接已关闭 (CICS 向服务器发送了 Connection: close 头,或者服务器可能由于此连接上的不活动而超时)。
- 76
- 需要 MEDIATYPE 选项。
- 79
- 管道正在进行中。 不能使用 WEB CONVERSE 命令。
- 80
- 不能将 CHARACTERSET 与 NOSRVCONVERT 一起指定。
- 142
- AUTHENTICATE 无效。 CVDA 不是 NONE 或 BASICAUTH。
- 144
- 一个或多个 Web 命令参数无效。
- 145
- 未将 CHANNEL 与 CONTAINER 一起指定,或未将 TOCHANNEL 与 TOCONTAINER 一起指定 (并且没有当前通道)。
- 146
- 指定的容器是只读容器。
- 147
- 内部转换错误。
- 150
- 已请求转换,但要发送的数据位于 DATATYPE BIT 容器中。
- 157
- 响应中的 HTTP 头比 4k长, CICS 无法处理此 HTTP 响应。 会话不可用,需要 WEB CLOSE 命令。
- 22 LENGERR
- RESP2 值有:
- 5
- PATHLENGTH 选项值不大于零。
- 8
- QUERYSTRLEN 选项值不大于零。
- 16
- MAXLENGTH 无效。
- 36
- 返回了部分响应主体。 使用其他 RECEIVE 来获取剩余部分。
- 50
- FROMLENGTH 选项值不大于零。
- 57
- 响应主体超过指定的长度,该主体的其余部分已被废弃。
- 58
- 状态文本超出指定的长度。
- 59
- STATUSLEN 选项值不大于零。
- 139
- USERNAMELEN 不是正数。
- 140
- PASSWORDLEN 不是正数。
- 13 NOTFND
- RESP2 值有:
- 61
- 未找到指定的 URIMAP 对象。
- 112 托克内尔
- RESP2 值有:
- 47
- 指定的文档令牌无效或文档已删除。
- 17 IOERR
- RESP2 值有:
- 42
- 套接字错误。
- 124 TIMEDOUT
- RESP2 值有:
- 62
- 接收套接字时出现超时。
- 156
- 套接字发送时超时。
- 70 NOTAUTH
- RESP2 值有:
- 100
- 由安全出口禁止的路径。
- 110
- XWBAUTH 错误。 XWBAUTH 全局用户出口已发出 UERCERR 返回码,因为 XWBAUTH 出口是必需的,但无法返回有效响应。
