Tivoli 服务台 6.0 开发工具包接口设计器指南

第 9 章:CPIC 返回代码和系统常数

返回目录


简介

概述

这里以数字顺序列出了 CPIC 命令可能的返回代码。与说明一起提供的助记符不是 TSD 脚本系统定义的常数。提供它们只是作为您希望定义的任何常数的模型。

CPIC 返回代码

返回代码 说明
1 CPIC_SUCCESS。所有成功完成的 CPIC 命令均返回此值。
-1 CM_ALLOCATE_FAILURE_NO_RETRY。尝试的对话分配失败。这种情况下,可能要求用户介入以修正节点服务配置。对指定的(LU 名称,模式名称)对的当前(LU,模式)会话限制可能是 0,或可能存在系统定义错误。试图更改此对话的模式名称。
-2 CM_ALLOCATE_FAILURE_RETRY。可能由于临时出现的情况,尝试的对话分配失败。通常这是由于对话涉及的 LU 之一临时的资源缺乏造成的。应用程序自动重试此命令。
-3 CM_CONVERSATION_TYPE_MISMATCH。因为伙伴不支持对话的对话类型,因此伙伴 LU 拒绝了请求。在以后调用 CPICAllocate 时返回此代码。
-5 CM_PIP_NOT_SPECIFIED_CORRECTLY。因为远程应用程序定义了一个或多个应用程序初始化参数(PIP)变量,因此伙伴 LU 拒绝了分配请求。此调用类型必须针对非 CPIC API。
-6 CM_SECURITY_NOT_VALID。因为访问安全信息无效,因此远程 LU 拒绝了请求。此信息由本地节点服务系统提供。通常,当您设置了 CPIC 补充信息中所需的安全但尚未注册到本地节点服务时,会出现这样的返回代码。也可能是注册口令在远程机器上无效。
-7 CM_SYNC_LVL_NOT_SUPPORTED_LU。远程 LU 不支持您应用程序所请求的同步级别。CPIC 只支持同步级别 $CPICNone$CPICConfirm。它不支持同步级别 SYNC_POINT。
-8 CM_SYNC_LVL_NOT_SUPPORTED_PGM。伙伴应用程序不支持您应用程序所请求的同步级别。CPIC 只支持同步级别 $CPICNone$CPICConfirm;它不支持同步级别 SYNC_POINT。
-9 CM_TPN_NOT_RECOGNIZED。因为本地应用程序指定了远程 LU 不能识别的 TP 名称,因此远程 LU 拒绝了请求。
-10 CM_TP_NOT_AVAILABLE_NO_RETRY 因为本地应用程序指定了远程 LU 能识别但不能启动的 TP,因此远程 LU 拒绝了分配请求。要求用户进行一些干预。
-11 CM_TP_NOT_AVAILABLE_RETRY。因为本地应用程序指定了远程 LU 能识别但目前不能启动的 TP,因此远程 LU 拒绝了请求。这种情况可能是临时的。
-17 CM_DEALLOCATED_ABEND。用设置为异常终止的解除分配类型使远程应用程序解除了分配,或者由于远程应用程序异常终止而使远程 LU 解除了分配。
-18 CM_DEALLOCATED_NORMAL。远程应用程序在正常状态下解除分配了对话。
-19 CM_PARAMETER_ERROR。本地应用程序发出了带有无效参数的 CPIC 命令。请注意术语“参数”包括与对话标识关联的特性。因此,此问题可能存在于 CPIC 补充信息中的一些值中。
-20 CM_PRODUCT_SPECIFIC_ERROR。指示正在调用的应用程序(在此情况下为 Tivoli 服务台(TSD)开发工具包)检测到了错误并且不能继续对话。当在 OS/2 中启动 CPIC 应用程序之前未设置 APPCTPN 环境变量时,经常会出现这样的情况。
-21 CM_PROGRAM_ERROR_NO_TRUNC。远程应用程序在映射对话或基本对话上发出了 SendError 调用。在此操作中不截断数据。
-22 CM_PROGRAM_ERROR_PURGING。远程应用程序发出了 SendError。如果远程应用程序已处于“接收”或“确认”状态,则可能清除信息。
-23 CM_PROGRAM_ERROR_TRUNC。远程应用程序在基本对话上发出了 SendError,且此调用截断了逻辑记录。
-24 CM_PROGRAM_PARAMETER_CHECK。您的 CPIC 应用程序发出了带有无效参数信息的 CPIC 命令。这种返回代码大多是由出错 SDN(例如错误案例)或尚未初始化的对话标识造成的。这可能包括与对话标识关联的特性。在这种情况下,问题的源由本地应用程序来控制。
-25 CM_PROGRAM_STATE_CHECK。您的应用程序发出了在当前状态下无效的 CPIC 命令。例如,当您的应用程序处于“接收”状态时试图发送数据。
-26 CM_RESOURCE_FAILURE_NO_RETRY。故障使对话提早终止。这种情况不是临时的,例如,应用程序在没有外部干预时不应重试命令。
-27 CM_RESOURCE_FAILURE_RETRY。故障使对话提早终止。这种情况可能是临时的,即应用程序在没有外部干预时可以重试命令。
-28 CM_UNSUCCESSFUL。CPIC 命令未成功执行。
-30 CM_DEALLOCATED_ABEND_SVC。远程应用程序可能用 ABEND_SVC 类型解除分配了基本对话。或者是,远程应用程序异常终止且伙伴 LU 的节点服务系统以远程应用程序的名义解除分配了此对话。此调用类型必须针对非 CPIC API。
-31 CM_DEALLOCATED_ABEND_TIMER。远程应用程序用 ABEND_TIMER 类型解除分配了基本对话。此调用类型必须针对非 CPIC API。
-32 CM_SVC_ERROR_NO_TRUNC。远程应用程序发出了带 SVC 类型的 SendError,且此调用不能截断数据记录。请注意此调用类型必须针对非 CPIC API。
-33 CM_SVC_ERROR_PURGING。远程应用程序发出了带 SVC 类型的 SendError,且可能截断了数据记录。请注意此调用类型必须针对非 CPIC API。
-34 CM_SVC_ERROR_TRUNC。远程应用程序发出了带 SVC 类型的 SendError,且截断了数据记录。请注意此调用类型必须针对非 CPIC API。
-37 CM_OPERATION_NOT_ACCEPTED。在指定对话上的前一操作未完成。在多线程的应用程序中可能出现这种情况。
-100 CM_TAKE_BACKOUT。远程应用程序发出了 SAA 资源恢复回退调用。本地应用程序必须向上一个同步点发出回退调用。只有 SYNC_POINT 类型的对话才返回此代码。
-130 CM_DEALLOCATED_ABEND_BO。远程应用程序用 DEALLOCATE_ABEND 类型解除了分配,且本地应用程序必须向上一个同步点发出回退调用。只有 SYNC_POINT 类型的对话才返回此代码。
-131 CM_DEALLOCATED_ABEND_SVC_BO。远程应用程序可能用 ABEND_SVC 类型解除分配了基本对话。或者是,远程应用程序异常终止且伙伴 LU 的节点服务系统以远程应用程序的名义解除分配了此对话。此调用类型必须针对一些非 CPIC API。本地应用程序必须向上一个同步点发出回退调用。只有 SYNC_POINT 类型的对话才返回此代码。
-132 CM_DEALLOCATED_ABEND_TIMER_BO。远程应用程序用 ABEND_TIMER 类型解除分配了基本对话。只有 SYNC_POINT 类型的对话才返回此代码。此调用类型必须针对非 CPIC API。
-133 CM_RESOURCE_FAIL_NO_RETRY_BO。故障使对话提早终止。这种情况不是临时的,因此应用程序在没有外部干预时不应重试命令。本地应用程序必须向上一个同步点发出回退调用。只有 SYNC_POINT 类型的对话才返回此代码。
-134 CM_RESOURCE_FAILURE_RETRY_BO。故障使对话提早终止。这种情况可能是临时的。只有 SYNC_POINT 类型的对话才返回此代码。
-135 CM_DEALLOCATED_NORMAL_BO。远程应用程序已解除分配对话。本地应用程序必须向上一个同步点发出“回退”调用。只有 SYNC_POINT 类型的对话才返回此代码。

