APPC-Verben und Windows-Erweiterungen

In diesem Thema werden die APPC-Verben und Windows-Erweiterungen beschrieben, die von Host Integration Server unterstützt werden:

APPC-Verben

Die folgenden APPC-Verbbeschreibungen enthalten wichtige Features und sollten vor der Verwendung dieser Version von Windows APPC gelesen werden.

ZUWEISEN oder MC_ALLOCATE
Dieses Verb, das vom aufrufenden Transaktionsprogramm (TP) ausgegeben wird, weist eine Sitzung zwischen der lokalen logischen Einheit (LU) und partner LU zu und (in Verbindung mit RECEIVE_ALLOCATE) stellt eine Unterhaltung zwischen dem aufrufenden TP und dem aufrufenden TP her. Nachdem dieses Verb erfolgreich ausgeführt wurde, generiert APPC einen Unterhaltungsbezeichner (conv_id). Die conv_id ist ein erforderlicher Parameter für alle anderen APPC-Unterhaltungsverben.

Für einen Benutzer oder eine Gruppe mit TPs, 5250 Emulatoren oder APPC-Anwendungen können Sie lokale standard- und Remote-LUs zuweisen. In diesem Fall bleibt das Feld für LU-Alias leer oder null, und auf die Standard-LUs wird zugegriffen, wenn der Benutzer oder gruppenmitglied ein APPC-Programm startet. Weitere Informationen zur Verwendung von Standard-LUs finden Sie im Abschnitt "Netzwerkintegration" der Hilfe zu Microsoft Host Integration Server.

RECEIVE_ALLOCATE
Ausgestellt von dem aufrufenden TP, um zu bestätigen, dass es bereit ist, eine Unterhaltung mit dem aufrufenden TP zu beginnen, das ZUWEISEN oder MC_ALLOCATE ausgestellt hat. Dies muss das erste APPC-Verb sein, das vom aufrufenden TP ausgegeben wird. Der Anfangszustand ist RESET. Wenn das Verb erfolgreich ausgeführt wird (primary_rc ist AP_OK), ändert sich der Zustand in RECEIVE.

RECEIVE_AND_POST oder MC_RECEIVE_AND_POST
Empfängt Anwendungsdaten und Statusinformationen asynchron. Auf diese Weise kann der lokale TP mit der Verarbeitung fortfahren, während die Daten noch an der lokalen LU ankommen. RECEIVE_AND_POST und MC_RECEIVE_AND_POST werden nur vom Windows-Betriebssystem unterstützt.

Während eine asynchrone RECEIVE_AND_POST oder MC_RECEIVE_AND_POST ausstehend ist, können die folgenden Verben ausgegeben werden:

REQUEST_TO_SEND oder MC_REQUEST_TO_SEND

GET_TYPE

GET_ATTRIBUTES oder MC_GET_ATTRIBUTES

TEST_RTS oder MC_TEST_RTS

DEALLOCATE

SEND_ERROR oder MC_SEND_ERROR

TP_ENDED

RECEIVE_AND_WAIT oder MC_RECEIVE_AND_WAIT
Empfängt alle Daten, die derzeit vom Partner TP zur Verfügung stehen. Wenn derzeit keine Daten verfügbar sind, wartet das lokale TP auf das Eintreffen von Daten.

RECEIVE_AND_WAIT und MC_RECEIVE_AND_WAIT wurden so verändert, dass sie wie RECEIVE_AND_POST und MC_RECEIVE_AND_POST wirken. Während eine asynchrone RECEIVE_AND_WAIT oder MC_RECEIVE_AND_WAIT ausstehend ist, können die folgenden Verben ausgegeben werden:

REQUEST_TO_SEND oder MC_REQUEST_TO_SEND

GET_TYPE

GET_ATTRIBUTES oder MC_GET_ATTRIBUTES

TEST_RTS oder MC_TEST_RTS

DEALLOCATE

SEND_ERROR oder MC_SEND_ERROR

TP_ENDED

TP_STARTED
Dieses Verb benachrichtigt APPC vom aufrufenden TP, dass der TP gestartet wird. Für einen Benutzer oder eine Gruppe mit TPs, 5250 Emulatoren oder APPC-Anwendungen können Sie standardbasierte lokale und Remote-APPC-LUs zuweisen. Auf diese Standard-LUs wird zugegriffen, wenn der Benutzer oder gruppenmitglied ein APPC-Programm (tp, 5250 Emulator oder APPC-Anwendung) startet und das Programm keine LU-Aliase angibt. Weitere Informationen zur Verwendung von Standard-LUs finden Sie in der Netzwerkintegrationshilfe.

Einschränkungen

HostIntegration Server ermöglicht einen ausstehenden asynchronen Windows APPC-Aufruf pro Verbindung und ein Blockierungsverb pro Thread. Beispiel:

void ProcessVerbCompletion (WPARAM wParam, LPARAM lParam)  
{     
    int i;  
    for (i = 0; i < nPendingVerbs; i++)  
        if (pPendingVerbs[i].hAsync == wParam)  
            ProcessVCB( (LPVCB) lParam);  
}    . . .  
LRESULT CALLBACK SampleWndProc ( ... )  
{  
    if (msg == uAsyncAPPC) {  
        ProcessVerbCompletion(wParam; lParam);  
    }  
        else switch (msg) {  
        case WM_USER:  
            if (hAsync = WinAsyncAPPC(hwnd, &vcb))  
               pPendingVerbs [nPendingVerbs++].hAsync = hAsync;  
            break;  
    }  
}  
WinMain ( ... )  
{  
    if ( ( WinAPPCStartup ( ...) = = FALSE ) {  
    return FALSE ;  
    }  
    uAsyncAPPC = RegisterWindowsMessage ("WinAsyncAPPC") ;  
    while (GetMessage ( ...)  )  {  
    ...  
    WinAPPCCleanup ( ... )  
}