Specify_Local_TP_Name (CPI-C)

La chiamata Specify_Local_TP_Name (nome funzione cmsltp) viene rilasciata dal programma per indicare che è in grado di accettare conversazioni in ingresso indirizzate al nome specificato.

Sintassi

  
CM_ENTRY Specify_Local_TP_Name(   
  unsigned char FAR *TP_name,    
  CM_INT32 FAR *TP_name_length,    
  CM_INT32 FAR *return_code    
);  

Parametri

Tp_name
Parametro fornito. Specifica l'indirizzo iniziale del nome del programma di transazione locale (TP). Il nome del programma può contenere fino a 64 caratteri ASCII. I caratteri consentiti sono:

• Lettere maiuscole e minuscole.

• Numeri da 0 a 9.

• Caratteri speciali, ad eccezione dello spazio.

  Non è possibile usare Specify_Local_TP_Name per specificare il nome di un servizio SNA TP.

  I set di caratteri a byte doppio, ad esempio Kanji, non sono supportati.

  TP_name_length
  Parametro fornito. Specifica la lunghezza del nome del programma locale. L'intervallo è compreso tra 1 e 64.

  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; si è verificato uno dei seguenti:

• Il TP_name fornito non è valido.

• Il valore specificato da TP_name_length non è compreso nell'intervallo (maggiore di 64 o minore di 1).

  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 chiamata non è associata a una conversazione specifica e non si applicano restrizioni sullo stato.

Non esiste alcuna modifica dello stato.

Commenti

Un programma può eseguire questa chiamata più di una volta per gestire le conversazioni in ingresso con più di un nome TP. Il programma può individuare il nome effettivo nella conversazione in ingresso chiamando Extract_TP_Name.