HP-UX SNAplus2 R7 APPC Programmer's Guide

Writing Transaction Programs

APPC Entry Points: Windows Systems

Cancels an outstanding asynchronous verb (one issued using the WinAsyncAPPC entry point). Depending

on which verb is outstanding, this may also end the conversation or the TP or deactivate the session being

used by a conversation.

WinAPPCCleanup

Unregisters the application when it has ﬁnished using APPC.

APPC

Issues an APPC verb. The verb blocks; that is, the application’s processing is suspended until APPC has

ﬁnished processing the verb and returned the results.

WinAPPCCancelBlockingCall

Cancels an outstanding blocking verb (one issued using the APPC entry point). Depending on which verb

is outstanding, this may also end the conversation or the TP, or deactivate the session being used by a

conversation. For more information about the circumstances in which this call may be required, see Section

2.4.6,

Blocking Verbs.

WinAPPCIsBlocking

Checks whether there is a blocking verb outstanding for this application. For more information about the

circumstances in which this call may be required, see Section 2.4.6, Blocking Verbs.

WinAPPCSetBlockingHook

Speciﬁes the blocking procedure that APPC uses while processing blocking verbs; this replaces APPC’s default

blocking procedure. The blocking procedure is called repeatedly until the verb processing has completed. For

more information, see Section 2.4.6, Blocking Verbs.

WinAPPCUnhookBlockingHook

Unregisters the blocking procedure speciﬁed by a previous WinAPPCSetBlockingHook call, so that APPC

reverts to using the default blocking procedure.

GetAppcConfig

Returns information about remote LUs conﬁgured for use by a speciﬁed local LU and mode. This function is

provided for use by 5250 emulation programs; the information returned is taken from the 5250 user records

in the SNAplus2 conﬁguration.

GetAppcReturnCode

Generates a printable character string for the primary and secondary return codes obtained on an APPC verb.

These entry points are deﬁned in the Windows APPC header ﬁle winappc.h. This ﬁle is installed in the

subdirectory /sdk within the directory where you installed the Windows Client software.

The application must call WinAPPCStartup before attempting to issue any APPC verbs.

It then issues APPC verbs using one of the following entry points:

• WinAsyncAPPC or WinAsyncAPPCEx (asynchronous). If you are developing new applications for Windows,

use one of these entry points.

• APPC (blocking). This entry point is provided for back-level compatibility with previous versions of SNAplus2,

and for compatibility with the HP-UX APPC implementation. Section 2.4.6, Blocking Verbs provides more

information about how blocking verbs operate in the Windows environment.

An application that provides 5250 emulation can use GetAppcConfig to obtain information about remote APPC

LUs that can be accessed using a given local LU.

If a verb returns with return codes other than

AP_OK, the application can use GetAppcReturnCode to obtain a

text string representation of these return codes, which can be used to generate standard error messages.