GETAPPLOCK

28.3DesktopWeb

warning

La specifica è deprecata nei sorgenti con STRICT maggiore o uguale a 4, al suo posto vedere classe BC_DA_APPLOCK

Permette di gestire a basso livello il lock.

Il programma diventa responsabile dell'acquisizione e del rilascio di un lock.

note

1. Il programma acquisisce e rilascia il lock in modo esplicito.
2. Il programma deve avere una callback che gestisce la casistica di mancata acquisizione del lock.
3. Dopo la specifica bisogna verificare che il lock sia effettivamente acquisito.
4. Effettuare l'elaborazione sotto lock.
5. Rilasciare il lock acquisito. In caso così non fosse permane fino al termine del programma.

Parametri

Parametro	Definizione	I/O		Versione traduttore	SMP
NOME	Stringa
GESTIONEERRORE	Azione
MODO	Intero
TIPO	Intero
TIMEOUT	Intero

NOME

StringaInputObbligatorioValore non necessarioDesktopWeb

Identificativo univoco del lock.

GESTIONEERRORE

AzioneInputObbligatorioValore non necessarioDesktopWeb

Callback eseguita in caso il lock sia stato acquisito da un altro programma.

MODO

InteroInputValore non necessarioDesktopWeb

Modalità di gestione del lock.

Può avere i seguenti valori:

Valore	Descrizione
0	Esclusivo.
1	Condiviso.

Il funzionamento è il seguente:

• Si può acquisire un lock condiviso se non c'è un programma che ha acquisito il lock in modalità esclusiva.
• Si può acquisire un lock esclusivo se non c'è nessun lock condiviso o esclusivo.

Parametro con valori ammessi, si possono utilizzare i seguenti valori:

Valore	Descrizione
0	Esclusivo
1	Condiviso

TIPO

InteroInputValore non necessarioDesktopWeb

Distingue la durata del lock.

Valore	Descrizione
0	Sessione (connessione al db).
1	Transazione.

Parametro con valori ammessi, si possono utilizzare i seguenti valori:

Valore	Descrizione
0	Sessione (connessione al DB)
1	Transazione

TIMEOUT

InteroInputValore non necessarioDesktopWeb

Indica il tempo di attesa se il lock risulta occupato.

Il tempo è in millesecondi.
Il valore 0 specifica di non attendere che il lock sia acquisito.