# tibx_MVSConsole_Create

Function

## Purpose

Create or destroy an MVS console.

## C Declaration

    signed long int tibx_MVSConsole_Create (
        void** pConsole,
        char** pConsoleMsg,
        Console_Response pCallBack)

    signed long int tibx_MVSConsole_Destroy(
        void* pConsole );

## COBOL Call

    CALL "tibx_MVSConsole_Create"
         USING BY REFERENCE pConsole,
               BY REFERENCE pConsoleMsg,
               BY VALUE     TIBEMS-NULLPTR,
               RETURNING    tibems-status
    END-CALL.

    CALL "tibx_MVSConsole_Destroy"
         USING BY VALUE pConsole,
         RETURNING tibems-status
    END-CALL.

Note: `pConsole` and `pConsole-Msg` have usage pointer.

## Parameters

Parameter | Description
--- | ---
`pConsole` | The create call stores the MVS console handle in this location. The destroy call destroys this MVS console.
`pConsoleMsg` | When the return status code is non-zero, the function stores an error message in this location.
`pCallBack` | C programs define this callback function to receive the results of MVS console commands.

## Remarks

Some consumer application programs wait indefinitely for messages to arrive. You can use this function in conjunction with `tibems_MVS_BreakFunction` to arrange console input to such programs, in order to interrupt them from waiting to receive a message, so they can exit cleanly (see `tibx_MVSConsole_SetConsumer()`).

C programs can receive console command results through a callback function. COBOL programs cannot receive console command results, but can react to the MVS stop and shut commands.

## See Also

`tibemsMsgConsumer_Receive`

`tibx_MVSConsole_SetConsumer()`

Copyright © Cloud Software Group, Inc. All rights reserved.