Set_Return_Control (CPI-C)

La chiamata Set_Return_Control (nome funzione cmsrc) viene eseguita dal programma di richiamo per specificare quando l'unità logica locale (LU), che agisce sulla richiesta di sessione dai programmi locali Allocate call, deve restituire il controllo al programma locale.

Sintassi

  
CM_ENTRY Set_Return_Control(   
  unsigned char FAR *conversation_ID,    
    CM_INT32 FAR *return_control,          
  CM_INT32 FAR *return_code              
);  

Parametri

conversation_ID
Parametro fornito. Specifica l'identificatore per la conversazione. Il valore di questo parametro è stato restituito da Initialize_Conversation.

return_control
Parametro fornito. Specifica quando l'unità lu locale, che agisce sulla chiamata Alloca , deve restituire il controllo al programma locale. Di seguito sono riportati i valori consentiti:

CM_IMMEDIATE
Il lu alloca una sessione con contesa, se disponibile immediatamente, e restituisce il controllo al programma.

CM_WHEN_SESSION_ALLOCATED
Il lu non restituisce il controllo al programma finché non alloca una sessione o rileva errori. Se una sessione non è disponibile, il programma attende uno. Se il limite di sessione è zero, l'unità lu restituisce immediatamente il controllo.

return_code
Codice restituito da questa chiamata. I codici restituiti validi sono elencati più avanti in questo argomento.

Codici di ritorno

CM_OK
Codice restituito primario; la chiamata eseguita correttamente.

CM_PROGRAM_STATE_CHECK
Codice restituito primario; la conversazione non è in stato INITIALIZE.

CM_PROGRAM_PARAMETER_CHECK
Codice restituito primario; il valore specificato da conversation_ID o return_control non è valido.

CM_PRODUCT_SPECIFIC_ERROR
Codice restituito primario; si è verificato un errore specifico del prodotto ed è stato registrato nel log degli errori dei prodotti.

Modifiche dello stato

La conversazione deve essere in stato INITIALIZE.

Non viene apportata alcuna modifica allo stato.

Osservazioni:

Questa chiamata esegue l'override del controllo restituito predefinito stabilito da Initialize_Conversation. Per impostazione predefinita, il controllo viene restituito quando la sessione viene allocata. Non è possibile eseguire questa chiamata dopo l'emissione della chiamata Allocate .

Per altre informazioni sulle sessioni, vedere Scrittura di applicazioni CPI-C.

Se l'unità lu non è in grado di allocare una sessione, la notifica viene restituita nella chiamata Alloca .