Histórico da Página

CONTENIDO

1. Visión General
2. Ejemplo de uso
3. Informaciones adicionales
4. Información relacionada

01. VISÃO GERAL

RecLock y MsUnlock son comandos cruciales para controlar la concurrencia en entornos donde múltiples usuarios acceden y modifican datos simultáneamente. RecLock se utiliza para bloquear registros específicos en archivos de datos, asegurando que solo un proceso a la vez pueda realizar cambios y previniendo así inconsistencias y corrupción de la información. Por otro lado, MsUnlock se utiliza para liberar estos bloqueos, permitiendo que otros procesos o usuarios puedan acceder y modificar los registros una vez que las operaciones hayan sido completadas.

02. EJEMPLO DE USO

USER FUNCTION EjemploRecLockMsUnlock()
    LOCAL nRegistro := 1  // Número de registro a bloquear
    
    // Bloqueando el registro utilizando RecLock
    RecLock("ARCHIVO", nRegistro)
    
    // Realizando operaciones de lectura y/o escritura en el registro bloqueado
    // En este ejemplo, simulamos una operación ficticia de lectura
    dbSeek("ARCHIVO", nRegistro)
    dbSkip(1, "ARCHIVO")
    
    // Liberando el bloqueo utilizando MsUnlock después de las operaciones
    MsUnlock("ARCHIVO", nRegistro)
    
    // Ejemplo de mensaje de éxito
    MsgInfo("Operaciones completadas exitosamente!")
RETURN

En este ejemplo:

• RecLock("ARCHIVO", nRegistro): Este comando bloquea el registro número 1 en el archivo "ARCHIVO". A partir de este punto, cualquier intento de otro proceso para modificar este registro será bloqueado hasta que el bloqueo sea liberado.

• Operaciones de lectura y/o escritura: Aquí se simulan operaciones de lectura en el registro bloqueado, utilizando funciones como dbSeek y dbSkip. En la práctica, podrías realizar cualquier operación permitida dentro del contexto de lectura o escritura de datos.

• MsUnlock("ARCHIVO", nRegistro): Después de completar las operaciones necesarias, el comando MsUnlock se utiliza para liberar el bloqueo del registro número 1 en el archivo "ARCHIVO", permitiendo que otros procesos puedan acceder y modificarlo según sea necesario.

02. INFORMACIONES ADICIONALES

El comando MsUnlock no necesita ser utilizado necesariamente en cada cambio de registro. Esto se debe a que el bloqueo de registros realizado por RecLock generalmente se mantiene hasta que se libere explícitamente con MsUnlock o hasta que el proceso que lo bloqueó finalice sus operaciones.

Cuando utilizas RecLock para bloquear un registro específico en un archivo de datos, ese bloqueo persiste hasta que:

1. Llames explícitamente a MsUnlock para liberar el bloqueo.
2. El proceso que realizó el bloqueo finalice sus operaciones y libere automáticamente el bloqueo al terminar.

Por lo tanto, en muchos casos, especialmente en operaciones simples donde bloqueas un registro, realizas algunas operaciones y luego finalizas el proceso, no es necesario utilizar MsUnlock explícitamente en cada cambio de registro. Esto se debe a que el sistema gestiona el bloqueo automáticamente según el ciclo de vida del proceso que lo inició.

USER FUNCTION EjemploIncorrecto()
    LOCAL nRegistro := 1
    
    // Bloqueando el registro utilizando RecLock
    RecLock("ARCHIVO", nRegistro)
    
    // Realizando la primera operación en el registro bloqueado
    dbEdit("ARCHIVO", nRegistro)
    dbReplace("ARCHIVO", nRegistro, "Primera modificación")
    
    // Liberando el bloqueo utilizando MsUnlock después de la primera operación
    MsUnlock("ARCHIVO", nRegistro)
    
    // Intentando bloquear nuevamente para la segunda operación
    RecLock("ARCHIVO", nRegistro) // Error aquí, el registro ya está bloqueado
    dbEdit("ARCHIVO", nRegistro)
    dbReplace("ARCHIVO", nRegistro, "Segunda modificación")
    
    // Liberando el bloqueo correctamente después de todas las operaciones
    MsUnlock("ARCHIVO", nRegistro)
RETURN

En este ejemplo incorrecto:

• El registro es bloqueado correctamente usando RecLock para la primera operación.
• Después de realizar la primera modificación, MsUnlock se utiliza prematuramente, liberando el bloqueo antes de realizar la segunda operación.
• Al intentar bloquear el registro nuevamente para la segunda operación, ocurre un error porque el registro ya está bloqueado por otra sesión o proceso.
• Esto puede causar inconsistencias o errores de concurrencia, ya que la segunda operación no puede continuar debido al bloqueo prematuramente liberado por MsUnlock.

USER FUNCTION EjemploCorrecto()
    LOCAL nRegistro := 1
    
    // Bloqueando el registro utilizando RecLock
    RecLock("ARCHIVO", nRegistro)
    
    // Realizando la primera operación en el registro bloqueado
    dbEdit("ARCHIVO", nRegistro)
    dbReplace("ARCHIVO", nRegistro, "Primera modificación")
    
    // Realizando la segunda operación en el mismo registro
    dbEdit("ARCHIVO", nRegistro)
    dbReplace("ARCHIVO", nRegistro, "Segunda modificación")
    
    // Liberando el bloqueo solamente después de todas las operaciones
    MsUnlock("ARCHIVO", nRegistro)
RETURN

En este ejemplo correcto:

• El registro es bloqueado correctamente usando RecLock.
• Las operaciones se realizan secuencialmente en el registro bloqueado.
• MsUnlock se utiliza únicamente después de completar todas las operaciones deseadas en el registro.
• Esto asegura que el registro permanezca bloqueado durante todas las modificaciones necesarias y se libere solo cuando todas las operaciones estén completas.
• De esta manera, garantizamos que otras sesiones o procesos puedan acceder al registro solo después de que se hayan realizado todas las modificaciones, evitando problemas de concurrencia y manteniendo la integridad de los datos.

En resumen, es crucial entender que MsUnlock no necesita ser utilizado después de cada cambio de registro, pero debe ser usado de manera adecuada, asegurando que el bloqueo se libere solo cuando todas las operaciones necesarias hayan sido completadas. Esto ayuda a evitar errores de concurrencia y asegura la integridad de los datos manipulados por el sistema.

04. INFORMACIÓN RELACIONADA

MSUnlock(cAlias) - Travamentos/Bloqueios/Locks - Frameworksp

Libera el registro creado o bloqueado por la RecLock.

...

Verifica si el registro existe en la tabla SA1:

...

La recomendación es que se utilicen únicamente las funciones RecLock y MsUnlock.