FETCH CHILD

父任务使用 EXEC CICS FETCH CHILD 命令来查询特定子任务的状态,并返回指定子任务的状态。

语法

FETCH CHILD

读取语法图跳过可视语法图FETCHCHILD( data-value)CHANNEL( data-area)COMPSTATUS( CVDA)ABCODE( data-area)NOSUSPENDTIMEOUT( data-value)

条件: INVREQ ,NOT成品

此命令是线程安全的。

NOHANDLERESPRESP2是常用选项,可添加到所有 EXEC CICS 命令中以处理错误条件。 命令语法图和选项说明中没有明确包含这些选项。 有关这些常用选项和 EXEC CICS 命令语法的信息,请参阅 EXEC CICS 命令格式和编程注意事项.

描述

父任务使用 EXEC CICS FETCH CHILD 来查询由子令牌标识的特定子任务的状态。 FETCH CHILD 将在子任务完成时返回。

选项

ABCODE (数据区)
如果子任务异常终止,那么返回 4 字符异常终止代码。 如果未发生异常终止,那么该变量将设置为空白。
CHANNEL (数据区)
返回由 CHILD 标识的子任务的应答通道的 16 个字符的名称。 该名称由 CICS® 生成,并且在当前链接级别的作用域内是唯一的。 如果子任务没有返回响应的通道,那么此字段将包含空白。

子通道只能访存一次,并且访存的通道将保留在作用域中,直到链接级别发生更改为止。 有关通道作用域的更多信息,请参阅 通道作用域

CHILD (data-value)
指定要从中访存响应的子令牌。 将从 RUN TRANSID 命令返回子令牌。
COMPSTATUS (cvda)
返回一个 CVDA 值,指示子任务的完成状态。 CVDA 值包括:
ABEND
子任务异常终止。
NORMAL
子任务未异常终止。
SECERROR
由于安全错误,子任务未能连接。 ABCODE 为空。
无暂挂
指定命令将立即返回,而不等待子任务完成。 如果发出此命令时已完成子任务,那么该命令将返回正常响应。
超时 (data-value)
指定全字二进制数据值,这是命令在返回之前等待请求的子代完成的最大时间 (以毫秒为单位)。 最大值为 4080000 毫秒。 如果未指定 TIMEOUT ,或者指定的值为零,那么命令不会超时。

条件

113 未完成
RESP2 值:
52
指定了 NOSUSPEND ,但子代尚未完成。
53
子代未在 TIMEOUT 选项指定的时间间隔内完成。
16 INVREQ
RESP2 值:
50
CHILD 中指定的数据不是有效的子令牌,或者子任务已由 FREE CHILD 命令释放。
51
已访存该儿童的通道。
241
TIMEOUT 值无效。