-DISPLAY FUNCTION SPECIFIC 命令 ( )Db2
-DISPLAY FUNCTION SPECIFIC 命令显示 Db2 应用程序访问的外部用户定义函数的统计信息。
缩写 :-DIS FUNC SPEC
环境 -DISPLAY FUNCTION SPECIFIC
该命令可以从 z/OS® 控制台、TSO下的DSN会话或 DB2I 面板( DB2 命令)、 IMS 或 CICS® 终端,或使用仪器设施接口(IFI)的程序。
数据共享范围: 团体或成员
授权 -DISPLAY FUNCTION SPECIFIC
- 显示特权
- 系统 DBADM 权限
- 系统管理员权限
- SYSCTRL 权限
- SYSADM 权限
- 系统管理员权限
- SYSCTRL 权限
- SYSADM 权限
Db2 登录 控制台或TSO 发出的命令可通过 授权进行查看,使用主授权ID和次授权ID。 z/OS SDSF Db2
必须在 RACF 或类似的安全服务器中定义一个已登录的 z/OS 用户ID。
如果您使用外部安全产品授权使用DISPLAY FUNCTION SPECIFIC,则当DISPLAY FUNCTION SPECIFIC SCOPE(GROUP)在远程系统上运行且SYSOPR用作授权ID时,请将SYSOPR定义为外部安全产品的用户。
语法 -DISPLAY FUNCTION SPECIFIC
选项说明 -DISPLAY FUNCTION SPECIFIC
- schema.specific-function-name
- 显示指定架构中特定命名功能的信息。 您不能像在SQL中那样指定函数名称,而必须使用特定的名称。 如果CREATE FUNCTION语句中没有指定特定名称,请查询 SYSIBM.SYSROUTINES 以获取正确的特定名称:
对于过载的功能,此查询可能会返回多行。SELECT SPECIFICNAME, PARM_COUNT FROM SYSIBM.SYSROUTINES WHERE NAME='function_name' AND SCHEMA='schema_name'; - schema.partial-name*
- 以指定模式显示一组功能的信息。
集合中所有函数的特定名称以 部分名称 开头,可以以任何字符串结尾,包括空字符串。 例如, schema1.ABC* 显示所有以 ABC 开头的特定名称的功能信息,在 schema1 中。
- (*.*)
- 显示自 Db2 子系统启动以来, Db2 应用程序访问的所有功能的信息。
- 范围
- 指定命令的范围。
- (本地)
- 指定显示仅包含本地成员的信息。
- (集团)
- 指定显示来自数据共享组所有成员的信息。
使用说明 -DISPLAY FUNCTION SPECIFIC
- 显示所有功能的信息
- 如果您没有指定部分或特定功能名称,则 Db2 将显示自 Db2 子系统启动以来, Db2 应用程序访问过的所有功能的信息。
- 内置函数或基于其他函数的自定义函数
- 此命令不适用于内置函数或基于其他函数的用户定义函数。
- 显示 SQL 函数
只有在调试模式下调用SQL函数时,该函数才会显示在DISPLAY FUNCTION SPECIFIC输出中。 在这种情况下,输出中的WLM环境列包含您在创建SQL函数时为调试指定的WLM环境。
如果函数受STOP FUNCTION命令影响,则DISPLAY FUNCTION输出将SQL函数的统计信息显示为“0”。
- 以组为范围发出的命令的跟踪信息
- 如果此命令在 Db2 数据共享成员中指定组范围,则它也将在所有其他活动成员中运行。 IFICID 090 跟踪记录显示,除了发出原始命令的成员的跟踪记录外, 016.TLPKN5F 相关 ID 的 SYSOPR 授权 ID 也发出了相同的命令。 请参阅 Db2 数据共享中的命令范围。
输出 -DISPLAY FUNCTION SPECIFIC
DSNX975I 消息显示来自 DISPLAY FUNCTION SPECIFIC 命令。 该命令的输出结果具有以下一般结构:
DSNX975I csect-name - DISPLAY FUNCTION SPECIFIC REPORT FOLLOWS-
------ SCHEMA = schema
FUNCTION STATUS ACTIVE QUED MAXQ TIMEOUT FAIL WLM_ENV
function status active qued maxq timeout fail wlm_env
function status active qued maxq timeout fail wlm_env
function status active qued maxq timeout fail wlm_env
------ SCHEMA = schema
csect-name ALL FUNCTIONS STARTED FOR THIS SCHEMA.
FUNCTION STATUS ACTIVE QUED MAXQ TIMEOUT FAIL WLM_ENV
function status active qued maxq timeout fail wlm_env
function status active qued maxq timeout fail wlm_env
function status active qued maxq timeout fail wlm_env
------ SCHEMA = schema
FUNCTION STATUS ACTIVE QUED MAXQ TIMEOUT FAIL WLM_ENV
function status active qued maxq timeout fail wlm_env
function status active qued maxq timeout fail wlm_env
function status active qued maxq timeout fail wlm_env
FUNCTIONS begin - end STOP (act)
...
csect-name ALL OTHER FUNCTIONS IN OTHER SCHEMAS STOPPED act
DISPLAY FUNCTION SPECIFIC REPORT COMPLETE
显示的输出结果取决于外部用户自定义的限定函数。 输出中可能包含错误信息。
输出中可以包含以下信息:
- 部门名称
- 发出消息的控制部分的名称。
- SCHEMA = 模式
- 输出中包含的函数的模式名称。
根据DISPLAY FUNCTION SPECIFIC的要求,方案名称和后续行数可重复使用。
- 功能 功能
- 外部函数的名称。
每个请求的功能都包含一行输出。
- 状态 status
- 功能的状态。 状态可以是以下任意值:
- 已启动
- 该功能可以接受SQL语句请求。
- STOPABN
- 由于之前应用程序异常终止,该功能已停止。 SQL语句对该函数的请求被拒绝。
- STOPQUE
- 该功能已停止。 SQL语句对函数的请求会排队等待,直到函数启动或STORTIME子系统参数定义的超时间隔到期。
- STOPREJ
- 该功能被STOP SPECIFIC FUNCTION命令和ACTION(REJECT)选项设置为当前状态。 SQL语句对该函数的请求被拒绝。
如果功能处于任何停止状态,您可以使用“启动特定功能”命令来启动该功能。
- 主动的 active
- 目前运行此功能的 Db2 代理商数量。
- QUED qued
- 目前等待安排此功能的 Db2 代理商数量。
- MAXQ maxq
- 自上次为该功能发出START SPECIFIC FUNCTION命令以来,等待安排该功能的 Db2 代理的最大数量。
- 超时超时
- 自上次为该函数发出START SPECIFIC FUNCTION命令以来,在等待函数调度时,SQL语句超时的次数。
如果使用带有ACTION(QUEUE)选项的STOP SPECIFIC FUNCTION命令停止函数,SQL语句可能会超时。 当超过STORTIME子系统参数定义的时间间隔后,该规格将导致对功能的请求超时。
- FAIL 失败
- 自上次启动以来,该功能已中止的次数。
- WLM_ENV wlm_env
- 该功能的 MVS Workload Manager 环境名称。
- 此方案的所有功能均已启动。
- 当以下两个条件同时满足时,将显示此行:
- 当发出显示特定功能命令时,停止特定功能(*.*)命令操作生效。
- 所有功能都针对输出中前一行标识的架构启动。
- 功能开始 ——结束停止 (行为 )
- 当STOP SPECIFIC FUNCTION命令导致一系列功能停止时,将显示此行。 当命令在功能名称中带有星号(*)时,会出现这种情况。
- 开始
- 当前停止的函数中的第一个函数名称。
- 结束
- 当前停止的函数中最后一个函数名称。
- act
- STOP SPECIFIC FUNCTION命令中指定的操作。
- 其他方案中的所有其他功能已停止
- 当以下两个条件同时满足时,将显示此行:
- 当发出显示特定功能命令时,停止特定功能(*.*)命令操作生效。
- 任何未在此显示功能特定输出中列出的功能均被停止。
行为表示在停止功能命令中指定的行为。
- 显示功能 特定报告 完整
- 报告已成功完成。
-DISPLAY FUNCTION SPECIFIC的报错信息
DISPLAY FUNCTION SPECIFIC输出中的以下信息表明发生了错误:
- csect-name 函数未访问或未定义
- 自 Db2 启动以来,DISPLAY FUNCTION SPECIFIC命令中提供的常规名称要么不存在,要么从未被访问过。 特定功能名称可能不在 SYSIBM.SYSROUTINES 目录表中。
对命令中提供的其他常规名称的处理将继续进行。
- 显示终止于最大行数
- 显示功能特定报告被截断。 该报告是根据 MVS 控制台的命令生成的,生成的信息超过 254 条。 仅返回254条信息。
命令处理完成。 截断的报告将写入 MVS 控制台。
重新发出显示功能特定命令,并指定更少的例程。 在 DISPLAY 命令中指定例程列表、模式限定符或部分例程名称,而不是使用默认值 (*.*)。或者,从 DB2I 的 DB2 命令” 面板或批处理作业(而不是 MVS 控制台)重新发出该命令。
- DSNX994I 由于命令已在执行中,无法处理范围(组)命令
- 请看 DSNX994I。
例子 -DISPLAY FUNCTION SPECIFIC
- 示例:显示架构中所有用户定义的功能的相关信息
- 以下命令显示有关 PAYROLL 架构和 HRPROD 架构中所有功能的信息。
-DISPLAY FUNCTION SPECIFIC(PAYROLL.*, HRPROD.*)输出结果与以下输出结果类似:
DSNX975I = DSNX9DIS DISPLAY FUNCTION SPECIFIC REPORT FOLLOWS- ------ SCHEMA=PAYROLL FUNCTION STATUS ACTIVE QUED MAXQ TIMEOUT FAIL WLM_ENV PAYRFNC1 STARTED 0 0 1 0 0 WLMENV1 PAYRFNC2 STOPQUE 0 5 5 3 0 WLMENV1 PAYRFNC3 STARTED 2 0 6 0 0 WLMENV1 USERFNC4 STOPREJ 0 0 1 0 0 WLMENV3 ------ SCHEMA=HRPROD FUNCTION STATUS ACTIVE QUED MAXQ TIMEOUT FAIL WLM_ENV HRFNC1 STARTED 0 0 1 0 0 WLMENV2 HRFNC2 STOPREJ 0 0 1 0 0 WLMENV2 DSNX9DIS DISPLAY FUNCTION SPECIFIC REPORT COMPLETE DSN9022I = DSNX9COM '-DISPLAY FUNC' NORMAL COMPLETION - 示例:在架构中显示所选用户自定义功能的相关信息
- 以下命令显示PAYROLL模式中函数 USERFNC2 和 USERFNC4 的相关信息。
-DISPLAY FUNCTION SPECIFIC(PAYROLL.USERFNC2,PAYROLL.USERFNC4)输出结果与以下输出结果类似:
DSNX975I = DSNX9DIS DISPLAY FUNCTION SPECIFIC REPORT FOLLOWS- ------ SCHEMA=PAYROLL FUNCTION STATUS ACTIVE QUED MAXQ TIMEOUT FAIL WLM_ENV USERFNC2 STOPQUE 0 5 5 3 0 WLMENV3 USERFNC4 STOPREJ 0 0 1 0 0 WLMENV3 DSNX9DIS DISPLAY FUNCTION SPECIFIC REPORT COMPLETE DSN9022I = DSNX9COM '-DISPLAY FUNC' NORMAL COMPLETION - 示例:显示已停止的用户自定义功能的相关信息
- 假设您发出以下命令:
-STOP FUNCTION SPECIFIC(SYSADM.FN*) ACTION(QUEUE) -DISPLAY FUNCTION SPECIFIC(SYSADM.*)输出结果与以下输出结果类似:
DSNX975I = DSNX9DIS DISPLAY FUNCTION SPECIFIC REPORT FOLLOWS- ------ SCHEMA=SYSADM FUNCTION STATUS ACTIVE QUED MAXQ TIMEOUT FAIL WLM_ENV FNC1 STOPQUE 0 0 0 0 0 WLMENV1 FNC2 STOPQUE 0 0 0 0 0 WLMENV3 DSNX9DIS FUNCTIONS FN - FN* STOP QUEUE DSNX9DIS DISPLAY FUNCTION SPECIFIC REPORT COMPLETE DSN9022I = DSNX9COM '-DISPLAY FUNC' NORMAL COMPLETION
