Freigeben über

Set_TP_Name (CPI-C)

  • Artikel

Der Set_TP_Name Aufruf (Funktionsname cmstpn) wird vom aufrufenden Programm ausgegeben, um den (aufrufbaren) Programmnamen des Partners anzugeben. Dieser Aufruf überschreibt den Namen des Partnerprogramms, der von den Seiteninformationen abgeleitet wurde, als der Initialize_Conversation Aufruf ausgegeben wurde. Dieser Aufruf kann nicht ausgegeben werden, nachdem der Allocate-Aufruf ausgegeben wurde. Das Auslösen dieses Aufrufs hat keine Auswirkungen auf die Nebeninformationen 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              
);

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. Zulässige 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. Hierfür können Sie jedoch Set_CPIC_Side_Information verwenden.

    Doppelbytezeichensä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; eine der folgenden Ereignisse:

  • Der von conversation_ID angegebene Wert ist ungültig.

  • Der von 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 Produktfehlerprotokoll protokolliert.

Zustandsänderungen

Die Unterhaltung muss sich im INITIALIZE-Zustand befinden.

Es gibt keine Zustandsänderung.