Specify_Local_TP_Name (CPI-C)

Artikel
07/21/2023

Der Specify_Local_TP_Name Aufruf (Funktionsname cmsltp) wird vom Programm ausgegeben, um anzugeben, dass es eingehende Unterhaltungen akzeptieren kann, die an den angegebenen Namen weitergeleitet werden.

Syntax

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

Parameter

TP_name
Angegebener Parameter. Gibt die Startadresse des TP-Namens (Local Transaction Program) an. Der Programmname kann bis zu 64 ASCII-Zeichen enthalten. Die zulässigen Zeichen sind:

Groß- und Kleinbuchstaben.
Zahlen von 0 bis 9.
Sonderzeichen mit Ausnahme des Leerzeichens.

Sie können Specify_Local_TP_Name nicht verwenden, um den Namen eines SNA-Dienst-TP anzugeben.

Doppelbytezeichensätze, z. B. Kanji, werden nicht unterstützt.

TP_name_length
Angegebener Parameter. Gibt die Länge des lokalen Programmnamens an. Der Bereich reicht von 1 bis 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_PARAMETER_CHECK
Primärer Rückgabecode; einer der folgenden Punkte ist aufgetreten:

Die angegebene TP_name ist ungültig.
Der durch TP_name_length angegebene Wert liegt außerhalb des Bereichs (größer als 64 oder kleiner als 1).

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

Zustandsänderungen

Der Anruf ist keiner bestimmten Unterhaltung zugeordnet, und es gelten keine Zustandseinschränkungen.

Es gibt keine Zustandsänderung.

Hinweise

Ein Programm kann diesen Aufruf mehrmals ausgeben, um eingehende Unterhaltungen mit mehr als einem TP-Namen zu behandeln. Das Programm kann den tatsächlichen Namen in der eingehenden Unterhaltung ermitteln, indem es Extract_TP_Name aufruft.

Freigeben über