Initialize_Conversation (CPI-C)
La chiamata Initialize_Conversation (nome funzione cminit) viene emessa dal programma di richiamo per ottenere un identificatore di conversazione a 8 byte e per impostare i valori iniziali per le caratteristiche delle conversazioni.
Sintassi
CM_ENTRY Initialize_Conversation(
unsigned char FAR *conversation_ID,
unsigned char FAR *sym_dest_name,
CM_INT32 FAR *return_code
);
Parametri
conversation_ID
Parametro restituito. Specifica l'identificatore per la conversazione. Viene usato dalle successive chiamate CPI-C.
sym_dest_name
Parametro fornito. Specifica il nome della destinazione simbolica, ovvero il nome associato a una voce di informazioni sul lato caricata dal file di configurazione o definito da Set_CPIC_Side_Information chiamate.
Questo parametro è una stringa di caratteri ASCII a 8 byte. I caratteri consentiti sono i seguenti:
Lettere maiuscole
Numerali da 0 a 9
Questo parametro può anche essere impostato su otto spazi. In questo caso, il programma di richiamo deve eseguire le chiamate seguenti prima di eseguire Allocate:
-
return_code
Codice restituito da questa chiamata. I codici restituiti validi sono elencati più avanti in questo argomento.
Codici restituiti
CM_OK
Codice restituito primario; la chiamata eseguita correttamente.
CM_PROGRAM_PARAMETER_CHECK
Codice restituito primario; il valore specificato da sym_dest_name non corrisponde a un nome di destinazione simbolico nella tabella delle informazioni sul lato e non è uno spazio.
CM_PRODUCT_SPECIFIC_ERROR
Codice restituito primario; si è verificato un errore specifico del prodotto ed è stato registrato nel log degli errori dei prodotti.
Modifiche di stato
La conversazione è in stato RESET.
Se il return_code è CM_OK, la conversazione passa allo stato INITIALIZE. Per altri codici restituiti, lo stato della conversazione rimane invariato.
Commenti
I valori iniziali sono valori predefiniti CPI-C o sono derivati dalle informazioni sul lato associate al nome della destinazione simbolica. Per altre informazioni sui valori iniziali e sul lato, vedere Initial Conversation Characteristics and Side Information for CPI-C Programs .For more information about initial values and side information, see Initial Conversation Characteristics and Side Information for CPI-C Programs.For more information about initial values and side information, see Initial Conversation Characteristics and Side Information for CPI-C Programs.
I valori iniziali possono essere modificati dalle chiamate Set_ .
Se le informazioni sul lato contengono un valore non valido o una chiamata Set_ imposta una caratteristica di conversazione su un valore non valido, l'errore viene restituito nella chiamata Alloca.
Se un'applicazione CPI-C tenta di richiamare più conversazioni simultanee, viene usata da tutte le conversazioni solo una singola unità logica APPC locale. Ciò impedisce conversazioni simultanee tra due o più UNITÀ LOGICHE dipendenti 6.2, causando successive chiamate Initialize_Conversation (CMALLC) in attesa della deallocazione della prima conversazione.
Se l'applicazione CPI-C deve richiamare più conversazioni simultanee, è necessario usare LU 6.2 indipendente tra Host Integration Server e il sistema remoto.
Al termine dell'esecuzione di questa chiamata, CPI-C genera un identificatore di conversazione. Questo identificatore è un parametro obbligatorio per tutte le altre chiamate CPI-C inviate per questa conversazione dal programma di chiamata.
In circostanze normali, un'applicazione CPI-C non può richiamare due conversazioni simultanee usando due unità LC APPC locali diverse. È disponibile una chiave del Registro di sistema che, se impostata, forza CPI-C a emettere un nuovo verbo TP_STARTED in ogni chiamata di Initialize_Conversation (cminit). Questa operazione è necessaria per forzare la posizione della risorsa APPC per ogni chiamata. La chiave del Registro di sistema che deve essere definita per forzare questo comportamento è la seguente:
\HKLM\CurrentControlSet\Services\SnaBase\Parameters\Client\GETNEWTPID