Set_CPIC_Side_Information (CPI-C)

Artikel
10/14/2023

Der Set_CPIC_Side_Information-Aufruf (Funktionsname xcmssi) fügt einen Seiteninformationseintrag im Arbeitsspeicher hinzu oder ersetzt ihn. Ein CPI-C-seitenseitiger Informationseintrag ordnet eine Reihe von Konversationsmerkmalen einem symbolischen Definitionsnamen zu. Dieser Aufruf überschreibt Einträge mit demselben symbolischen Zielnamen.

Syntax

  
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                
);

Parameter

key_lock
Angegebener Parameter. Konvertiert die Zeichenfolgendarstellung einer Zahl in einem angegebenen Stil und einem kulturspezifischen Format in die entsprechende 32-Bit-Ganzzahl mit Vorzeichen.

side_info_entry
Angegebener Parameter. Gibt den Inhalt eines Seiteninformationseintrags an. In der folgenden Tabelle wird die side_info_entry-Struktur beschrieben, die das Format des Seiteninformationseintrags definiert.

Offset	Beschreibung	Typ	Länge
0	sym_dest_name	unsigned char	8 Byte
8	partner_LU_name	unsigned char	17 Bytes
25	reserved	unsigned char	3 Byte
28	TP_name_type	signed long int	32 Bit
32	TP_name	unsigned char	64 Bytes
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

Die zulässigen Zeichen für sym_dest_name sind die Großbuchstaben (A bis Z) und die Ziffern von 0 bis 9.

Set_CPIC_Side_Information ist der einzige CPI-C-Aufruf, mit dem Sie ein SNA-Diensttransaktionsprogramm (TP) als Partnerprogramm angeben können. Die SNA-Konvention zum Benennen eines Dienst-TP umfasst bis zu vier Zeichen. Das erste Zeichen ist ein hexadezimales Byte zwischen 0x00 und 0x3F. Die übrigen Zeichen werden von ASCII in EBCDIC übersetzt.

Die zulässigen Zeichen für die anderen Felder finden Sie in der Beschreibung des entsprechenden Set_ Aufrufs. Für das Feld mode_name finden Sie beispielsweise die Beschreibung des Set_Mode_Name-Aufrufs .

Jedes Feld in der Struktur muss linksbündig ausgerichtet sein. Felder auf der rechten Seite mit Leerzeichen nach Bedarf.

side_info_entry_length
Angegebener Parameter. Gibt die Länge der side_info_entry an. Es ist immer 124.

return_code
Der von diesem Aufruf zurückgegebene Code. Die gültigen Rückgabecodes werden weiter unten in diesem Thema aufgeführt.

Rückgabecodes

CM_OK
Primärer Rückgabecode; Der Aufruf wurde erfolgreich ausgeführt.

CM_PROGRAM_PARAMETER_CHECK
Primärer Rückgabecode; eine der folgenden Ereignisse:

Ein in der side_info_entry-Struktur angegebener Wert ist ungültig.
Das linke Zeichen der side_info_entry enthält ein Leerzeichen.

CM_PRODUCT_SPECIFIC_ERROR
Primärer Rückgabecode; Ein produktspezifischer Fehler ist aufgetreten und wurde im Produktfehlerprotokoll protokolliert.

Zustandsänderungen

Die Unterhaltung kann sich in einem beliebigen Zustand befinden.

Es gibt keine Zustandsänderung.

Hinweise

Ungültige Zeichenfolgenparameter in den Seiteninformationen (z. B. angabe einer nicht vorhandenen logischen Partnereinheit (LU)) werden erst erkannt, wenn Allocate ausgestellt wurde. Der Fehler wird bei einem Aufruf nach Allocate zurückgegeben.

Freigeben über