Set_CPIC_Side_Information (CPI-C)
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.