queue manager connections, threads, secondary connection, connection, secondary" /> Object methods (public)

 

Object methods (public)

void operator = ( const ImqQueueManager & mgr );

Disconnects if necessary, and copies instance data from mgr. The connection status is be FALSE.

ImqBoolean accountingConnOverride ( MQLONG & statint );

Provides a copy of the accounting connections override value. It returns TRUE if successful.

MQLONG accountingConnOverride ( );

Returns the accounting connections override value without any indication of possible errors.

ImqBoolean accountingInterval ( MQLONG & statint );

Provides a copy of the accounting interval value. It returns TRUE if successful.

MQLONG accountingInterval ( );

Returns the accounting interval value without any indication of possible errors.

ImqBoolean activityRecording ( MQLONG & rec );

Provides a copy of the activity recording value. It returns TRUE if successful.

MQLONG activityRecording ( );

Returns the activity recording value without any indication of possible errors.

ImqBoolean adoptNewMCACheck ( MQLONG & check );

Provides a copy of the adopt new MCA check value. It returns TRUE if successful.

MQLONG adoptNewMCACheck ( );

Returns the adopt new MCA check value without any indication of possible errors.

ImqBoolean adoptNewMCAType ( MQLONG & type );

Provides a copy of the adopt new MCA type. It returns TRUE if successful.

MQLONG adoptNewMCAType ( );

Returns the adopt new MCA type without any indication of possible errors.

QLONG authenticationType ( ) const;

Returns the authentication type.

void setAuthenticationType ( const MQLONG type = MQCSP_AUTH_NONE );

Sets the authentication type.

ImqBoolean authorityEvent( MQLONG & event );

Provides a copy of the enablement state of the authority event. It returns TRUE if successful.

MQLONG authorityEvent( );

Returns the enablement state of the authority event without any indication of possible errors.

ImqBoolean backout( );

Backs out uncommitted changes. It returns TRUE if successful.

ImqBoolean begin( );

Begins a unit of work. The begin options affect the behavior of this method. It returns TRUE if successful, but it also returns TRUE even if the underlying MQBEGIN call returns MQRC_NO_EXTERNAL_PARTICIPANTS or MQRC_PARTICIPANT_NOT_AVAILABLE (which are both associated with MQCC_WARNING).

MQLONG beginOptions( ) const ;

Returns the begin options.

void setBeginOptions( const MQLONG options = MQBO_NONE );

Sets the begin options.

ImqBoolean bridgeEvent ( MQLONG & event);

Provides a copy of the bridge event value. It returns TRUE if successful.

MQLONG bridgeEvent ( );

Returns the bridge event value without any indication of possible errors.

ImqBoolean channelAutoDefinition( MQLONG & value );

Provides a copy of the channel auto definition value. It returns TRUE if successful.

MQLONG channelAutoDefinition( );

Returns the channel auto definition value without any indication of possible errors.

ImqBoolean channelAutoDefinitionEvent( MQLONG & value );

Provides a copy of the channel auto definition event value. It returns TRUE if successful.

MQLONG channelAutoDefinitionEvent( );

Returns the channel auto definition event value without any indication of possible errors.

ImqBoolean channelAutoDefinitionExit( ImqString & name );

Provides a copy of the channel auto definition exit name. It returns TRUE if successful.

ImqString channelAutoDefinitionExit( );

Returns the channel auto definition exit name without any indication of possible errors.

ImqBoolean channelEvent ( MQLONG & event);

Provides a copy of the channel event value. It returns TRUE if successful.

MQLONG channelEvent( );

Returns the channel event value without any indication of possible errors.

MQLONG channelInitiatorAdapters ( );

Provides a copy of the channel initiator adapters value. It returns TRUE if successful.

ImqBoolean channelInitiatorAdapters ( MQLONG & adapters );

Returns the channel initiator adapters value without any indication of possible errors.

MQLONG channelInitiatorControl ( );

