TERMAPI call

This call terminates the session created by INITAPI. All TCP/IP stacks resources allocated to the task are cleaned up. This includes any outstanding open sockets or sockets that have been given away with the GIVESOCKET call but have not been taken with a TAKESOCKET call.

In the CICS® environment, the use of TERMAPI is not recommended. CICS task termination processing automatically performs the functions of TERMAPI. A CICS application program should issue TERMAPI only if there is a particular need to terminate the session before task termination.

The following requirements apply to this call:

Requirement	Description
Authorization:	Supervisor state or problem state, any PSW key
Dispatchable unit mode:	Task
Cross memory mode:	PASN = HASN
Amode:	31-bit or 24-bit
ASC mode:	Primary address space control (ASC) mode
Interrupt status:	Enabled for interrupts
Locks:	Unlocked
Control parameters:	All parameters must be addressable by the caller and in the primary address space

Figure 1 shows an example of TERMAPI call instructions.

Figure 1. TERMAPI call instruction example

    WORKING-STORAGE SECTION.
        01  SOC-FUNCTION    PIC X(16)  VALUE IS 'TERMAPI'.

    PROCEDURE DIVISION.
         CALL 'EZASOKET' USING SOC-FUNCTION.

For equivalent PL/I and assembler language declarations, see Converting parameter descriptions.