Freigeben über

Set_TP_Name (CPI-C)

Der Set_TP_Name Aufruf (Funktionsname cmstpn) wird vom aufrufenden Programm ausgegeben, um den Namen des Partners (aufrufbar) anzugeben. Durch diesen Aufruf wird der Name des Partnerprogramms außer Kraft gesetzt, der von den seitenseitigen Informationen abgeleitet wurde, wenn der Initialize_Conversation Anruf ausgegeben wurde. Dieser Anruf kann nicht ausgegeben werden, nachdem der Anruf zugewiesen wurde. Das Ausgeben dieses Aufrufs hat keine Auswirkungen auf die Seiteninformationen selbst.

Syntax

  
CM_ENTRY Set_TP_Name(   
  unsigned char FAR *conversation_ID,    
    unsigned char FAR *TP_name,            
    CM_INT32 FAR *TP_name_length,          
  CM_INT32 FAR *return_code              
);

Die Parameter

conversation_ID
Angegebener Parameter. Gibt den Bezeichner für die Unterhaltung an. Der Wert dieses Parameters wurde von Initialize_Conversation zurückgegeben.

TP_name
Angegebener Parameter. Gibt die Startadresse des Partnerprogrammnamens an. Der Programmname kann bis zu 64 ASCII-Zeichen enthalten. Die zulässigen Zeichen sind:

  • Groß- und Kleinbuchstaben.

  • Ziffern von 0 bis 9.

  • Sonderzeichen mit Ausnahme des Leerzeichens.

    Sie können Set_TP_Name nicht verwenden, um den Namen eines SNA-Diensttransaktionsprogramms (TP) anzugeben. Dazu können Sie jedoch Set_CPIC_Side_Information verwenden.

    Double-Byte-Zeichensätze, z. B. Kanji, werden nicht unterstützt.

    TP_name_length
    Angegebener Parameter. Gibt die Länge des Partnerprogrammnamens an. Der Bereich liegt zwischen 1 und 64.

    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_STATE_CHECK
Primärer Rückgabecode; die Unterhaltung befindet sich nicht im INITIALIZE-Zustand.

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

  • Der durch conversation_ID angegebene Wert ist ungültig.

  • Der durch TP_name_length angegebene Wert liegt außerhalb des Bereichs (größer als 64 oder kleiner als 1).

  • Die Adresse einer Variablen ist ungültig.

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

Statusänderungen

Die Unterhaltung muss sich im INITIALIZE-Zustand befinden.

Es gibt keine Zustandsänderung.

  • Last updated on