-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 权限
如果您指定了显示功能规格 *.* 或者 schema.partial-name *,您必须使用包含以下权限之一的特权集:
  • 系统管理员权限
  • 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-nameschema.partial-name*)SCOPE(LOCALGROUP)

选项说明 -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 命令中指定例程列表、模式限定符或部分例程名称,而不是使用默认值 (*.*)。或者,从 DB2IDB2 命令” 面板或批处理作业(而不是 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