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_SetConsumer()

tibx_MVSConsole_SetConsumer()
Function
Purpose
Exit from a blocking listener.
C Declaration
tibx_MVSConsole_SetConsumer(
    void* pConsole,
    tibemsMsgConsumer tibemsMsgConsumer,
    char* tibems_MVS_BreakFunction);
 
signed long int tibems_MVS_BreakFunction(
   void* pConsole );
COBOL Call
SET WS-PROCEDURE-PTR TO ENTRY 'tibems_MVS_BreakFunction'
 
CALL "tibx_MVSConsole_SetConsumer"
     USING BY VALUE   pConsole,
           BY VALUE   tibemsMsgConsumer,
           BY VALUE   pFunction,
           RETURNING  tibems-status
END-CALL.
 
pConsole has usage pointer.
Parameters
 
In COBOL, use this tibems_MVS_BreakFunction function address.
Remarks
Programs in single-threaded environments (such as COBOL) need a way to interrupt blocking receive calls (such as tibemsMsgConsumer_Receive).
After registering this function in COBOL, a console stop or shut command causes the receive call to return with a status code TIBEMS_USER_INTR (54).
See Also
tibemsMsgConsumer_Receive on page 168
tibx_MVSConsole_Create() on page 541

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