CPIC 系统常数

CPIC 操作返回代码

返回代码 说明
-501 CPIC_GET_CONVTYPE_FAILED。在 CPICAccept 处理期间,TSD 开发工具包查询有关入网对话的类型(是映射对话还是基本对话)。如果此操作失败,则 TSD 开发工具包不支持入网对话。
-502 CPIC_OUT_OF_MEMORY。在 CPIC 命令处理期间,内存分配失败。
-503 CPIC_SET_FILL_FAILED。在对入网基本对话的 CPICAccept 处理期间,TSD 开发工具包尝试设置填充类型为 FILL_LL。如果此操作失败,则 TSD 开发工具包不支持入网对话。
-504 CPIC_TPNAME_CONV_FAILED。将 SNA 服务 TP 名称转换为服务 TP 格式失败。
-505 CPIC_TPNAME_TOO_SHORT。CPICSetSideInfo 命令的给定 TPName 太短,不能作为有效的 SNA 服务 TP 名称。
-506 CPIC_DEFAULT_CONVTYPE_FAILED。在 CPICInitialize 处理期间,TSD 开发工具包尝试将对话类型设置为映射对话。如果此操作不起作用,则出现此返回代码。
-507 CPIC_VARLEN_FOR_BASIC。TSD 开发工具包在基本对话上的 DDF 中检测到 VAR 字段。TSD 开发工具包不支持基本对话的变量长度字段。
-508 CPIC_INVALID_CONVERSATION。传送给 CPIC 的对话标识无效。在可分配对话之前,必须将对话初始化。
-509 CPIC_INVALID_SDN。CPIC 命令中指定的 SDN 无效。
-510 CPIC_INVALID_DDF_NAME。作为 DDF 名称传送的参数无效。
-511 CPIC_INVALID_TP_NAME。作为 TP 名称传送的参数无效。此参数可能是 $Unknown
-512 CPIC_INVALID_PLU_NAME。作为 TP 名称传送的参数无效。此参数可能是 $Unknown
-513 CPIC_INVALID_PARAMETER。给 CPIC 命令传送的引用参数之一无效。此参数可能是 $Unknown
-514 CPIC_INVALID_VALUE。给 CPIC 命令传送的值参数之一无效。此参数可能是 $Unknown

