software:qview:qview_6:qcl_library:sy10initializecriticalsection

Differenze

Queste sono le differenze tra la revisione selezionata e la versione attuale della pagina.

Link a questa pagina di confronto

Prossima revisione		 Revisione precedente
software:qview:qview_6:qcl_library:sy10initializecriticalsection [2019/08/29 17:01] – creata - modifica esterna 127.0.0.1software:qview:qview_6:qcl_library:sy10initializecriticalsection [2024/08/02 11:59] (versione attuale) – qem214
Linea 1: Linea 1:
 +====== SY10InitializeCriticalSection ======
 +
 +**SY = **//Funzione di sistema//
 +
 +La funzione SY10InitializeCriticalSection __inizializza il pool informazioni di una sezione critica__.
 +
 +===== IMPLEMENTAZIONE =====
 +
 +**SY10InitializeCriticalSection(pool)**
 +
 +Parametri:
 +
 +^IN/OUT^TIPO VARIABILE^NOME DI ESEMPIO^DIM^^
 +|  IN  |  ARRGBL  |  pool  |  B  | Pool informazioni sezione critica|
 +
 +Descrizione:
 +
 +Ogni sezione critica basa il proprio funzionamento interno su una struttura dati proprietaria chiamata //pool// informazioni.\\
 +Ogni sezione critica avrà un proprio //pool// che dovrà essere sempre inizializzato prima di poter essere utilizzato.\\
 +Il //pool// è formato da un array di bytes dove il numero di elementi dipende dal numero di unità task che lo utilizerranno più un header fisso di due byte.
 +
 +Se per esempio una determinata sezione critica viene utilizzata in solo due unità task basterà creare un pool di 4 byte stando attenti che una unità dovrà
 +utilizzare l'ID 1 mentra la seconda l'ID 2.
 +
 +Gli ID sono progressivi partendo da 1 ed identificano la posizione delle informazioni nel pool percui passare un ID con indice non disponibile nel pool significa invalidare la chiamata e il relativo funzionamento.
 +
 +**NB**: Per evitare problemi si consiglia di dimensionare i pool informazioni con dimensioni sufficienti ad indirizzare tutte le unità task.
 +
 +=== Esempio ===
 +
 +Nell'esempio viene inizializzato un pool informazioni utilizzato poi per una sezione critica.
 +
 +
 +\\
 +**unità configurazione:**
 +<code qcl>
 +; critical section consts
 +CONST
 +    CS_POOL_HEADER 2 ; fixed header in critical section pool info
 +    CS_POOL_SIZE 10 ; critical section pool info size
 +
 +ARRGBL
 +    LockPool B CS_POOL_HEADER + CS_POOL_SIZE
 +</code>
 +
 +
 +\\
 +**unità inizializzazione:**
 +<code qcl>
 +;===
 +; Initialize system
 +;
 +GLOBAL
 + Initialized F OUT
 +
 +; main entry point
 +BEGIN
 + CALL TASK_INIT
 + WHILE TRUE
 + CALL TASK_EXECUTE
 + WAIT A_LOOP
 +ENDWHILE
 +END
 +
 +;===
 +; Task initialization
 +;
 +SUB TASK_INIT
 +SY10InitializeCriticalSection(LockPool)
 +Initialized = TRUE
 +ENDSUB
 +
 +;===
 +; Task execution
 +;
 +SUB TASK_EXECUTE
 +    SUSPEND
 +    ENDSUB
 +</code>
 +
 +=== Note ===
 +
 +  *La funzione deve essere eseguita una sola volta e nella fase di inizializzazione dell'applicativo.
 +  *Le funzioni [[software:qview:qview_6:qcl_library:sy10entercriticalsection|SY10EnterCriticalSection]] e [[software:qview:qview_6:qcl_library:sy10leavecriticalsection|SY10LeaveCriticalSection]] non devo essere chiamate prima di aver inizializzato la sezione critica con [[software:qview:qview_6:qcl_library:sy10initializecriticalsection|SY10InitializeCriticalSection]].