Set_Partner_LU_Name (CPI-C)

La chiamata Set_Partner_LU_Name (nome funzione cmspln) viene eseguita dal programma di richiamo per specificare il nome dell'unità logica partner.The Set_Partner_LU_Name call ( function name cmspln) is issued by the invoking program to specify the partner logical unit (LU) name. Questa chiamata esegue l'override del nome lu del partner derivato dalle informazioni sul lato quando è stata eseguita la chiamata Initialize_Conversation . Questa chiamata non può essere eseguita dopo l'emissione di Allocate . L'emissione di questa chiamata non ha alcun effetto sulle informazioni sul lato stesso.

Sintassi

  
CM_ENTRY Set_Partner_LU_Name(   
  unsigned char FAR *conversation_ID,    
    unsigned char FAR *partner_LU_name,    
  CM_INT32 FAR *partner_LU_name_length,    
  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.

partner_LU_name
Parametro fornito. Specifica l'indirizzo iniziale del nome lu partner. Il nome della modalità può contenere fino a 17 caratteri ASCII. I caratteri consentiti sono:

• Lettere maiuscole.

• Numerali da 0 a 9.

  Il nome lu partner può essere:

• Alias costituito da un massimo di otto caratteri.

• Nome di rete completo costituito da 2 a 17 caratteri. Un punto separa l'identificatore di rete (che può essere compreso tra zero e otto caratteri) dal nome lu di rete (che può essere compreso tra uno e otto caratteri). Se l'identificatore di rete è lungo zero caratteri, il periodo è comunque obbligatorio.

  Il nome lu partner deve corrispondere al nome di un lu partner stabilito durante la configurazione.

  partner_LU_name_length
  Parametro fornito. Specifica la lunghezza del nome lu partner. L'intervallo è compreso tra 1 e 17.

  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_STATE_CHECK
Codice restituito primario; la conversazione non è in stato INITIALIZE.

CM_PROGRAM_PARAMETER_CHECK
Codice restituito primario; si è verificato uno dei seguenti:

• Il valore specificato da conversation_ID non è valido.

• Il valore specificato da partner_LU_name_length non è compreso nell'intervallo (maggiore di 17 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 conversazione deve essere in stato INITIALIZE.

Non esiste alcuna modifica dello stato.

Commenti

La specifica di un valore non valido per partner_LU_name non viene rilevata fino a quando non viene emesso Allocate .