Provides a copy of the channel initiator control startup value. It returns TRUE if successful.

ImqBoolean channelInitiatorControl ( MQLONG & init );

Returns the channel initiator startup value without any indication of possible errors.

MQLONG channelInitiatorDispatchers ( );

Provides a copy of the channel initiator dispatchers value. It returns TRUE if successful.

ImqBoolean channelInitiatorDispatchers ( MQLONG & dispatchers );

Returns the channel initiator dispatchers value without any indication of possible errors.

MQLONG channelInitiatorTraceAutoStart ( );

Provides a copy of the channel initiator trace auto start value. It returns TRUE if successful.

ImqBoolean channelInitiatorTraceAutoStart ( MQLONG & auto);

Returns the channel initiator trace auto start value without any indication of possible errors.

MQLONG channelInitiatorTraceTableSize ( );

Provides a copy of the channel initiator trace table size value. It returns TRUE if successful.

ImqBoolean channelInitiatorTraceTableSize ( MQLONG & size);

Returns the channel initiator trace table size value without any indication of possible errors.

ImqBoolean channelMonitoring ( MQLONG & monchl );

Provides a copy of the channel monitoring value. It returns TRUE if successful.

MQLONG channelMonitoring ( );

Returns the channel monitoring value without any indication of possible errors.

ImqBoolean channelReference( ImqChannel * & pchannel );

Provides a copy of the channel reference. If the channel reference is invalid, sets pchannel to null. This method returns TRUE if successful.

ImqChannel * channelReference( );

Returns the channel reference without any indication of possible errors.

ImqBoolean setChannelReference( ImqChannel & channel );

Sets the channel reference. This method returns TRUE if successful.

ImqBoolean setChannelReference( ImqChannel * channel = 0 );

Sets or resets the channel reference. This method returns TRUE if successful.

ImqBoolean channelStatistics ( MQLONG & statchl );

Provides a copy of the channel statistics value. It returns TRUE if successful.

MQLONG channelStatistics ( );

Returns the channel statistics value without any indication of possible errors.

ImqBoolean characterSet( MQLONG & ccsid );

Provides a copy of the character set. It returns TRUE if successful.

MQLONG characterSet( );

Returns a copy of the character set, without any indication of possible errors.

MQLONG clientSslKeyResetCount ( ) const;

Returns the SSL key reset count value used on client connections.

void setClientSslKeyResetCount( const MQLONG count );

Sets the SSL key reset count used on client connections.

ImqBoolean clusterSenderMonitoring ( MQLONG & monacls );

Provides a copy of the cluster sender monitoring default value. It returns TRUE if successful.

MQLONG clusterSenderMonitoring ( );

Returns the cluster sender monitoring default value without any indication of possible errors.

ImqBoolean clusterSenderStatistics ( MQLONG & statacls );

Provides a copy of the cluster sender statistics value. It returns TRUE if successful.

MQLONG clusterSenderStatistics ( );

Returns the cluster sender statistics value without any indication of possible errors.

ImqBoolean clusterWorkloadData( ImqString & data );

Provides a copy of the cluster workload exit data. It returns TRUE if successful.

ImqString clusterWorkloadData( );

Returns the cluster workload exit data without any indication of possible errors.

ImqBoolean clusterWorkloadExit( ImqString & name );

Provides a copy of the cluster workload exit name. It returns TRUE if successful.

ImqString clusterWorkloadExit( );

Returns the cluster workload exit name without any indication of possible errors.

ImqBoolean clusterWorkloadLength( MQLONG & length );

Provides a copy of the cluster workload length. It returns TRUE if successful.

MQLONG clusterWorkloadLength( );

Returns the cluster workload length without any indication of possible errors.

ImqBoolean clusterWorkLoadMRU ( MQLONG & mru );

Provides a copy of the cluster workload most recently used channels value. It returns TRUE if successful.

MQLONG clusterWorkLoadMRU ( );

Returns the cluster workload most recently used channels value without any indication of possible errors.

