# Uso

## Como Funciona

O servidor RSE registra um novo usuário conectado com daemon de bloqueio. As informações de registro contêm o Address Space Identifier (que é o ASID do servidor de conjunto de encadeamentos), o ID do Task Control Block (TCB) (específico do usuário) e o ID do usuário.

Observe que o registro é feito somente no tempo de conexão, de forma que todos os usuários do RSE ativos antes do daemon de bloqueio ter sido (re)iniciado não serão registrados.

Quando o daemon de bloqueio recebe uma consulta de conjunto de dados, ele varre as filas Global Resource Serialization Serialization (GRS) do sistema. Se o ASID e o TCB corresponderem ao de um usuário registrado, o ID do usuário é retornado como um proprietário de bloqueio. Caso contrário, o nome da tarefa/ID do usuário relacionado ao ASID é retornado como proprietário de bloqueio.

Uma mensagem do console com informações de registro é exibida se o registro falhar, de forma que um operador possa emitir o comando de operador D GRS,RES=(*,dataset[(member)]) e corresponder manualmente os valores do ASID e do TCB ao relatado pelo sistema como proprietário de bloqueio.

Nota: Os registros bem-sucedidos também são listados no DD STDOUT do servidor se `log_level` estiver configurado para `2`. Isso é útil para realizar o mapeamento manual para registros bem-sucedidos que foram removidos após um reinício do daemon de bloqueio.

## Comandos do operador

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

procname
  O nome do membro em uma biblioteca de procedimentos que é utilizada para iniciar o servidor. O nome padrão usado durante a configuração do host é `LOCKD` .
HOME='install_path'
  O prefixo do caminho e o `/usr/lpp/rdz` obrigatório usado para instalar o Developer para System z. O padrão é `'/usr/lpp/rdz'`. Observe que o caminho do z/OS UNIX faz distinção entre maiúsculas e minúsculas e deve ser colocado entre aspas simples (') para preservar os caracteres minúsculos.
CNFG='config_path'
  Local absoluto dos arquivos de configuração armazenados no z/OS UNIX. O padrão é `'/etc/rdz'`. Observe que o caminho do z/OS UNIX faz distinção entre maiúsculas e minúsculas e deve ser colocado entre aspas simples (') para preservar os caracteres minúsculos.
LOG=log_level
  O nível de detalhe da saída no DD STDOUT.

- 0 : Somente mensagens de erro do log.
- 1 : Mensagens de erro e de aviso do log (padrão).
- 2 : Mensagens de erro, aviso e informativas do log.

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

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

procname
  O nome do membro em uma biblioteca de procedimentos que é utilizada para iniciar o servidor. O nome padrão usado durante a configuração do host é `LOCKD` .
QUERY dataset[(member)]
  Consulte o status de bloqueio do conjunto de dados ou membro listado. O servidor responderá com uma das mensagens a seguir:

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

  Notas:
  - O servidor também relatará bloqueios de relatórios mantidos por outros produtos, como o ISPF.
  - Os bloqueios mantidos pelos clientes RSE iniciados antes do daemon de bloqueio resultarão em o espaço de endereço do servidor do conjunto de encadeamentos (`RSEDx`) ser relatado como proprietário de bloqueio.

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

procname
  O nome do membro em uma biblioteca de procedimentos que é utilizada para iniciar o servidor. O nome padrão usado durante a configuração do host é `LOCKD` .

Tópico pai: Daemon de Bloqueio do RSE