字符串转换返回代码

返回代码 说明
-1501 CONV_BUFFER_LENGTH_ERROR。因为传送给 CM/2 的长度无效,TSD 开发工具包在字符串和 ASCII 码之间进行的转换失败。
-1502 CONV_COMM_SUBSYSTEM_NOT_LOADED。因为未装入节点服务子系统(CM/2 未启动),因此转换字符串的操作未完成。
-1503 CONV_CONVERSION_ERROR。因为源字符串包含了转换表中所没有的字符,因此节点服务不能完成字符转换。这也可能意味着使用了未指定 CUSTOM_CONVERT=TRUE 的 DDF,且尝试发送或接收节点服务缺省表不支持的字符串。
-1504 CONV_CUSTOM_TABLE_ERROR。不能装入节点服务配置中指定的自定义表。您可能要使用随 CM/2 一起提供的自定义 ACSGTAB.DAT 表。
-1505 CONV_GENERAL_ERROR。由于存在不能识别的错误,因此不能进行字符转换。
-1506 CONV_INVALID_CHARACTER_SET。因为 TSD 开发工具包的内部错误,节点服务不能执行转换。

DDF 返回代码

返回代码 说明
-2501 CPIC_DDF_INVALID_TYPE。为 DDF 中的字段指定的类型名称无效。
-2502 CPIC_DDF_INVALID_FIELD_DECIMALS。DDF 中字段的小数宽度规范不正确。
-2503 CPIC_DDF_INVALID_FIELD_WIDTH。DDF 中指定的字段宽度不正确。
-2504 CPIC_DDF_NO_FIELD_TYPE。未为 DDF 中的字段指定类型。
-2505 CPIC_DDF_UNKNOWN_PARTNER_ATTRIB。不能识别 DDF 伙伴部分中的属性。
-2506 CPIC_DDF_UNRECOGNIZED_SECTION。DDF 中存在不可识别的部分。
-2507 CPIC_DDF_FILE_OPEN_ERROR。不能打开 DDF。确保名称拼写正确,且指定了完整的 PATH 或 PATH 在 DPATH 环境变量中。
-2508 CPIC_DDF_FILE_READ_ERROR。打开了 DDF,但是 TSD 开发工具包不能读此文件。确保您对此文件有读权限。
-2509 CPIC_DDF_FILE_CLOSE_ERROR。读取 DDF 之后,TSD 开发工具包不能关闭此文件。
-2510 CPIC_DDF_NOT_SPECIFIED。在命令中未指定 DDF。当在 DDF 中使用了 $SIZEOF$INCLUDE 命令但是未将 DDF 名称传递给这些命令时,出现这样的情况。
-2511 CPIC_DDF_DUPLICATE_FIELD。DDF 中的一个字段定义了两次。
-2512 CPIC_DDF_INVALID_VAR_LEN。DDF 中的一个字段声称属于类型 VAR,但是此字段并不是 DDF 中的最后一个字段。
-2513 CPIC_BAD_VAR_LEN_PARAM。在 DDF 中属于类型 VAR 的 TSD 脚本记录字段不是字符串字段。