ImqBoolean clusterWorkLoadUseQ ( MQLONG & useq );

Provides a copy of the cluster workload use queue value. It returns TRUE if successful.

MQLONG clusterWorkLoadUseQ ( );

Returns the cluster workload use queue value without any indication of possible errors.

ImqBoolean commandEvent ( MQLONG & event );

Provides a copy of the command event value. It returns TRUE if successful.

MQLONG commandEvent ( );

Returns the command event value without any indication of possible errors.

ImqBoolean commandInputQueueName( ImqString & name );

Provides a copy of the command input queue name. It returns TRUE if successful.

ImqString commandInputQueueName( );

Returns the command input queue name without any indication of possible errors.

ImqBoolean commandLevel( MQLONG & level );

Provides a copy of the command level. It returns TRUE if successful.

MQLONG commandLevel( );

Returns the command level without any indication of possible errors.

MQLONG commandServerControl ( );

Provides a copy of the command server control startup value. It returns TRUE if successful.

ImqBoolean commandServerControl ( MQLONG & server );

Returns the command server startup value without any indication of possible errors.

ImqBoolean commit( );

Commits uncommitted changes. It returns TRUE if successful.

ImqBoolean connect( );

Connects to the queue manager with the given ImqObject name, the default being the local queue manager. If you want to connect to a specific queue manager, use the ImqObject setName method before connection. If there is a channel reference, it is used to pass information about the channel definition to MQCONNX in an MQCD. The ChannelType in the MQCD is set to MQCHT_CLNTCONN. channel reference information, which is only meaningful for client connections, is ignored for server connections. The connect options affect the behavior of this method. This method sets the connection status to TRUE if successful. It returns the new connection status.

If there is a first authentication record, the chain of authentication records is used to authenticate digital certificates for secure client channels.

We can connect more than one ImqQueueManager object to the same queue manager. All use the same MQHCONN connection handle and share UOW functionality for the connection associated with the thread. The first ImqQueueManager to connect obtains the MQHCONN handle. The last ImqQueueManager to disconnect performs the MQDISC.

For a multithreaded program, each thread must use a separate ImqQueueManager object. Connections in different threads have different MQHCONN connection handles.

ImqBin connectionId ( ) const ;

Returns the connection ID.

ImqBinary connectionTag ( ) const ;

Returns the connection tag.

ImqBoolean setConnectionTag ( const MQBYTE128 tag = 0 );

Sets the connection tag. If tag is zero, clears the connection tag. This method returns TRUE if successful.

ImqBoolean setConnectionTag ( const ImqBinary & tag );

Sets the connection tag. The data length of tag must be either zero (to clear the connection tag) or MQ_CONN_TAG_LENGTH. This method returns TRUE if successful.

MQLONG connectOptions( ) const ;

Returns the connect options.

void setConnectOptions( const MQLONG options = MQCNO_NONE );

Sets the connect options.

ImqBoolean connectionStatus( ) const ;

Returns the connection status.

ImqString cryptographicHardware ( );

Returns the cryptographic hardware.

ImqBoolean setCryptographicHardware ( const char * hardware = 0 );

Sets the cryptographic hardware. This method returns TRUE if successful.

ImqBoolean deadLetterQueueName( ImqString & name );

Provides a copy of the dead-letter queue name. It returns TRUE if successful.

ImqString deadLetterQueueName( );

Returns a copy of the dead-letter queue name, without any indication of possible errors.

ImqBoolean defaultTransmissionQueueName( ImqString & name );

Provides a copy of the default transmission queue name. It returns TRUE if successful.

ImqString defaultTransmissionQueueName( );

Returns the default transmission queue name without any indication of possible errors.

ImqBoolean disconnect( );

Disconnects from the queue manager and sets the connection status to FALSE. Closes all ImqProcess and ImqQueue objects associated with this object, and severs their connection reference before disconnection. If more than one ImqQueueManager object is connected to the same queue manager, only the last to disconnect performs a physical disconnection; others perform a logical disconnection. Uncommitted changes are committed on physical disconnection only.

