handles" /> Hconn (MQHCONN) - output
Home

 

Hconn (MQHCONN) - output

This handle represents the connection to the queue manager. Specify it on all subsequent message queuing calls issued by the application. It ceases to be valid when the MQDISC call is issued, or when the unit of processing that defines the scope of the handle terminates.

Handle scope: The scope of the handle returned depends on the call used to connect to the queue manager (MQCONN or MQCONNX). If the call used is MQCONNX, the scope of the handle also depends on the MQCNO_HANDLE_SHARE_* option specified in the Options field of the MQCNO structure.

The scope of nonshared handles on various platforms is shown in Table 75.

Table 75. Scope of nonshared handles on various platforms
Platform Scope of nonshared handle
z/OS

  • CICS: the CICS task

  • IMS: the task, up to the next syncpoint (excluding subtasks of the task)

  • z/OS batch and TSO: the task (excluding subtasks of the task)

i5/OS Job
UNIX systems Thread
16-bit Windows applications Process
32-bit Windows applications Thread

On z/OS for CICS applications, and on i5/OS for applications running in compatibility mode, the value returned is:

MQHC_DEF_HCONN

Default connection handle.


 

Home