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

Technical Reference: Communications, Volume 1


G32DLLOC Function

Purpose

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

Syntax

G32DLLOC

Description

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.

Examples

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.        */
.
.
.

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 ]