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.
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) USING G32DATAD,R11 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. */ . . .
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.
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 in 3270 Host Connection Program 2.1 and 1.3.3 for AIX: Guide and Reference.