Set_CPIC_Side_Information (CPI-C)

Articolo
10/14/2023

La chiamata Set_CPIC_Side_Information (nome funzione xcmssi) aggiunge o sostituisce una voce di informazioni lato in memoria. Una voce di informazioni sul lato CPI-C associa un set di caratteristiche di conversazione a un nome di definizione simbolico. Questa chiamata esegue l'override delle voci con lo stesso nome di destinazione simbolico.

Sintassi

  
CM_ENTRY Set_CPIC_Side_Information(   
  unsigned char FAR *key_lock,             
  SIDE_INFO FAR *side_info_entry,          
  CM_INT32 FAR *side_info_entry_length,    
  CM_INT32 FAR *return_code                
);

Parametri

key_lock
Parametro fornito. Questo parametro viene ignorato.

side_info_entry
Parametro fornito. Specifica il contenuto di una voce di informazioni sul lato. Nella tabella seguente viene descritta la struttura side_info_entry , che definisce il formato della voce delle informazioni lato.

Offset	Descrizione	Tipo	Length
0	sym_dest_name	unsigned char	8 byte
8	partner_LU_name	unsigned char	17 byte
25	Riservati	unsigned char	3 byte
28	TP_name_type	signed long int	32 bit
32	Tp_name	unsigned char	64 byte
96	mode_name	unsigned char	8 byte
104	conversation_ security_type	signed long int	32 bit
108	security_user_ID	unsigned char	8 byte
116	security_password	unsigned char	8 byte

I caratteri consentiti per sym_dest_name sono le lettere maiuscole (A e Z) e i numeri da 0 a 9.

Set_CPIC_Side_Information è l'unica chiamata CPI-C che consente di specificare un programma di transazione del servizio SNA (TP) come programma partner. La convenzione SNA per la denominazione di un servizio TP è fino a quattro caratteri. Il primo carattere è un byte esadecimale tra 0x00 e 0x3F. I caratteri rimanenti vengono convertiti da ASCII a EBCDIC.

Per i caratteri consentiti per gli altri campi, vedere la descrizione della chiamata di Set_ corrispondente. Ad esempio, per il campo mode_name , vedere la descrizione della chiamata Set_Mode_Name .

Ogni campo della struttura deve essere allineato a sinistra. Campi di pad a destra con spazi in base alle esigenze.

side_info_entry_length
Parametro fornito. Specifica la lunghezza di side_info_entry. È sempre 124.

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:

Un valore specificato nella struttura side_info_entry non è valido.
Il carattere sinistro della side_info_entry contiene 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 può essere in qualsiasi stato.

Non esiste alcuna modifica dello stato.

Commenti

I parametri stringa non validi nelle informazioni sul lato ,ad esempio specificando un'unità logica partner non esistente (LU) non vengono rilevate fino a quando allocato non viene emesso. L'errore viene restituito in una chiamata seguente Allocato.

Condividi tramite