-DISPLAY LOCATION 命令 ( )Db2
-DISPLAY LOCATION 命令显示指定远程位置的各种信息。
当您指定“详细信息”关键字时，系统会显示与具有特定属性的合作伙伴地点的连接数量信息，以及与该地点通信的 Db2 系统线程拥有的连接的详细信息，这些信息可能也会显示在每个合作伙伴地点。
DISPLAY LOCATION命令返回的信息反映的是动态状态。 当信息显示时，状态可能已经发生了变化。
缩写 ：-DIS LOC
环境 -DISPLAY LOCATION
该命令可以从 z/OS® 控制台、TSO下的DSN会话、 DB2I 面板（ DB2 命令）、 IMS 或 CICS® 终端，或使用仪器设施接口（IFI）的程序。
数据共享范围 ：会员
授权 -DISPLAY LOCATION
- 显示特权
- 系统 DBADM 权限
- 系统管理员权限
- SYSCTRL 权限
- SYSADM 权限
Db2 登录 控制台或TSO 发出的命令可通过 授权进行查看，使用主授权ID和次授权ID。 z/OS SDSF Db2 
必须在 RACF 或类似的安全服务器中定义一个已登录的 z/OS 用户ID。
语法 -DISPLAY LOCATION
选项说明 -DISPLAY LOCATION
- (*)
- 显示所有远程位置的信息。
- （地名 ）
- 列出多个地点名称，以逗号分隔。
由于 Db2 无法从非 Db2 for z/OS 子系统的请求者处获取位置名称，您可以输入此类请求者的LUNAME或IP地址。 有关使用 LUNAME 或 IP 地址指定非客户端请求者的更多信息，请参阅 < luname > 和 ( ipaddr ) 选项的选项描述。 Db2 for z/OS 子系统。
- （部分地点 *）
- 选择所有以 部分位置字符串 开头、以任意字符串（包括空字符串）结尾的地点名称。 例如，LOCATION(ABC*) 选择以字符串“ABC”开头的所有地点名称。
- < luname >
- 请求通过指定的远程SNA LU连接到DDF的远程客户端的信息。 请用小于（<）和大于（>）符号将LU名称括起来。 例如，DISPLAY LOCATION(<LULA>) 显示远程位置（非 Db2 for z/OS ）的信息，并带有 LULA 的 LU 名称。
在指定LU名称时，可以使用星号（*），与前面描述的指定部分位置名称的方式相同。 例如，DISPLAY LOCATION(<LULA*) 选择所有远程位置（不是 Db2 for z/OS ），LU名称以字符串“LULA”开头。
- （ipaddr ）
- 请求通过远程TCP/IP主机连接到DDF的客户的信息。 输入IP地址。 例如，DISPLAY LOCATION( ::FFFF:124.63.51.17 ) 显示远程 TCP/IP 主机上客户的信息，其十进制 IP 地址为 124.63.51.17。
- （部分-ipaddr* ）
- 选择所有远程 TCP/IP 主机，其 IP 地址以部分 IP 地址开头，以任意字符串结尾，包括空字符串。 例如，LOCATION( ::FFFF:9.65.*) 选择所有远程TCP/IP主机，其IP地址以字符串“ ::FFFF:9.65.”开头。
- DETAIL
- 显示 Db2 系统线程的对话活动附加信息。
- INCOMPLT
- 仅显示与 Db2 连接不完整的位置，包括自DDF启动以来因连接不完整而终止的每个位置的连接总数。 只有当DDF停止并重新启动时，每个位置的计数才会被重置。
输出至 -显示位置
消息 DSNL200I 表示命令输出的开始。
输出标题后是关于远程位置连接的信息：
DSNL200I ) DISPLAY LOCATION REPORT FOLLOWS-
LOCATION PRDID T ATT CONNS
address text t number
- 位置
- 远程位置的标识符。
- 对于TCP/IP请求连接，位置是指与远程位置的端口号相连的IP地址。 对于TCP/IP服务器连接，位置是指远程位置的IP地址。
- 对于SNA连接，位置是远程位置的LU名称。
- PRDID
- 用于识别产品的字母数字字符串。产品标识符（PRDID）值是一个8字节字符值，采用 pppvvrrm格式 ，其中： ppp 是3个字母的产品代码； vv 是版本；rr 是发行版； m 是修改级别。 在 Db2 12 for z/OS 中，修改级别表示一系列功能级别：
- DSN12015适用于 V12R1M500 或更高版本。
- DSN12010致 V12R1M100。
更多信息，请参阅 Db2 for z/OS 中的产品标识符（PRDID）值。 - T
- 与远程位置的连接类型。 预期值是：
- R
- 从访问远程系统的本地子系统发出的请求连接。
- S
- 远程系统访问本地子系统的服务器连接。
- G
- 远程系统正在访问本地子系统，并表明其为 Db2 。连接服务器/网关。
- ATT和CONNS
- 与合作伙伴地点的连接类型和数量。 当ATT列为空时，CONNS的值是与伙伴地点的连接总数。 除非指定了“详细信息”选项，否则“ATT”列为空白。
ATT价值观的含义是：
- AES
- 连接使用AES加密。
- CBF
- 该连接是使用基于包的连续块获取的应用程序的辅助连接。
- IPS
- 连接使用 Internet Protocol 安全（IPSec）。
- TLS
- 该连接使用由应用透明传输层安全（AT-TLS）提供的安全套接字层（SSL）。
- TRS
- 这种联系是值得信赖的。
- WLB
- 连接来自使用Sysplex工作负载平衡的客户。
- XA
- 连接是分布式事务的一部分。
功能层面
当远程位置的功能级别已知时，消息行中包含该功能级别。
L209-FUNCTIONAL LEVEL=functional-level- 功能级别
- 价值取决于请求者的类型：
- 如果远程应用程序运行在 Db2 for z/OS 子系统上，则功能级别即为远程子系统的功能级别。 例如，如果远程子系统的功能级别为 V12R1M501 ，则功能级别为 V12R1M501。
- 如果远程应用程序是使用 IBM® Data Server Driver for JDBC and SQLJ ， 功能级别就是版本号。 驱动程序版本的格式为 major-version. minor-version. build-number。 版本号是驱动程序版本的版本号部分。 例如，如果驱动程序版本是 4.22.29 ，则构建级别为29。
- 如果远程应用程序是使用其他客户端或驱动程序的客户端应用程序，则功能级别为 Db2 for Linux®, UNIX, and Windows 客户端的构建级别。 构建级别的一个示例是 S1612011300。
找不到位置
当DISPLAY LOCATION命令无法找到与指定地点列表相关的任何地点时，会有一条消息行显示未找到任何地点。
DISPLAY LOCATION NO LOCATIONS FOUND如果指定了所有地点，则不存在分布式活动。 如果指定了位置列表，请使用 LOCATION(*) 参数重新发出 DISPLAY LOCATION 命令，以显示所有位置的信息。
截断输出
如果输出是根据 MVS 控制台的命令生成的，且生成的响应信息超过 254 条，则输出将被截断。 消息行会显示这种截断。
DISPLAY LOCATION TERMINATED WITH MAX LINES您可以重新发出显示位置命令，并指定一个或多个特定位置，以查看该上下文的完整输出。
详细输出
当显示位置命令与详细选项一起发出时，输出可能包含每个远程位置的附加行。
输出可能包含一行或多行，提供有关具有特定属性的远程系统的连接数的信息：
DSNL200I ) DISPLAY LOCATION REPORT FOLLOWS-
LOCATION PRDID T ATT CONNS
text t number
txt number
txt number
- 位置
- 远程位置的标识符。
- 对于TCP/IP请求连接，位置是指与远程位置的端口号相连的IP地址。 对于TCP/IP服务器连接，位置是指远程位置的IP地址。
- 对于SNA连接，位置是远程位置的LU名称。
- PRDID
- 用于识别产品的字母数字字符串。产品标识符（PRDID）值是一个8字节字符值，采用 pppvvrrm格式 ，其中： ppp 是3个字母的产品代码； vv 是版本；rr 是发行版； m 是修改级别。 在 Db2 12 for z/OS 中，修改级别表示一系列功能级别：
- DSN12015适用于 V12R1M500 或更高版本。
- DSN12010致 V12R1M100。
更多信息，请参阅 Db2 for z/OS 中的产品标识符 (PRDID) 值。 - T
- 与远程位置的连接类型。 预期值是：
- R
- 从访问远程系统的本地子系统发出的请求连接。
- S
- 远程系统访问本地子系统的服务器连接。
- G
- 远程系统正在访问本地子系统，并表明其为 Db2 。连接服务器/网关。
- ATT和CONNS
- 与远程位置相关联且具有ATT列标识属性的连接数量。 因为同一连接可能具有多个属性，所以连接总数不是不同属性数字的总和。 ATT的预期值是：
- AES
- 使用带有AES加密的安全凭证。
- IPS
- 使用IPSec。
- TLS
- SSL使用应用程序透明传输层安全（AT-TLS）。
- TRS
- 使用可信的上下文。
- WLB
- 使用负载均衡连接。
- XA
- 使用XA事务管理器处理。
输出结果可能还包括与 Db2 系统线程关联的连接的详细信息。 部分消息编号为 L203 的行提供了描述性标题。 以下行由部分消息编号 L204 标识。
L203-SYSTASK SESSID A ST TIME
L204-text session-id a s yydddhhmmssth
L204-text session-id a s yydddhhmmssth - 系统任务
- 描述 Db2 系统线程。 预期值是：
- SYSPLX-x
- 表示与SNA相关的SYSPLEX处理，其中 Db2 系统定期创建与远程数据共享组的连接，以获取与该组所有成员相关的WLM平衡信息。
x的预期值为：
- O
- 本地 Db2 系统正在联系数据共享组中的远程成员，请求WLM平衡信息。
- I
- 本地 Db2 系统正在接收一个请求WLM平衡信息的连接。
- RESYNC
- 用于重新同步遇到先前线程或通信错误的单元的工作连接。 每个需要与远程站点重新同步的线程都会显示一行。
- SESSID
- 会话标识符：
- 对于SNA网络连接，VTAM®定义的会话实例标识符，用于标识正在执行对话的会话。 如果会话标识符不适用，则此字段为0。
您可以使用 VTAM DISPLAY NET,ID= db2-luname,SCOPE=ACT 命令来获取完整的会话 ID。 DISPLAY NET命令列出了 Db2 逻辑单元的所有会话（SID）。 请查看DISPLAY NET输出，获取完整的SID。
- 对于 Internet Protocol 网络连接，格式为 local : remote 的字符串，其中：
- 本地
- 指定本地 Db2 系统的TCP/IP端口号。
- 远程
- 指定远程合作伙伴的TCP/IP端口号。
- 对于SNA网络连接，VTAM®定义的会话实例标识符，用于标识正在执行对话的会话。 如果会话标识符不适用，则此字段为0。
- A
- 连接活动：
- N
- 网络连接已激活。
- W
- 连接在 Db2 中暂停，等待VTAM或TCP/IP通知功能完成。
- 空白
- 不存在特定的活动条件。
- ST
- 连接状态：
- A
- 连接正在分配中。
- C
- 在分配连接之前，正在与SNA合作伙伴协商会话限制（CNOS）。
- D
- 这种联系在于去分配。
- R
- 接收。
- S
- 发送中。
- 空白
- 不存在特定的状态条件。
- 时间
- 连接上发送或接收的最后一条消息的时间戳，格式为 yyyymmddhhmmss ，其中
- yy
- 年份的最后两位数字。
- ddd
- 一年中的某天。 例如，2月1日用032表示。
- 嗯嗯嗯
- 以24小时制显示时间，精确到百分之一秒。
未完成输出
当DISPLAY LOCATION命令与INCOMPLT选项一起发出时，输出信息包含 Db2 终止的不完整连接的位置信息。
- 位置
- Db2 终止了连接不完整的客户端的IP地址。
- CONNS
- 自DDF启动以来， Db2 终止的客户端未完成连接的数量。
例如，假设您在服务器上发出以下命令：
-DISPLAY LOCATION INCOMPLT输出与以下示例类似：
DSNL200I -DB2A DISPLAY LOCATION REPORT FOLLOWS-
LOCATION CONNS
::10.1.43.29 47
::10.1.24.149 60
::10.1.28.42 2
::10.1.54.128 62
::10.1.54.132 30
::10.1.54.237 1
::10.1.54.242 108
::10.1.54.244 575
::10.1.54.250 884
::10.1.57.136 3
::10.1.58.43 21
::10.1.64.26 1
::10.1.67.185 1
::192.168.1.219 1
::192.168.1.25 1
::192.168.1.77 1
::192.168.1.57 1
DISPLAY LOCATION REPORT COMPLETE 由于消息空间不足，显示已终止
显示位置命令无法为其他信息获取存储空间。 这种情况仅发生在长时间显示请求时，例如在有大量连接的系统上显示位置（*）详情。
DISPLAY TERMINATED DUE TO INSUFFICIENT MESSAGE SPACE显示被截断。
重新发出显示位置命令，并指定较小的数字位置，而不是使用默认值（*）。为了减少所需的信息空间，除非需要详细信息选项提供的额外信息，否则不要指定该选项。
输出结论 -显示位置
DISPLAY LOCATION REPORT COMPLETE例子 -DISPLAY LOCATION
- 示例：显示特定远程位置的线程和对话信息
- 以下命令显示与远程位置 LUND1、 LUND2 和 LUND3 的线程和对话信息。
DISPLAY LOCATION(LUND1,LUND2,LUND3)输出结果与以下内容类似：
DSNL200I @ DISPLAY LOCATION REPORT FOLLOWS- LOCATION PRDID T ATT CONNS LUND1 DSN12015 R 1 LUND2 DSN12015 R 1 LUND2 DSN12015 S 1 LUND3 DSN12015 R 1 LUND3 DSN12015 S 3 DISPLAY LOCATION REPORT COMPLETE - 示例：显示与所有远程位置之间的对话和话题信息
- 以下命令显示与所有远程位置对话的详细信息，以及与 Db2 系统线程与其他位置通信的详细对话信息。
-DISPLAY LOCATION DETAIL输出结果与以下内容类似：
DSNL200I @ DISPLAY LOCATION REPORT FOLLOWS- DSNL200I @ DISPLAY LOCATION REPORT FOLLOWS- LOCATION PRDID T ATT CONNS LUND1 DSN12015 R 1 LUND2 DSN12015 R 1 LUND2 DSN12015 S 1 L203-SYSTASK SESSID A ST TIME L204-RESYNC E15FDE02D310FB84 N R 0820914411184 LUND3 DSN12015 R 1 LUND3 DSN12015 S 3 L203-SYSTASK SESSID A ST TIME L204-RESYNC E15FDE02D310FB87 W R 0820914411187 L204-RESYNC E15FDE02D310FB88 W R 0820914411188 L204-RESYNC E15FDE02D310FB89 W R 0820914411189 DISPLAY LOCATION REPORT COMPLETE DISPLAY LOCATION REPORT COMPLETE - 示例：显示与DRDA合作伙伴网站连接的相关信息：
- 假设一个 Db2 系统与以下DRDA合作伙伴连接：
- 非 z/OS 服务器通过TCP/IP IPv4。
- 与服务器位于同一TCP/IP主机上的多个TCP/IP客户端。
- 通过SNA的 Db2 for z/OS 服务器。
- 一个通过TCP/IP协议的 Db2 for z/OS 客户端 IPv6。
以下命令的输出显示了这些DRDA合作伙伴的相关信息：
-DISPLAY LOCATION(*)输出结果与以下输出结果类似：
DSNL200I @ DISPLAY LOCATION REPORT FOLLOWS- LOCATION PRDID T ATT CONNS ::FFFF:124.63.51.17..50000 SQL09073 R 3 ::FFFF:124.63.51.17 SQL09073 S 15 LULA DSN12015 S 1 2002:91E:610:1::5 DSN12015 S 1 - 示例：显示有关可信连接的信息：
- 假设与位置 ::FFFF:9.30.115.135 建立了可信连接。 您发出以下命令：
-DIS LOC DETATT字段中的TRS值表示连接是可信的，如下例所示：
DSNL200I @ DISPLAY LOCATION REPORT FOLLOWS- LOCATION PRDID T ATT CONNS ::FFFF:9.30.115.135 DSN12015 R 1 TRS 1 ::FFFF:9.30.115.135 DSN12015 S 1 TRS 1 DISPLAY LOCATION REPORT COMPLETE - 示例：显示与服务器有次要连接的位置的信息：
- 假设分布式应用程序使用增强型连续块获取来访问服务器上的数据。 请求者已在应用程序中为每个光标打开了一个辅助连接。 您需要在服务器上发出以下命令：
-DB2A DIS LOC DET将显示以下输出：
DSNL200I -DB2A DISPLAY LOCATION REPORT FOLLOWS- LOCATION PRDID T ATT CONNS ::FFFF:127.0.0.1 DSN12015 S 1 CBF 1 DISPLAY LOCATION REPORT COMPLETEATT字段中的CBF值表示位置 ::FFFF:127.0.0.1 的线程与辅助连接相关联。
如果在请求者处输入相同的命令，将显示以下输出：
DSNL200I -DB2B DISPLAY LOCATION REPORT FOLLOWS- LOCATION PRDID T ATT CONNS ::FFFF:127.0.0.1..446 DSN12015 R 1 CBF 1 DISPLAY LOCATION REPORT COMPLETEATT字段中的CBF值表示 ::FFFF:127.0.0.1..446 位置与辅助连接相关联。
- 示例：显示位置信息。 远程位置是一个 Db2 Connect 服务器网关：
- 您需要在服务器上发出以下命令：
-DB2A DIS LOC将显示以下输出：
DSNL200I -DB2A DISPLAY LOCATION REPORT FOLLOWS- LOCATION PRDID T ATT CONNS ::FFFF:9.23.2.248 SQL09019 G 1 DISPLAY LOCATION REPORT COMPLETE当PRDID值以“SQL”开头，且客户向 Db2 for z/OS 表示其为 Db2 Connect 服务器网关时，报告中该位置的T列中的G值即为该值。
- 示例：显示位置信息。 远程位置是一个 Db2 for z/OS 子系统，用于报告功能级别：
- 您需要在服务器上发出以下命令：
-DB2A DIS LOC将显示以下输出：
DSNL200I -DB2A DISPLAY LOCATION REPORT FOLLOWS- LOCATION PRDID T ATT CONNS SYEC1B DSN12015 S 1 L209-FUNCTIONAL LEVEL=V12R1M500 DISPLAY LOCATION REPORT COMPLETE功能级别与请求者的应用程序兼容级别相同，格式为 V12R1Mnnn。
- 示例：显示位置信息。 偏远地区使用 IBM Data Server Driver for JDBC and SQLJ ，报告功能级别：
- 您需要在服务器上发出以下命令：
-DB2A DIS LOC将显示以下输出：
DSNL200I -DB2A DISPLAY LOCATION REPORT FOLLOWS- LOCATION PRDID T ATT CONNS ::FFFF:9.30.222.67 JCC04220 S 1 L209-FUNCTIONAL LEVEL=29 DISPLAY LOCATION REPORT COMPLETEIBM Data Server Driver for JDBC and SQLJ 版本格式为 major-version. minor-version. build-number。 功能级别为内部版本号。 在这个例子中，驾驶员版本是 4.22.29 ，所以功能级别是29。
- 示例：显示位置信息。 偏远地区使用 IBM 数据服务器驱动程序进行CLI和 ODBC ，报告功能级别：
- 您需要在服务器上发出以下命令：
-DB2A DIS LOC将显示以下输出：
DSNL200I -DB2A DISPLAY LOCATION REPORT FOLLOWS- LOCATION PRDID T ATT CONNS ::FFFF:9.30.222.67 SQL11010 S 1 L209-FUNCTIONAL LEVEL=S1612011300 DISPLAY LOCATION REPORT COMPLETE功能级别是 Db2 for Linux, UNIX, and Windows 客户端的构建级别。
- 示例：显示连接不完整的地点 Db2
- 您需要在服务器上发出以下命令：
-DISPLAY LOCATION INCOMPLT将显示以下输出：
DSNL200I -DB2A DISPLAY LOCATION REPORT FOLLOWS- LOCATION CONNS ::10.1.43.29 47 ::10.1.24.149 60 ::10.1.28.42 2 ::10.1.54.128 62 ::10.1.54.132 30 ::10.1.54.237 1 ::10.1.54.242 108 ::10.1.54.244 575 ::10.1.54.250 884 ::10.1.57.136 3 ::10.1.58.43 21 ::10.1.64.26 1 ::10.1.67.185 1 ::192.168.1.219 1 ::192.168.1.25 1 ::192.168.1.77 1 ::192.168.1.57 1 DISPLAY LOCATION REPORT COMPLETE