status.i4.v = ntv_handle(handle.i4.v [,old_handle.i4.r])
Change the default handle by which ACNET recognizes this
task. As an option, return the previous default handle.
handle longword with the network handle (normally in
Radix-50 characters) which is to become the default
for future network calls. This handle must have
been previously defined by a call to ntv_connect.
[old_handle] longword in which the old default handle is returned.
status VMS completion condition code.
When a USM or request type message is received and the user's
AST routine is called, the handle is temporarily changed to
that of the incoming message for the duration of the AST
routine. NTV_HANDLE must not be called from any AST routine.
Similarly, NTV_CONNECT must not be called from any AST routine
IF it is being called to create a new handle.
This function returns status values as follows:
SS__NORMAL success, default handle changed
SS__INSFARG handle argument not provided
NET__ASTACTIVE cannot perform function at AST level
NET__NOSUCHHAN no such handle found in table
NET__NOTCNCT not yet connected to the network
The following completion codes are indicative of a possible
internal network error:
SS__BADPARAM bad $GETJPI parameter (internal network bug)
This function requires the following include files: