Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Der Set_CPIC_Side_Information Aufruf (Funktionsname xcmssi) fügt einen Seiteninformationseintrag im Arbeitsspeicher hinzu oder ersetzt ihn. Ein CPI-C-Informationseintrag ordnet eine Reihe von Unterhaltungsmerkmalen einem symbolischen Definitionsnamen zu. Durch diesen Aufruf werden Einträge mit demselben symbolischen Zielnamen außer Kraft gesetzt.
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
);
Die 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 | Nicht signierter Char | 8 Bytes |
| 8 | partner_LU_name | Nicht signierter Char | 17 Bytes |
| 25 | reserviert | Nicht signierter Char | 3 Byte |
| 28 | TP_name_type | signed long int | 32 Bits |
| 32 | TP_name | Nicht signierter Char | 64 Bytes |
| 96 | mode_name | Nicht signierter Char | 8 Bytes |
| 104 | conversation_ security_type | signed long int | 32 Bits |
| 108 | security_user_ID | Nicht signierter Char | 8 Bytes |
| 116 | security_password | Nicht signierter Char | 8 Bytes |
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 ist bis zu vier Zeichen. Das erste Zeichen ist ein hexadezimales Byte zwischen 0x00 und 0x3F. Die verbleibenden Zeichen werden aus ASCII in EBCDIC übersetzt.
Die zulässigen Zeichen für die anderen Felder finden Sie in der Beschreibung des entsprechenden Set_ Aufrufs. For example, for the mode_name field, see the description of the Set_Mode_Name call.
Jedes Feld in der Struktur muss linksbündig ausgerichtet sein. Pad fields on the right with spaces as necessary.
side_info_entry_length
Angegebener Parameter. Gibt die Länge von 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; einer 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 Fehlerprotokoll der Produkte protokolliert.
Statusänderungen
Die Unterhaltung kann sich in einem beliebigen Zustand befinden.
Es gibt keine Zustandsänderung.
Bemerkungen
Ungültige Zeichenfolgenparameter in den Seiteninformationen (z. B. Angeben einer nicht vorhandenen logischen Partnereinheit (LU)) werden erst erkannt, wenn "Zuweisen " ausgegeben wird. Der Fehler wird für einen Aufruf zurückgegeben, der nach "Zuweisung" folgt.