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

IBM z/OS Functions
These functions are implemented only on IBM z/OS platforms.
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 164
tibx_MVSConsole_Create() on page 533
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 532).
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 164
tibx_MVSConsole_SetConsumer() on page 532
Console_Response
Function Type
Purpose
Callback function to relay the results of MVS console commands to C programs.
C Declaration
signed long int
 Console_Response(
    signed long int rc,
    char* ops_command );
Parameters
 
Remarks
Available only in C for z/OS MVS.
COBOL does not support callback functions.
See Also
tibx_MVSConsole_Create() on page 533

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