CPIC 一般返回代码

返回代码 说明
-2514 CPIC_TYPE_CONVERSION_ERROR。TSD 开发工具包不能在为 TSD 脚本记录字段指定的类型和在 DDF 中为该字段指定的类型之间进行转换。
-2516 CPIC_CANT_SEND_UNKNOWN。DDF 为某个字段的“sendunknowns”列指定 FALSE,此字段在调用 CPICSend 时是 $Unknown
-2517 CPIC_BUF_TOO_SMALL。接收到的缓冲区相对于指定要使用的 DDF 来说太小。在 DDF 中检查字段宽度。
-2518 CPIC_CANNOT_CREATE_SEM。出现内部处理错误,使得 TSD 开发工具包不能创建必需的信号量。
-2519 CPIC_CANNOT_GET_SEM。出现内部处理错误,使得 TSD 开发工具包不能访问信号量。
-2520 CPIC_GENERAL_ERROR。出现内部处理错误,使得 TSD 开发工具包不能处理 CPIC 命令。

TSD 脚本系统常数

概述

几个 CPIC 命令使用整数参数作为行为的指示器。为了使这些命令变得更具可读性,下面列出了 TSD 脚本系统常数,为这些值提供了助记名称。

转换状态值

助记符
$CPICInitState 2
$CPICSendState 3
$CPICReceiveState 4
$CPICSendPendingState 5
$CPICConfirmState 6
$CPICConfirmSendState 7
$CPICConfirmDeallocateState 8
$CPICDeferReceiveState 9
$CPICDeferDeallocateState 10

数据接收值

助记符
$CPICNoDataReceived 0
$CPICDataReceived 1
$CPICCompleteDataReceived 2
$CPICIncompleteDataReceived 3

解除分配类型值

助记符
$CPICDeallocateSyncLevel 0
$CPICDeallocateFlush 1
$CPICDeallocateConfirm 2
$CPICDeallocateAbend 3

错误检测值

助记符
$CPICReceiveError 0
$CPICSendError 1

接收准备类型值

助记符
$CPICPrepToReceiveSyncLevel 0
$CPICPrepToReceiveFlush 1
$CPICPrepToReceiveConfirm 2

接收类型值

助记符
$CPICReceiveAndWait 0
$CPICReceiveImmediate 1

对发送请求的接收值

助记符
$CPICReqToSendNotReceived 0
$CPICReqToSendReceived 1

同步级别值

助记符
$CPICNone 0
$CPICConfirm 1
$CPICSyncPoint 2

返回控制值

助记符
$CPICWhenSessionAllocated 0
$CPICImmediate 1

发送类型值

助记符
$CPICBufferData 0
$CPICSendAndFlush 1
$CPICSendAndConfirm 2
$CPICSendAndPrepToReceive 3
$CPICSendAndAllocate 4

状态接收值

助记符
$CPICNoStatusReceived 0
$CPICSendReceived 1
$CPICConfirmReceived 2
$CPICConfirmSendReceived 3
$CPICConfirmSendReceived 4
$CPICTakeCommit 5
$CPICTakeCommitSend 6
$CPICTakeCommitDeallocate 7

对话安全类型值

助记符
$CPICSecurityNone 0
$CPICSecuritySame 1
$CPICSecurityProgram 2

TP 名称类型值

助记符
$CPICApplicationTP 0
$CPICSNAServiceTP 1

对话类型

助记符
$CPICBasicConversation 0
$CPICMappedConversation 1

Tivoli 服务台 6.0 开发工具包旧 API 指南

返回目录

版权所有