This method returns TRUE if successful. If it is called when there is no existing connection, the return code is also true.

ImqBoolean distributionLists( MQLONG & support );

Provides a copy of the distribution lists value. It returns TRUE if successful.

MQLONG distributionLists( );

Returns the distribution lists value without any indication of possible errors.

ImqBoolean dnsGroup ( ImqString & group );

Provides a copy of the DNS group name. It returns TRUE if successful.

ImqString dnsGroup ( );

Returns the DNS group name without any indication of possible errors.

ImqBoolean dnsWlm ( MQLONG & wlm );

Provides a copy of the DNS WLM value. It returns TRUE if successful.

MQLONG dnsWlm ( );

Returns the DNS WLM value without any indication of possible errors.

ImqAir * firstAuthenticationRecord ( ) const ;

Returns the first authentication record.

void setFirstAuthenticationRecord ( const ImqAir * air = 0 );

Sets the first authentication record.

ImqObject * firstManagedObject( ) const ;

Returns the first managed object.

ImqBoolean inhibitEvent( MQLONG & event );

Provides a copy of the enablement state of the inhibit event. It returns TRUE if successful.

MQLONG inhibitEvent( );

Returns the enablement state of the inhibit event without any indication of possible errors.

ImqBoolean ipAddressV( MQLONG & version );

Provides a copy of the IP address version value. It returns TRUE if successful.

MQLONG ipAddressV( );

Returns the IP address version value without any indication of possible errors.

ImqBoolean keepAlive ( MQLONG & keepalive );

Provides a copy of the keep alive value. It returns TRUE if successful.

MQLONG keepAlive ( );

Returns the keep alive value without any indication of possible errors.

ImqString keyRepository ( );

Returns the key repository.

ImqBoolean setKeyRepository ( const char * repository = 0 );

Sets the key repository. It returns TRUE if successful.

ImqBoolean listenerTimer ( MQLONG & timer );

Provides a copy of the listener timer value. It returns TRUE if successful.

MQLONG listenerTimer ( );

Returns the listener timer value without any indication of possible errors.

ImqBoolean localEvent( MQLONG & event );

Provides a copy of the enablement state of the local event. It returns TRUE if successful.

MQLONG localEvent( );

Returns the enablement state of the local event without any indication of possible errors.

ImqBoolean loggerEvent ( MQLONG & count );

Provides a copy of the logger event value. It returns TRUE if successful.

MQLONG loggerEvent ( );

Returns the logger event value without any indication of possible errors.

ImqBoolean luGroupName ( ImqString & name );.

Provides a copy of the LU group name. It returns TRUE if successful

ImqString luGroupName ( );

Returns the LU group name without any indication of possible errors.

ImqBoolean lu62ARMSuffix ( ImqString & suffix );

Provides a copy of the LU62 ARM suffix. It returns TRUE if successful.

ImqString lu62ARMSuffix ( );

Returns the LU62 ARM suffix without any indication of possible errors

ImqBoolean luName ( ImqString & name );

Provides a copy of the LU name. It returns TRUE if successful.

ImqString luName ( );

Returns the LU name without any indication of possible errors.

ImqBoolean maximumActiveChannels ( MQLONG & channels);

Provides a copy of the maximum active channels value. It returns TRUE if successful.

MQLONG maximumActiveChannels ( );

Returns the maximum active channels value without any indication of possible errors.

ImqBoolean maximumCurrentChannels ( MQLONG & channels );

Provides a copy of the maximum current channels value. It returns TRUE if successful.

MQLONG maximumCurrentChannels ( );

Returns the maximum current channels value without any indication of possible errors.

ImqBoolean maximumHandles( MQLONG & number );

Provides a copy of the maximum handles. It returns TRUE if successful.

MQLONG maximumHandles( );

