Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved


Chapter 17 IBM z/OS and IBM i : IBM z/OS Functions : tibx_MVSConsole_Create()

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.
 
pConsole and pConsole-Msg have usage pointer.
Parameters
 
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() on page 540).
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 on page 168
tibx_MVSConsole_SetConsumer() on page 540

Copyright © TIBCO Software Inc. All Rights Reserved
Copyright © TIBCO Software Inc. All Rights Reserved