# Uso

## Cómo funciona

El servidor RSE registra un usuario recién conectado con el daemon de bloqueo. La información de registro contiene el Identificador de espacio de direcciones (que es el ASID del servidor de agrupación de hebras), el ID de Bloque de control de tareas (TCB) (específico del usuario) y el ID de usuario.

Tenga en cuenta que el registro se realiza solo en el momento de la conexión, por lo que todos los usuarios de RSE activos antes de iniciarse el daemon de bloqueo no estarán registrados.

Cuando el daemon de bloqueo recibe una consulta de conjunto de datos, explora las colas GRS (Global Resource Serialization) del sistema. Si el ASID y TCB coinciden con los de un usuario registrado, se devuelve el ID de usuario como propietario del bloqueo. De lo contrario, el nombre de trabajo/ID de usuario relacionado con el ASID se devuelve como propietario del bloqueo.

Se visualiza un mensaje de consola con la información de registro si falla el registro, de forma que un operador pueda emitir el mandato de operador D GRS,RES=(*,dataset[(member)]) y hacer coincidir manualmente los valores de ASID y TCB con lo indicado por el sistema como propietario del bloqueo.

Nota: Los registros satisfactorios también se listan en DD STDOUT del servidor si `log_level` está establecido en `2`. Esto es de utilidad para realizar la correlación manual para registros satisfactorios que se hayan eliminado tras un reinicio del daemon de bloqueo.

## Mandatos de operador

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

procname
  El nombre del miembro de una biblioteca de procedimientos que se utiliza para iniciar el servidor. El nombre predeterminado utilizado durante la configuración del host es `LOCKD` .
HOME='install_path'
  Prefijo de la vía de acceso y el `/usr/lpp/rdz` obligatorio utilizado para instalar Developer for System z. El valor predeterminado es `'/usr/lpp/rdz'`. Tenga en cuenta que la vía de acceso de z/OS UNIX es sensible a mayúsculas/minúsculas y que debe ir entre apóstrofos (') para conservar los caracteres en minúsculas.
CNFG='config_path'
  La ubicación absoluta de los archivos de configuración almacenados en z/OS UNIX. El valor predeterminado es `'/etc/rdz'`. Tenga en cuenta que la vía de acceso de z/OS UNIX es sensible a mayúsculas/minúsculas y que debe ir entre apóstrofos (') para conservar los caracteres en minúsculas.
LOG=log_level
  El nivel de detalle de salida en DD STDOUT.

- 0 : Anotar mensajes de error solamente.
- 1 : Anotar mensajes de error y aviso (valor predeterminado).
- 2 : Anotar mensajes de error, aviso e informativos.

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

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

procname
  El nombre del miembro de una biblioteca de procedimientos que se utiliza para iniciar el servidor. El nombre predeterminado utilizado durante la configuración del host es `LOCKD` .
QUERY dataset[(member)]
  Consulta el estado de bloqueo del conjunto de datos o miembro listado. El servidor responderá con uno de los siguientes mensajes:

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

  Notas:
  - El servidor también informará de los bloqueos retenidos por otros productos, como ISPF.
  - Los bloqueos retenidos por clientes RSE iniciados antes que el daemon de bloqueo darán como resultado que se indique que el espacio de direcciones del servidor de agrupación de hebras (`RSEDx`) es el propietario del bloqueo.

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

procname
  El nombre del miembro de una biblioteca de procedimientos que se utiliza para iniciar el servidor. El nombre predeterminado utilizado durante la configuración del host es `LOCKD` .

Tema principal: Daemon de bloqueo RSE