Returns the maximum handles without any indication of possible errors.

ImqBoolean maximumLu62Channels ( MQLONG & channels );

Provides a copy of the maximum LU62 channels value. It returns TRUE if successful.

MQLONG maximumLu62Channels ( );.

Returns the maximum LU62 channels value without any indication of possible errors

ImqBoolean maximumMessageLength( MQLONG & length );

Provides a copy of the maximum message length. It returns TRUE if successful.

MQLONG maximumMessageLength( );

Returns the maximum message length without any indication of possible errors.

ImqBoolean maximumPriority( MQLONG & priority );

Provides a copy of the maximum priority. It returns TRUE if successful.

MQLONG maximumPriority( );

Returns a copy of the maximum priority, without any indication of possible errors.

ImqBoolean maximumTcpChannels ( MQLONG & channels );

Provides a copy of the maximum TCP channels value. It returns TRUE if successful.

MQLONG maximumTcpChannels ( );

Returns the maximum TCP channels value without any indication of possible errors.

ImqBoolean maximumUncommittedMessages( MQLONG & number );

Provides a copy of the maximum uncommitted messages. It returns TRUE if successful.

MQLONG maximumUncommittedMessages( );

Returns the maximum uncommitted messages without any indication of possible errors.

ImqBoolean mqiAccounting ( MQLONG & statint );

Provides a copy of the MQI accounting value. It returns TRUE if successful.

MQLONG mqiAccounting ( );

Returns the MQI accounting value without any indication of possible errors.

ImqBoolean mqiStatistics ( MQLONG & statmqi );

Provides a copy of the MQI statistics value. It returns TRUE if successful.

MQLONG mqiStatistics ( );

Returns the MQI statistics value without any indication of possible errors.

ImqBoolean outboundPortMax ( MQLONG & max );

Provides a copy of the maximum outbound port value. It returns TRUE if successful.

MQLONG outboundPortMax ( );

Returns the maximum outbound port value without any indication of possible errors.

ImqBoolean outboundPortMin ( MQLONG & min );

Provides a copy of the minimum outbound port value. It returns TRUE if successful.

MQLONG outboundPortMin ( );

Returns the minimum outbound port value without any indication of possible errors.

ImqBinary password ( ) const;

Returns the password used on client connections.

ImqBoolean setPassword ( const ImqString & password );

Sets the password used on client connections.

ImqBoolean setPassword ( const char * = 0 password );

Sets the password used on client connections.

ImqBoolean setPassword ( const ImqBinary & password );

Sets the password used on client connections.

ImqBoolean performanceEvent( MQLONG & event );

Provides a copy of the enablement state of the performance event. It returns TRUE if successful.

MQLONG performanceEvent( );

Returns the enablement state of the performance event without any indication of possible errors.

ImqBoolean platform( MQLONG & platform );

Provides a copy of the platform. It returns TRUE if successful.

MQLONG platform( );

Returns the platform without any indication of possible errors.

ImqBoolean queueAccounting ( MQLONG & acctq );

Provides a copy of the queue accounting value. It returns TRUE if successful.

MQLONG queueAccounting ( );

Returns the queue accounting value without any indication of possible errors.

ImqBoolean queueMonitoring ( MQLONG & monq );

Provides a copy of the queue monitoring value. It returns TRUE if successful.

MQLONG queueMonitoring ( );

Returns the queue monitoring value without any indication of possible errors.

ImqBoolean queueStatistics ( MQLONG & statq );

Provides a copy of the queue statistics value. It returns TRUE if successful.

MQLONG queueStatistics ( );

Returns the queue statistics value without any indication of possible errors.

ImqBoolean receiveTimeout ( MQLONG & timeout );

Provides a copy of the receive timeout value. It returns TRUE if successful.

MQLONG receiveTimeout ( );

Returns the receive timeout value without any indication of possible errors.

ImqBoolean receiveTimeoutMin ( MQLONG & min );

