# 用法

## 如何工作

RSE 服务器向锁定守护程序注册新连接的用户。注册信息包含地址空间标识（线程池服务器的 ASID）、特定于用户的任务控制块（TCB）标识以及用户标识。

注意，注册仅在连接时执行，所以不会注册（重新）启动锁定守护程序之前处于活动状态的所有 RSE 用户。

锁定守护程序接收到数据集查询时，它会扫描系统的全局资源序列化（GRS）队列。如果 ASID 和 TCB 与注册用户的 ASID 和 TCB 相匹配，那么会返回用户标识作为锁定所有者。否则会返回与该 ASID 相关的作业名称/用户标识作为锁定所有者。

如果注册失败，那么会显示包含注册信息的控制台消息，以便操作员可发出 D GRS,RES=(*,dataset[(member)]) 操作员命令，并对 ASID 和 TCB 值与系统报告为锁定所有者的相应值进行手动匹配。

注： 如果 `log_level` 设置为 `2`，那么服务器的 DD STDOUT 中还会列示成功的注册。对重新启动锁定守护程序后除去的成功注册执行手动映射时，这会很有用。

## 操作员命令

    >>─┬─START ─┬──procname──┬───────────────────────────┬────────><
       └─S ─────┘            │        ┌─'usr/lpp/rdz'──┐ │
                             ├─,HOME=─┴─'install_path'─┴─┤
                             │        ┌─'etc/rdz'─────┐  │
                             ├─,CNFG=─┴─'config_path'─┴──┤
                             │       ┌─1─────────┐       │
                             ├─,LOG=─┴─log_level─┴───────┤
                             └─<─────────────────────────┘

procname
  过程库中用于启动服务器的成员的名称。主机配置期间使用的缺省名称为 `LOCKD`。
HOME='install_path'
  用于安装 Developer for System z 的路径前缀和必需的 `/usr/lpp/rdz`。缺省值为 `'/usr/lpp/rdz'`。注意，z/OS UNIX 路径区分大小写，并且必须括在单引号（'）中以保留小写字符。
CNFG='config_path'
  存储在 z/OS UNIX 中的配置文件的绝对位置。缺省值为 `'/etc/rdz'`。注意，z/OS UNIX 路径区分大小写，并且必须用括在单引号（'）中以保留小写字符。
LOG=log_level
  DD STDOUT 中输出的详细级别。

- 0：仅记录错误消息。
- 1：记录错误和警告消息（缺省值）。
- 2：记录错误、警告和参考消息。

    >>─┬─MODIFY ─┬──procname───────────────────────────────────────>
       └─F ──────┘

    >──,APPL=─┬─QUERY ─┬─┬─dataset─────────┬──────────────────────><
              └─Q ─────┘ └─dataset(member)─┘

procname
  过程库中用于启动服务器的成员的名称。主机配置期间使用的缺省名称为 `LOCKD`。
QUERY dataset[(member)]
  查询已列出数据集或成员的锁定状态。服务器将回复下列其中一个消息：

      BPXM023I (stclock) dataset[(member)] NOT LOCKED
      BPXM023I (stclock) dataset[(member)] LOCKED BY userid

  注意：
  - 服务器还将报告其他产品（如 ISPF）挂起的锁定。
  - 在锁定守护程序之前启动的 RSE 客户机挂起的锁定将导致线程池服务器地址空间（`RSEDx`）报告为锁定所有者。

    >>─┬─STOP ─┬──procname────────────────────────────────────────><
       └─P ────┘

procname
  过程库中用于启动服务器的成员的名称。主机配置期间使用的缺省名称为 `LOCKD`。

父主题： RSE 锁定守护程序