[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]

Technical Reference: Communications, Volume 1

G32DLLOC Function


Terminates interaction with an API application running simultaneously on the local system.




The G32DLLOC function ends interaction with an API application. The G32DLLOC function is a HCON API function that can be called by a 370 Assembler applications program.

Return Values

This call sets register 0 (zero) to the following values:

0 Indicates a normal return or a successful call.
< 0 Indicates less than zero. An error condition exists.


The following 370 Assembler code example illustrates the use of the host G32DLLOC function:

L R11,=v(G32DATA)
G32DLLOC                 /* Deallocate a session.   */
C R0, G32ESESS           /* Check for G32 error.    */
BE    SESSERR            /* Branch if error.        */
C R0, G32ESYS            /* Check for system error. */
BE    SYSERR             /* Branch if error.        */

Implementation Specifics

The G32DLLOC function is part of the Host Connection Program (HCON).

The G32DLLOC function requires one or more adapters used to connect to a mainframe host.

Related Information

Session control subroutines are the g32_alloc subroutine, g32_close subroutine, g32_dealloc subroutine, g32_open subroutine, and g32_openx subroutine.

Message interface subroutines are the g32_read subroutine, g32_get_status subroutine, and g32_write subroutine.

Additional host interface functions are the G32ALLOC function, G32READ function, and G32WRITE function.

[ Previous | Next | Table of Contents | Index | Library Home | Legal | Search ]