Starts interaction with an API application running simultaneously on the local system.
G32ALLOC
The G32ALLOC function starts a session with an application program interface (API) application by sending a message to the g32_alloc system call indicating that the allocation is complete. The G32ALLOC function is a HCON API function that can be called by a 370 Assembler application program.
This call sets register 0 to the following values:
The following 370 Assembler code example illustrates the use of the host G32ALLOC function:
L R11,=v(G32DATA) USING G32DATAD,R11 G32ALLOC /* Allocate a session */ LTR R0,R0 BNM OK /* Normal completion */ C R0,G32ESESS /* Session error */ BE SESSERR C R0,G32ESYS /* System error */ BE SYSERR . . .
The G32ALLOC function is part of the Host Connection Program (HCON).
The G32ALLOC 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_get_status subroutine, g32_read subroutine, and g32_write subroutine.
Additional host interface functions are the G32DLLOC function, G32READ function, and G32WRITE function.