Provides a copy of the minimum receive timeout value. It returns TRUE if successful.

MQLONG receiveTimeoutMin ( );

Returns the minimum receive timeout value without any indication of possible errors.

ImqBoolean receiveTimeoutType ( MQLONG & type );

Provides a copy of the receive timeout type. It returns TRUE if successful.

MQLONG receiveTimeoutType ( );

Returns the receive timeout type without any indication of possible errors.

ImqBoolean remoteEvent( MQLONG & event );

Provides a copy of the enablement state of the remote event. It returns TRUE if successful.

MQLONG remoteEvent( );

Returns the enablement state of the remote event without any indication of possible errors.

ImqBoolean repositoryName( ImqString & name );

Provides a copy of the repository name. It returns TRUE if successful.

ImqString repositoryName( );

Returns the repository name without any indication of possible errors.

ImqBoolean repositoryNamelistName( ImqString & name );

Provides a copy of the repository namelist name. It returns TRUE if successful.

ImqString repositoryNamelistName( );

Returns a copy of the repository namelist name without any indication of possible errors.

ImqBoolean sharedQueueQueueManagerName ( MQLONG & name );

Provides a copy of the shared queue queue manager name value. It returns TRUE if successful.

MQLONG sharedQueueQueueManagerName ( );

Returns the shared queue queue manager name value without any indication of possible errors.

ImqBoolean sslEvent ( MQLONG & event );

Provides a copy of the SSL event value. It returns TRUE if successful.

MQLONG sslEvent ( );

Returns the SSL event value without any indication of possible errors.

ImqBoolean sslFips ( MQLONG & sslfips );

Provides a copy of the SSL FIPS value. It returns TRUE if successful.

MQLONG sslFips ( );

Returns the SSL FIPS value without any indication of possible errors.

ImqBoolean sslKeyResetCount ( MQLONG & count );

Provides a copy of the SSL key reset count value. It returns TRUE if successful.

MQLONG sslKeyResetCount ( );

Returns the SSL key reset count value without any indication of possible errors.

ImqBoolean startStopEvent( MQLONG & event );

Provides a copy of the enablement state of the start-stop event. It returns TRUE if successful.

MQLONG startStopEvent( );

Returns the enablement state of the start-stop event without any indication of possible errors.

ImqBoolean statisticsInterval ( MQLONG & statint );

Provides a copy of the statistics interval value. It returns TRUE if successful.

MQLONG statisticsInterval ( );

Returns the statistics interval value without any indication of possible errors.

ImqBoolean syncPointAvailability( MQLONG & sync );

Provides a copy of the syncpoint availability value. It returns TRUE if successful.

MQLONG syncPointAvailability( );

Returns a copy of the syncpoint availability value, without any indication of possible errors.

ImqBoolean tcpName ( ImqString & name );

Provides a copy of the TCP system name. It returns TRUE if successful.

ImqString tcpName ( );

Returns the TCP system name without any indication of possible errors.

ImqBoolean tcpStackType ( MQLONG & type );

Provides a copy of the TCP stack type. It returns TRUE if successful.

MQLONG tcpStackType ( );

Returns the TCP stack type without any indication of possible errors.

ImqBoolean traceRouteRecording ( MQLONG & routerec );

Provides a copy of the trace route recording value. It returns TRUE if successful.

MQLONG traceRouteRecording ( );

Returns the trace route recording value without any indication of possible errors.

ImqBoolean triggerInterval( MQLONG & interval );

Provides a copy of the trigger interval. It returns TRUE if successful.

MQLONG triggerInterval( );

Returns the trigger interval without any indication of possible errors.

ImqBinary userId ( ) const;

Returns the user ID used on client connections.

ImqBoolean setUserId ( const ImqString & id );

Sets the user ID used on client connections.

ImqBoolean setUserId ( const char * = 0 id );

Sets the user ID used on client connections.

ImqBoolean setUserId ( const ImqBinary & id );

Sets the user ID used on client connections.