Freigeben über

Zuordnen (CPI-C)

Der Zuweisungsaufruf (Funktionsname cmallc) wird vom aufrufenden Programm ausgegeben, um eine Unterhaltung mit dem Partnerprogramm mithilfe der aktuellen Unterhaltungsmerkmale zuzuweisen. CPI-C können auch eine Sitzung zwischen der lokalen logischen Einheit (LU) und der Partner-LU zuordnen, wenn noch keine vorhanden ist.

Syntax

  
CM_ENTRY Allocate(   
  unsigned char FAR *conversation_ID,    
    CM_INT32 FAR *return_code              
);

Parameter

conversation_ID
Angegebener Parameter. Gibt den Unterhaltungsbezeichner an. Der Wert dieses Parameters wurde von Initialize_Conversation zurückgegeben.

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_OPERATION_NOT_ACCEPTED
Primärer Rückgabecode; dieser Wert gibt an, dass ein vorheriger Vorgang für diese Unterhaltung unvollständig ist.

CM_OPERATION_INCOMPLETE
Primärer Rückgabecode; Ein Nichtblockierungsvorgang wurde für die Unterhaltung gestartet, ist aber nicht abgeschlossen. Das Programm kann Wait_For_Conversation auf den Abschluss des Vorgangs warten oder Cancel_Conversation , um den Vorgang und die Unterhaltung abzubrechen.

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

  • Der Modusname, der von den seitenseitigen Informationen abgeleitet oder von Set_Mode_Name festgelegt wurde, ist ungültig.

  • Der Modusname wird von SNA-Diensttransaktionsprogrammen (TPs) verwendet; das aufrufende Programm hat nicht die Berechtigung, diesen Modusnamen zu verwenden. Ein Beispiel ist SNASVCMG.

  • Das Partnerprogramm, das von den Seiteninformationen abgeleitet ist, ist ein SNA-Dienst-TP; Das lokale Programm verfügt nicht über die erforderlichen Berechtigungen, um eine Unterhaltung einem SNA-Dienst-TP zuzuweisen.

  • Das Partnerprogramm ist ein Dienst-TP, der an grundlegenden Unterhaltungen teilnimmt, die Unterhaltung jedoch auf CM_MAPPED_CONVERSATION festgelegt ist.

  • Der Partner-LU-Name, der von den Seiteninformationen abgeleitet oder von Set_Partner_LU_Name festgelegt wurde, ist ungültig.

    CM_PROGRAM_PARAMETER_CHECK
    Primärer Rückgabecode; Der durch conversation_ID angegebene Wert ist ungültig, oder die Adresse einer Variablen ist ungültig.

    CM_PROGRAM_STATE_CHECK
    Primärer Rückgabecode; die Unterhaltung befindet sich nicht im INITIALIZE-Zustand.

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

    CM_UNSUCCESSFUL
    Primärer Rückgabecode; die Unterhaltungsrücklaufsteuerungseigenschaft wird auf CM_IMMEDIATE festgelegt, und die lokale LU hat keine verfügbare Inhaltsgewinnersitzung.

    Die folgenden Rückgabecodes können generiert werden, wenn der Rückgabesteuerelementtyp für Unterhaltungen auf CM_WHEN_SESSION_ALLOCATED festgelegt ist.

    CM_ALLOCATE_FAILURE_NO_RETRY
    Primärer Rückgabecode; die Unterhaltung kann aufgrund einer dauerhaften Bedingung nicht zugewiesen werden, z. B. aufgrund eines Konfigurationsfehlers oder sitzungsprotokollfehlers. Um den Fehler zu ermitteln, sollte der Systemadministrator die Fehlerprotokolldatei untersuchen. Wiederholen Sie die Zuordnung erst, wenn der Fehler behoben wurde.

    CM_ALLOCATE_FAILURE_RETRY
    Primärer Rückgabecode; die Unterhaltung konnte aufgrund einer temporären Bedingung, z. B. aufgrund eines Verknüpfungsfehlers, nicht zugewiesen werden. Der Grund für den Fehler wird im Systemfehlerprotokoll protokolliert. Wiederholen Sie die Zuordnung.

    Statusänderungen

    Die Unterhaltung muss sich beim Zuweisen im INITIALIZE-Zustand befinden.

    Zustandsänderungen, zusammengefasst in der folgenden Tabelle, basieren auf dem Wert des return_code-Parameters .

return_code Neuer Zustand
CM_OK SEND
CM_ALLOCATE_FAILURE_NO_RETRY ZURÜCKSETZEN
CM_ALLOCATE_FAILURE_RETRY ZURÜCKSETZEN
Alle anderen Keine Änderung

Bemerkungen

Der Typ der zugeordneten Unterhaltung basiert auf dem Unterhaltungstypmerkmal: zugeordnet oder einfach.

Wenn die Unterhaltung durch diesen Anruf zugewiesen wurde, können die folgenden Unterhaltungsmerkmale nicht geändert werden:

  • Unterhaltungstyp

  • Modusname

  • Partner-LU-Name

  • Name des Partnerprogramms

  • Rückgabesteuerelement

  • Synchronisierungsebene

  • Unterhaltungssicherheit

  • Benutzer-ID

  • Passwort

    Um die Zuordnungsanforderung sofort zu senden, kann das aufrufende Programm "Flush" oder "Bestätigen " unmittelbar nach der Zuordnung ausgeben. Andernfalls sammelt sich die Zuordnungsanforderung mit anderen Daten im lokalen LUs-Sendepuffer, bis der Puffer voll ist.

    Durch die Ausstellung "Confirm after Allocate" kann das aufrufende Programm sofort bestimmen, ob die Zuordnung erfolgreich war (wenn die Synchronisierungsebene für Unterhaltungen auf CM_CONFIRM festgelegt ist).

    Wenn die Partner-LU die von "Allocate" generierte Zuordnungsanforderung ablehnt, wird der Fehler bei einem nachfolgenden Aufruf an das aufrufende Programm zurückgegeben.

  • Last updated on