The tables on this page list all the attributes that you can set for local and remote queue managers. For each attribute, there is a brief description of when you might need to configure the attribute. Where relevant, the tables also give the equivalent MQSC parameter for the ALTER QMGR and DISPLAY QMGR commands. For more information about MQSC commands, see Script (MQSC) Commands in the IBM® onlineWebSphere® MQ information center.
Those attributes for a queue manager that are changed through MQSC using the ALTER QMGR commands are the ones that are shown for both local and remote queue managers. Note, that the WebSphere MQ Explorer does not show all the properties for remote queue managers.
Those attributes that are defined in the qm.ini file (for UNIX systems) or in the Registry (for Windows), are the ones that are shown only for local queue managers. For example, the specification for the Recovery Logs and the XA apply to the qm.ini file, and so, is shown only for the local queue manager.
For lists of all the attributes that you can set for both local and remote queue managers in the queue manager's properties dialog see the following tables:
- General
- Extended
- Exits
- Cluster
- Repository
- Communication
- Events
- SSL
- Statistics
- Online Monitoring
- Statistics Monitoring
- Accounting Monitoring
- Log
- XA resource manager
- Installable services
- Channels
- TCP
- LU6.2
- NetBIOS
- SPX
- Publish/Subscribe
Some of these properties pages are available only on distributed queue managers, such as those running on Windows, AIX®, or Linux (x86 and x86-64 platforms). Properties pages that are not available on z/OS® queue managers are indicated.
The attributes that are marked with an asterisk (*) update configuration files so you can view and edit them when the queue manager is stopped. If you edit the marked attributes when the queue manager is running, you must stop and restart the queue manager so that the changes take effect. You can edit the unmarked attributes only when the queue manager is running. For more information about the configuration attributes, see Changing queue manager configuration information in the IBM online WebSphere MQ information center.
The following tables list the system parameters that you can set for remote z/OS queue managers. These attributes are not displayed in the Queue Manager properties dialog. They are included here because they are still attributes of the queue manager. For more information, seeConfiguring z/OS queue manager system parameters.
- Archive
- Accounting monitoring
- Log
- Security
- System
For more information, see Administering WebSphere MQ and Script (MQSC) Commands in the IBM online WebSphere MQ information center.
General page
The following table lists the attributes that you can set on the General page of the Queue Manager properties dialog. The attributes marked with an asterisk (*) on the General page relate to stanzas in the configuration files.
Attribute | Meaning | MQSC parameter |
---|---|---|
*Queue manager name | Read-only. You cannot change the name of the queue manager after it has been created. | QMNAME |
*Platform | Read-only. This is the architecture of the platform on which the queue manager is running. | PLATFORM |
Queue manager status | Read-only. This attribute shows the status of the queue manager, which can be 1 of the following options:
| STATUS |
Coded character set ID | Read-only. This is the coded character set identifier (CCSID) for the queue manager. The CCSID is the identifier that is used with all character string fields defined by the API. The value must be defined for use on your platform and must use a character set that is appropriate to the platform. | CCSID |
Description | Type a meaningful description of the purpose of the queue manager. See Entering strings in WebSphere MQ Explorer. | DESCR |
*Command level | Read-only. This is the function level of the queue manager. | CMDLEVEL |
Version | Read only. This is the version of WebSphere MQ installed. The format is VVRRMMFF:
| VERSION |
*Startup | The Startup attribute controls how the selected queue manager is started. This attribute applies to Windows only. There are four options for the Startup attribute.
Select Automatic to start the queue manager automatically when the IBM MQ Series service starts. This is the default value.
Select Automatic, permitting multiple instances of the queue manager, to start the queue manager automatically when the IBM MQ Series service starts. For more information, see the sax option of crtmqm in the IBM onlineWebSphere MQ information center.
Select Interactive (manual) to start the queue manager manually through WebSphere MQ Explorer. The queue manager runs under the logged on user (the interactive user). The queue manager will automatically stop when the interactive user logs off.
Select Service (manual) to start the queue manager manually through WebSphere MQ Explorer. The queue manager runs as a child of the MQ Services service. The queue manager will not automatically stop when the interactive user logs off.
| (Not applicable.) |
Command server control | To configure the command server so that it starts automatically when the queue manager starts, click Queue Manager; to configure the command server so that it does not start automatically and must be started manually, click Manual. | SCMDSERV |
Channel init control | To configure the channel initiator so that it starts automatically when the queue manager starts, click Queue Manager; to configure the channel initiator so that it does not start automatically and must be started manually, click Manual. | SCHINIT |
Extended page
The following table lists the attributes that you can set on the Extended page of the Queue Manager properties dialog. The Default bind typeattribute on the Extended page relates to the DefaultBindType stanza key in the configuration files.
Attribute | Meaning | MQSC parameter |
---|---|---|
Dead-letter queue | Select the name of the queue that the queue manager uses as the dead-letter queue. | DEADQ |
Trigger interval | Type the number of milliseconds, from 0 to 999999999, that the queue manager must wait between triggering messages for a queue. This attribute is used only when the Trigger type attribute in the Queue properties is set toFirst. | TRIGINT |
Max uncommitted messages | Type the maximum number of uncommitted messages within a syncpoint, from 1 to 999999999, to limit the number of messages that can be retrieved and put within any single syncpoint. This attribute is not used for messages that are put or retrieved outside syncpoint. | MAXUMSGS |
Max handles | Type the maximum number of open handles, from 0 to 999999999, that any one task can have at the same time. | MAXHANDS |
Max message length | Type the maximum length of messages, from 32 KB to 100 MB, that is allowed on queues on the queue manager. The default value is 4 MB (4 194 304 bytes). If you reduce the maximum message length for the queue manager, you must also reduce the maximum length of the SYTEM.DEFAULT.LOCAL.QUEUE definition, and all other queues that are connected to the queue manager. This ensures that the queue manager's limit is not less than the limit of any of the queue manager's queues. If you do not do this, and applications inquire only the value of the queue's Max message length attribute, the applications might not work properly. | MAXMSGL |
Max properties length | This value controls the size in bytes of the property data that can flow with messages in a V7 queue manager. If the size of the properties exceeds the maximum properties length then the message is rejected. | MAXPROPL |
Max priority | Read-only. This is the maximum priority of the queue manager, which is 9. | MAXPRTY |
Message mark browse interval | Type the time interval in milliseconds after which the queue manager automatically unmarks browsed messages. The interval can be set from 0 to 999999999 milliseconds. The interval can also be set to Unlimited. The default value is 5000. | MARKINT |
Command input queue | Read-only. This is the name of the system-command input queue. Suitably authorized applications can put commands on this queue. | COMMANDQ |
Syncpoint | Read-only. This attribute states whether syncpoint is available with the queue manager. On z/OS, Windows, UNIX and Linux syncpoint is always available. | SYNCPT |
Distribution lists | Read-only. This attribute states whether the queue manager supports distribution lists. This attribute is valid only on AIX, HP-UX, IBM i, Solaris, andWindows. | DISTL |
(UNIX and Linux only) Application group | The Application group option specifies the application group that clients connecting should belong to. The default is to not belong to an application group. | (Not applicable.) |
*Default bind type | This is the default bind type that is used if the application does not specify a bind type on the MQCNO parameter of the MQCONNX call. Select SHARED, orISOLATED. | (Not applicable.) |
*Error log size | Specify the size of the queue manager error log at which the log is copied to the backup. The value must be 1048576 - 2147483648 bytes. The default value is 262144 bytes (256 KB). | (Not applicable.) |
*Excluded messages | Your WebSphere MQ system might produce a large number of information messages if the system is heavily used. You can therefore exclude certain messages if required. Type the message ID of each message that is not to be written to the queue manager error log. Enter a comma-separated list of message IDs from the following list:
| (Not applicable.) |
*Suppressed messages | Your WebSphere MQ system might produce a large number of information messages if the system is heavily used. You can prevent selected messages being sent to the console or to the hardcopy log if required. Type the message ID of each message that will be written to the queue manager error log only once in a specified time interval. The time interval is specified in theSuppressed Messages Interval attribute. Enter a comma-separated list of message IDs from the following list:
If the same message ID is specified in both the Excluded Messages and theSuppressed Messages attributes, the message is excluded.
| (Not applicable.) |
*Suppressed messages interval | Type the time interval, in seconds, in which messages that are specified in theSuppressed Messages attribute will be written to the queue manager error log only once. The value must be 1 - 86400 seconds. The default value is 30 seconds. | (Not applicable.) |
Custom | The Custom parameter is reserved for the configuration of new features before separate attributes have been introduced. The possible values are a list of zero or more attributes-value pairs, in MQSC-style syntax, separated by at least 1 space.
The attribute names and values are case-sensitive, and must be specified in uppercase. The values can contain spaces and parentheses, but must not contain single quotation marks. Examples of valid syntax are:
The queue manager parses the value, but if the string cannot be parsed according to these rules, or if it contains attributes or values that are not recognized, the queue manager ignores the errors.
| CUSTOM |
Opening shared queues | (z/OS only) When a queue manager makes an MQOPEN call for a shared queue and the queue manager that is specified in the ObjectQmgrName parameter of the MQOPEN call is in the same queue-sharing group as the processing queue manager, the Opening shared queues attribute specifies whether theObjectQmgrName is used or whether the processing queue manager opens the shared queue directly. Use the queue manager specified inObjectQmgrName means that the ObjectQmgrName is used, and the appropriate transmission queue is opened; Use the local queue managermeans that the processing queue manager opens the shared queue directly, which can reduce the traffic in your queue manager network. | SQQMNAME |
Intra-group queuing | (z/OS only) Specify whether intra-group queuing is used. To use the shared transmission queue (SYSTEM.QSG.TRANSMIT.QUEUE) when queue managers within a queue-sharing group exchange messages, click Enabled; to use non-shared transmission queues and channels when queue managers within a queue-sharing group exchanged messages, click Disabled. If you disable intra-group queuing, the same mechanism for message transfer is used as when the queue managers are not part of a queue-sharing group. | IGQ |
IGQ user ID | (z/OS only) Specify a user identifier to be used by the IGQ agent to establish authority to put messages to a destination queue. The queue manager must be a member of a queue-sharing group to use this attribute. To specify that the user ID of the receiving queue manager within the queue-sharing group is to be used as the IGQ user ID, leave the field blank. | IGQUSER |
IGQ authority check type | (z/OS only) Specify the type of authority checking and, therefore, the user identifiers, to be used by the IGQ agent. This establishes the authority to put messages to the destination queue. The queue manager must be a member of a queue-sharing group to use this attribute. To specify that the default user ID is used to establish authority, click Default; to specify that the IGQ user ID and the ALT user ID is used to establish authority, click Alternate or IGQ; to specify that only the IGQ user ID is used to establish authority, click Only IGQ; to specify that the user ID from the UserIdentifier field in the message descriptor, of a message on the SYSTEM.QSG.TRANSMIT.QUEUE queue, is used to establish authority, click Context. | IGQAUT |
Expiry interval | (z/OS only) Type the approximate value in seconds that specifies how often queues are scanned to discard expired messages. the value must be 1 - 99999999. The minimum scan interval is 5 seconds, even if you specify a lower value 1 - 4. Specify an interval of 0 to ensure that the queues are not scanned; this is the default value. | EXPRYINT |
Security profile case | (z/OS only) Specify whether the queue manager supports security profile names in mixed case or in uppercase only. Select Mixed to specify that security names can be in uppercase or in mixed case. Select Upper to specify that security profile names must be in uppercase. This is the default value. | SCYCASE |
Exits page (not z/OS)
The following table lists the attributes that you can set on the Exits page of the Queue Manager properties dialog. To configure the queue manager to run user exits, edit the attributes on the Exits page. The attributes on the Exits page relate to stanzas in the configuration files.
Attribute | Meaning | Stanza key |
---|---|---|
*Exit default path | If the queue manager is 32 bit, type the path to the location in which exits for this queue manager are stored by default. | ExitsDefaultPath |
*Exit default path (64 bit) | If the queue manager is 64 bit, type the path to the location in which exits for this queue manager are stored by default. | ExitsDefaultPath64 |
*Local API Exits | Add details of the local API exits that you want to use with this queue manager. | ApiExitLocal |
*Name | Specifies the descriptive name of the API exit that is passed to the API exit in the ExitInfoName field of the MQAXP structure. This name must be unique and is limited to a length of 48 characters, and must contain only those characters that are valid for the name of WebSphere MQ objects, such as queue names. | Name |
*Type | Specifies the type of exit: queue manager, or override. | (Not a separate stanza key.) |
*Sequence | This attribute is an unsigned numeric value that defines the sequence in which this API exit is called in comparison with other API exits. An API exit with a low sequence number is called before another API exit with a higher sequence number. The order in which different API exits with the same sequence number are called is undefined. It is perfectly valid for there to be gaps in the sequence numbers of the API exits defined for a queue manager. | Sequence |
*Module | Specifies the module that contains the code for the API exit. If this field contains the full path name of the module it is used as is. If this field contains just the module name, the module is located using the same method as channel exits; that is, using the value in the Exit default path field on the Exits page of the queue manager properties dialog. | Module |
*Function | Specifies the name of the function entry-point into the module that contains the code for the API exit. This entry-point is the MQ_INIT_EXIT function. The length of this field is limited to MQ_EXIT_NAME_LENGTH. | Function |
*Data | If this attribute is specified, leading and trailing blanks are removed, the remaining string is truncated to 32 characters, and the result is passed to the exit in the ExitData field of the MQAXP structure. If this attribute is not specified, the default value of 32 blanks is passed to the exit in the ExitData field of the MQAXP structure. | Data |
Cluster page
The following table lists the attributes that you can set on the Cluster page of the Queue Manager properties dialog. To configure the cluster attributes of the queue manager, edit the attributes on the Cluster page.
Attribute | Meaning | MQSC parameter |
---|---|---|
Cluster membership | Read-only. This table lists the names of the clusters to which the queue manager belongs. | (Not applicable.) |
Cluster workload exit | The exit is called when a message is put on a cluster queue. Type the name of the cluster workload exit:
| CLWLEXIT |
Cluster workload data | Type the data to be passed to the cluster workload exit when the exit is called. The maximum length of the data is 32 characters. | CLWLDATA |
Cluster workload length | Type the maximum number of bytes of message data that is passed to the cluster workload exit:
| CLWLLEN |
Max outbound cluster channels | Type the maximum number of outbound cluster channels. For more information, see Queue manager clusters in the IBM online WebSphere MQ information center. | CLWLMRUC |
Cluster workload mode | The cluster workload exit, CLWL, allows you to specify which cluster queue in the cluster is to be opened in response to an MQI call (for example MQOPEN or MQPUT). The default value is SAFE, which means that the CLWL exit is run in a separate process to the queue manager so that if there is a problem, the integrity of the queue manager is preserved. However, running the CLWL exit as a separate process can have a detrimental effect on performance. To improve performance by running the CLWL exit in the same process as the queue manager, click FAST. Use FAST mode only if you are certain that there are no problems with your CLWL exit because if there is a problem in FAST mode, the queue manager fails and the queue manager's integrity is at risk. The value set for the queue manager will override the value set for the machine-wide configuration. | CLWLMode |
CLWL use queue | This attribute specifies whether the queue manager can choose from remote instances of cluster queues as well as local instances. If the queue manager receives a message by way of a cluster channel, the message is put on a local instance of the cluster queue; if the queue manager receives a message locally or by way of a non-cluster channel, and the value of this attribute is Any, the message is put on either local or remote instances of the cluster queue. To enable the queue manager to use remote instances of cluster queues, click Any; to prevent the queue manager using remote instances of cluster queues, click Local. For more information, see Queue manager clusters in the IBM online WebSphere MQ information center. | CLWLUSEQ |
Default cluster transmission queue | The default transmission queue type that is used by clustering to transfer messages to other queue managers in the cluster. Messages are transferred by cluster-sender channels.
The default value of this attribute is SCTQ. The queue manager uses a single transmission queue to transfer all cluster messages. The transmission queue is SYSTEM.CLUSTER.TRANSMIT.QUEUE.
To send messages to each queue manager, in each cluster, using a different transmission queue, set the value ofDefault cluster transmission queue to Queue for each channel. The queue manager automatically creates a transmission queue if it needs one to send a message to another queue manager in a cluster. The queue is permanent-dynamic. It is created from the model queue SYSTEM.CLUSTER.TRANSMIT.MODEL.QUEUE. The name of each transmission queue is SYSTEM.CLUSTER.TRANSMIT.ChannelName. ChannelName is the name of the cluster-sender channel that transfers messages from the queue.
| DEFCLXQ |
Repository page
The following table lists the attributes that you can set on the Repository page of the Queue Manager properties dialog. To specify that the queue manager hosts the repository for one or more clusters, edit the attributes on the Repository page.
Attribute | Meaning | MQSC parameter |
---|---|---|
Not a cluster full repository | To specify that the queue manager is not a full repository for a cluster, select this option. | (Not applicable.) |
Full repository for a cluster | To make this queue manager a full repository for just one cluster, select this option, then type the name of the cluster. | REPOS |
Full repository for a list of clusters | To make this queue manager a full repository for more than one cluster, select this option, then type the name of the cluster. | REPOSNL |
Communication page
The following table lists the attributes that you can set on the Communication page of the Queue Manager properties dialog. To configure how the queue manager sends and receives messages, edit the attributes on the Communication page.
Attribute | Meaning | MQSC parameter |
---|---|---|
Default transmission queue | Type the name of the default transmission queue on which messages that are destined for a remote queue manager are put if there is no other suitable transmission queue defined. The queue named must be a local transmission queue, but not the cluster transmission queue. | DEFXMITQ |
Channel auto definition | To enable receiver- and server-connection channels to be defined automatically, click Enabled; to prevent receiver- and server-connection channels being defined automatically, click Disabled. Cluster-sender channels can always be defined automatically, regardless of the setting of this attribute. | CHAD |
Channel auto definition exit | The exit is called when an inbound request for an undefined receiver, server-connection, or cluster-sender channel is received. The exit is also called when starting a cluster-receiver channel. Type the name of the channel auto-definition exit:
| CHADEXIT |
Channel authentication | To exercise more precise control over the access granted to connecting systems at a channel level, you can use channel authentication records. WebSphere MQ version 7.1, and later, queue managers are created using channel authentication by default. If you migrate a queue manager to WebSphere MQ Version 7.1 from an earlier release, channel authentication is not enabled. To enable channel authentication, use the command ALTER QMGR CHLAUTH(ENABLED) | CHLAUTH |
IP address version | To specify that the queue manager uses the IPv6 protocol, click IPV6; to specify that the queue manager uses the IPv4 protocol, click IPV4. | IPADDRV |
Activity recording | If a queue manager application performs some work on behalf of a message in which activity reports were requested, the queue manager can generate an activity report. You can use this activity report to work out where the message went in the queue manager network. To prevent queue manager applications generating activity reports, click Disabled; to enable queue manager applications to generate activity reports, clickMessage or Queue. If you click Message, a queue manager application that generates an activity report puts the report on the queue that the originator of the message requested in the ReplyToQ and ReplyToQMgr fields of the message descriptor; if you click Queue, a queue manager application that generates an activity report puts the report on the system queue SYSTEM.ADMIN.ACTIVITY.QUEUE. If you make changes to this attribute, you must stop and restart any channels to which you want the changes to apply. | ACTIVREC |
Trace-Route recording | You can use Trace-Route messages to determine the routes that messages take through a queue manager network. Participating queue manager applications can generate information about the route and put the information in activity reports. The queue manager applications can also add the information to the Trace-Route message itself, depending on the options set in the Trace-Route message. The Trace-Route message can then accumulate chronological information about the route. The Activity recording attribute specifies on which queue the activity reports are put. The Trace-route recording attribute controls the accumulation of information in the Trace-Route message itself. To prevent the queue manager appending route information within the Trace-Route message and from returning information in reply messages, click Disabled. To enable queue manager applications to add the route information to the Trace-Route message, click Message or Queue. If you click Message and a queue manager application generates a reply message containing the accumulated route information from the Trace-Route message, the queue manager application puts the reply message on the queue that the originator of the message requested in the ReplyToQ and ReplyToQMgr fields of the message descriptor; if you click Queue and a queue manager application generates a reply message containing the accumulated route information from the Trace-Route message, the queue manager application puts the reply message on the system queue SYSTEM.ADMIN.TRACE.ROUTE.QUEUE. If you make changes to this attribute, you must stop and restart any channels to which you want the changes to apply. | ROUTEREC |
Events page
The following table lists the attributes that you can set on the Events page of the Queue Manager properties dialog. To configure the queue manager to generate events in response to certain criteria, edit the attributes on the Events page.
Attribute | Meaning | MQSC parameter |
---|---|---|
Authority events | When an application tries to open a queue for which the application does not have the required authority, the queue manager can generate an authorization event message. To generate authorization event messages, clickEnabled; to prevent the queue manager generating authorization event messages, click Disabled. | AUTHOREV |
Inhibit events | When an application tries to put a message on a queue that is put-inhibited, or to get a message from a queue that is get-inhibited, the queue manager can generate an inhibit event message. To generate inhibit event messages, click Enabled; to prevent the queue manager generating inhibit event messages, click Disabled. | INHIBTEV |
Local events | When an application or the queue manager has not been able to access an object, for example because the object has not been defined, the queue manager can generate a local event message. To generate local event messages, click Enabled; to prevent the queue manager generating local event messages, click Disabled. | LOCALEV |
Remote events | When an application or the queue manager cannot access a queue on another queue manager, for example the transmission queue is not correctly defined, the queue manager can generate a remote event message. To generate remote event messages, click Enabled; to prevent the queue manager generating remote event message, click Disabled. | REMOTEEV |
Start and stop events | When a queue manager starts, or has been requested to stop or quiesce (z/OS supports only start), the queue manager can generate a start and stop event message. To generate start and stop event messages, clickEnabled; to prevent the queue manager generating start and stop messages, click Disabled. | STRSTPEV |
Performance events | When a resource reaches a threshold condition, for example a queue depth limit has been reached, the queue manager can generate a performance event message. To generate performance event messages, click Enabled; to prevent the queue manager generating performance event messages, click Disabled. | PERFMEV |
Command events | When an MQSC command or PCF command is executed successfully, the queue manager can generate command event messages. To generate command event messages, click Enabled; to prevent the queue manager generating command events, click Disabled; to generate command event messages except DISPLAY MQSC commands and Inquire PCF commands, click No Display. | CMDEV |
Channel events | When the queue manager detects certain conditions on a channel, for example the channel starts or stops, the queue manager can generate channel event messages. To generate channel event messages, click Enabled; to prevent the queue manager generating channel event messages, click Disabled. | CHLEV |
Channel auto definition events | When a channel is automatically generated, the queue manager can generate a channel auto-definition event message. To generate channel auto-definition event messages, click Enabled; to prevent the queue manager generating channel auto-definition event messages, click Disabled. | CHADEV |
SSL events | When a channel that uses Secure Sockets Layer (SSL) security fails to establish an SSL connection, the queue manager can generate an SSL event message. To generate SSL event messages, click Enabled; to prevent the queue manager generating SSL event messages, click Disabled. | SSLEV |
Configuration events | When an object is created or modified, the queue manager can generate a configuration event message. To generate configuration event messages, click Enabled; to prevent the queue manager generating configuration event messages, click Disabled. | CONFIGEV |
Bridge events | (z/OS only) When an IMS™ bridge starts or stops, the queue manager can generate a bridge event message. To generate bridge event messages, click Enabled; to prevent the queue manager generating bridge event messages, click Disabled. | BRIDGEEV |
Logger events | When a queue manager is configured to use linear logging, the queue manager can be configured to generate a logger event message when changes are written to the WebSphere MQ recovery log. To generate logger event messages, click Enabled; to prevent the queue manager generating logger event messages, click Disabled. | LOGGEREV |
SSL page
The following table lists the attributes that you can set on the SSL page of the Queue Manager properties dialog. To configure the queue manager and its channels to use SSL security, edit the attributes on the SSL page.
Attribute | Meaning | MQSC parameter |
---|---|---|
Key repository | Type the full path to the key repository for the queue manager. | SSLKEYR |
Revocation namelist | Type the name of the revocation namelist. The revocation namelist can contain a mixture of authentication information objects from either, or both, of the following types:
| SSLCRLNL |
Cryptographic hardware | To configure your cryptographic hardware, click Configure In the Cryptographic hardware settings dialog, enter the details of your cryptographic hardware. | SSLCRYP |
SSL Reset Count | Type the number of unencrypted bytes, from 0 to 999999999, that are sent and received within an SSL conversation before the secret key is renegotiated. A value of 0 means that the secret key is never renegotiated. The number of bytes includes control information that is sent by the message channel agent (MCA). If the value of this attribute is greater than 0 and the value of the Heartbeat interval attribute in the Channel properties is greater than 0, the secret key is also renegotiated before message data is sent or received following a channel heartbeat. | SSLRKEYC |
SSL FIPS required | To specify whether only FIPS-certified cryptographic algorithms are to be used (if the cryptography is performed in WebSphere MQrather than cryptographic hardware), clickYes. To specify that any cryptographic algorithm can be used, click No. | SSLFIPS |
OCSP authentication | The OCSP authentication setting dictates the outcome of a connection in the event of an 'Unknown' response from the OCSP call.
| N/A |
OCSP check extensions | The OCSP check extensions attribute controls whether the OCSP server details in AuthorityInfoAccess certificate extensions, are used to perform a digital revocation check. There are 2 possible values for the attribute:
| N/A |
SSL HTTP proxy name | The SSL HTTP proxy name is either the host name or network address of the HTTP proxy server which is to be used by GSKit for OCSP checks. This address can optionally be followed by a port number, enclosed in parentheses. If you do not specify the port number, the default HTTP port, 80, is used. | N/A |
Suite B strength | The Suite B strength attribute controls whether Suite B encryption is used. There are four possible values for the attribute:
| SUITEB |
Certificate validation policy | The certificate validation policy attribute controls which SSL/TLS certificate validation policy is used to validate digital certificates received from remote partners. There are two possible values for the attribute:
| CERTVPOL |
Statistics page
The following table lists the attributes on the Statistics page of the Queue Manager properties dialog. The Statistics page displays the information about the history of the queue manager. You cannot edit any of these attributes.
Attribute | Meaning | MQSC parameter |
---|---|---|
Creation date | Read-only. This is the date on which the queue was created. | CRDATE |
Creation time | Read-only. This is the time at which the queue was created. | CRTIME |
Alteration date | Read-only. This is the date on which the queue's attributes were last altered. | ALTDATE |
Alteration time | Read-only. This is the time at which the queue's attributes were last altered. | ALTTIME |
QMID | Read-only. This is the internally-generated unique name of the queue manager. | QMID |
Online monitoring
The following table lists the attributes that you can set on the Online monitoring page of the Queue Manager properties dialog. To collect data about the current performance of the queue manager's channels and queues, edit the attributes on the Online monitoring page.
Attribute | Meaning | MQSC parameter |
---|---|---|
Channel monitoring | This attribute specifies whether to collect online monitoring data about the current performance of channels hosted by the queue manager. To switch off online monitoring data collection for the queue manager's channels that have the value Queue Manager in their Channel monitoring attribute, click Off; to switch off online monitoring data collection for all the queue manager's channels regardless of the setting of the channel's Channel monitoringattribute, click None. To specify a low rate of data collection, with a minimal effect on system performance, for channels that have the value Queue Manager in their Channel monitoring attribute, click Low; to specify a moderate rate of data collection, with limited effect on system performance, for channels that have the value Queue Manager in their Channel monitoring attribute, click Medium; to specify a high rate of data collection, with a likely effect on system performance, for channels that have the value Queue Manager in their Channel monitoringattribute, click High. | MONCHL |
Queue monitoring | This attribute specifies whether to collect online monitoring data about the current performance of queues hosted by the queue manager. To switch off online monitoring data collection for the queue manager's queues that have the value Queue Manager in their Queue monitoring attribute, click Off; to switch off online monitoring data collection for all the queue manager's queues regardless of the setting of the queue's Queue monitoring attribute, clickNone. To specify a low rate of data collection, with a minimal effect on system performance, for queues that have the value Queue Manager in their Queue monitoring attribute, click Low; to specify a moderate rate of data collection, with limited effect on system performance, for queues that have the value Queue Manager in their Queue monitoring attribute, click Medium; to specify a high rate of data collection, with a likely effect on system performance, for queues that have the value Queue Manager in their Queue monitoring attribute, click High. | MONQ |
Auto CLUSSDR monitoring | This attribute specifies whether to collect online monitoring data about the current performance of auto-defined cluster-sender channels. To inherit from the value of the queue manager's Channel monitoring attribute, clickQueue Manager; to switch off data collection for auto-defined cluster-sender channels on the queue manager, click None; to specify a low rate of data collection with a minimal effect on system performance, click Low (the data that is collected is unlikely to be the most current); to specify a moderate rate of data collection with limited effect on system performance, click Medium; to specify a high rate of data collection with a likely effect on system performance, click High (the data that is collected is the most current available). | MONACLS |
Statistics monitoring (not z/OS)
The following table lists the attributes that you can set on the Statistics monitoring page of the Queue Manager properties dialog. To collect statistical data on the activity of the queue manager, edit the attributes on the Statistics monitoring page.
Attribute | Meaning | MQSC parameter |
---|---|---|
MQI Statistics | To collect MQI statistics data for the queue manager, click On; to prevent MQI statistics monitoring data collection for the queue manager, click Off. | STATMQI |
Queue Statistics | This attribute specifies whether to collect statistics data about the activity of queues hosted by the queue manager. To switch on statistics data collection for the queue manager's queues, click On; to switch off statistics data collection for the queue manager's queues that have the value Queue Manager in their Queue statistics attribute (see Queue properties), click Off; to switch off statistics data collection for all the queue manager's queues regardless of the setting of the queue's Queue statistics attribute, click None. | STATQ |
Channel Statistics | This attribute specifies whether to collect statistics data about the activity of channels hosted by the queue manager. To switch off statistics data collection for the queue manager's channels that have the value Queue Manager in their Channel statistics attribute (see Channel properties), click Off; to switch off statistics data collection for all the queue manager's channels regardless of the setting of the channel's Channel statisticsattribute, click None. To specify a low rate of data collection, with a minimal effect on system performance, for channels that have the value Queue Manager in their Channel statistics attribute, click Low; to specify a moderate rate of data collection, with limited effect on system performance, for channels that have the value Queue Manager in their Channel statistics attribute, click Medium; to specify a high rate of data collection, with a likely effect on system performance, for channels that have the value Queue Manager in their Channel statisticsattribute, click High. | STATCHL |
Auto CLUSSDR Statistics | This attribute specifies whether to collect statistics data about the activity of auto-defined cluster-sender channels. To inherit from the value of the queue manager's Channel statistics attribute, click Queue Manager; to switch off data collection for auto-defined cluster-sender channels on the queue manager, click None; to specify a low rate of data collection, click Low (the data that is collected is unlikely to be the most current); to specify a moderate rate of data collection, click Medium; to specify a high rate of data collection, click High (the data that is collected is the most current available). | STATACLS |
Statistics Interval | Type the interval, in seconds, between writing the statistics monitoring data to the monitoring queue. The default value is 1800 seconds (30 minutes). | STATINT |
Accounting monitoring (not z/OS)
The following table lists the attributes that you can set on the Accounting monitoring page of the Queue Manager properties dialog. To collect data about the activity of a connection, edit the attributes on the Accounting monitoring page. For z/OS Account monitoring settings, see Accounting monitoring (z/OS only).
Attribute | Meaning | MQSC parameter |
---|---|---|
MQI accounting | To collect MQI accounting data for the queue manager, click On; to prevent MQI accounting monitoring data collection for the queue manager, click Off. | ACCTMQI |
Queue accounting | This attribute specifies whether to collect accounting data about the activity of connections for queues hosted by the queue manager. To switch on accounting data collection for the queue manager's queues, click On; to switch off accounting data collection for the queue manager's queues that have the value Queue Manager in their Queue accounting attribute (see Queue properties), click Off; to switch off accounting data collection for all the queue manager's queues regardless of the setting of the queue's Queue accounting attribute, click None. | ACCTQ |
Accounting interval | Type the interval, in seconds, between writing the accounting monitoring data to the monitoring queue. The default value is 1800 seconds (30 minutes). | ACCTINT |
Accounting conn override | Applications can override the MQI accounting attribute and the Queue accounting attribute using the Connect options in MQCONNX calls. To enable applications to override the attributes, click Enabled; to prevent applications overriding the attributes, click Disabled. | ACCTCONO |
Log page (not z/OS)
The following table lists the attributes that you can set on the Log page of the Queue Manager properties dialog. To configure the log settings for the queue manager, edit the attributes on the Log page. The attributes on the Log page relate to stanzas in the configuration files. Forz/OS log settings, see Log (z/OS only).
Attribute | Meaning | Stanza key |
---|---|---|
*Log type | Read-only. This attribute shows the type of logging that the queue manager uses. You cannot change the type of logging after the queue manager is created. | LogType |
*Log path | Read-only. This attribute shows the location of the queue manager's logs. You cannot change the value of theLog path attribute after the queue manager is created. | LogDefaultPath |
*Log file pages | Read-only. This attribute shows the number of 4 KB pages in the log file. For example, if the value is 256, the file size is 1 MB.
The default value is 4096, the file size 16 MB.
| LogFileSize |
*Log primary files | These are the log files that are allocated when the queue manager is created.
On Windows, type the number, from 2 to 254, of primary log files. The default value is 3. The total number of primary and secondary log files must not exceed 255 and must not be less than 3.
On UNIX and Linux, type the number, from 2 to 510, of primary log files. The default value is 3. The total number of primary and secondary log files must not exceed 511 and must not be less than 3.
The value is examined when the queue manager is created or started. You can change the value after the queue manager has been created but the change is not effective until the queue manager is restarted.
| LogPrimaryFiles |
*Log secondary files | These are the log files that are allocated when the primary files are exhausted.
On Windows, type the number, from 1 to 253, of secondary log files. The default value is 3. The total number of primary and secondary log files must not exceed 255 and must not be less than 3.
On UNIX and Linux, type the number, from 1 to 509, of secondary log files. The default value is 3. The total number of primary and secondary log files must not exceed 511 and must not be less than 3. | LogSecondaryFiles |
*Log buffer pages | Type the number, from 0 to 4096, of 4 KB buffer pages for writing. If you type a number from 1 to 17, the minimum of 18 (72 KB) is used. If you type a number from 18 to 4096, that number of pages is used. If you type 0, the queue manager selects the size. In WebSphere MQ for Windows Version 7.0 and alter, this is 512 (2048 KB).
The default value is 0 (Which the queue manger selects as 512 (2048 KB). If you change the value of this property, restart the queue manager to apply the change.
| LogBufferPages |
*Log write integrity | This is the method that the logger uses to reliably write log records. If you are using a non-volatile write cache (for example, ssa write cache enabled), it is safe for the logger to write log records in a single write, so clickSingleWrite; if you need to write log records with more integrity, click DoubleWrite to use an additional write; if you need to write log records with complete integrity but at the cost of performance, click TripleWriteto use another additional write. | LogWriteIntegrity |
XA resource managers (not z/OS)
The following table lists the attributes that you can set on the XA resource manager page of the Queue Manager properties dialog. The XA resource manager page displays attributes to edit if the queue manager coordinates its own units of work along with database updates; for example, the name of the resource manager (the database) and the location of the switch file, which helps the WebSphere MQ communicate with the database. The attributes on the XA resource manager page relate to the XAResourceManager stanza in the configuration files.
Attribute | Meaning | Stanza key |
---|---|---|
*Name | Type the name of the resource manager (the database). | Name |
*SwitchFile | Type the location of the switch file, which helps WebSphere MQ to communicate with the database. | SwitchFile |
*XAOpenString | You can type a string of data that WebSphere MQ passes in its calls to the database manager's xa_open function. WebSphere MQ and the queue manager call the xa_open function when the queue manager starts and when you make the first call to MQBEGIN in your WebSphere MQ application process. The default is a zero-length string. | XAOpenString |
*XACloseString | You can type a string of data that WebSphere MQ passes in its calls to the database manager's xa_close function. WebSphere MQ and the queue manager call the xa_close function when the queue manager starts and when you make a call to MQDISC in your WebSphere MQ application process, having earlier made a call to MQBEGIN. The default is a zero-length string. It is common to have a zero-length string. | XACloseString |
*ThreadOfControl | The queue manager uses this value for serialization purposes. If the database client allows threads to call the XA functions without serialization, the value for ThreadOfControl can be THREAD. If the database client does not allow threads to call its XA functions in this way, the value for ThreadOfControl must bePROCESS. The default is PROCESS. | ThreadOfControl |
Installable services page (not z/OS)
The following table lists the attributes on the Installable services page of the Queue Manager properties dialog. The Installable servicespage displays information about the installable services installed on your computer. By default, only the authorization service, OAM, is shown. The attributes on the Installable services page relate to the Service stanza in the configuration files. For more information, see Configuring services and components in the IBM online WebSphere MQ information center.
Attribute | Meaning | Stanza key |
---|---|---|
*Service name | Read-only. This is the name of the service. | Name |
*Service entry points | Read-only. This is the number of entry points that are defined for the service, including the initialization and termination entry points. | EntryPoints |
*Security policy | Read-only. This is the security policy for the queue manager. Default means that the default security policy is used; NTSIDs Required means that a Windows security identifier is passed to the OAM when performing security checks. | SecurityPolicy |
*ServiceComponents | Read-only. This is a list of the service components installed on your computer. | ServiceComponents |
*Name | Read-only. This is the name of the component. | component_name |
*Service | Read-only. This is the name of the installable service. | service_name |
*Data size | Read-only. This is the size, in bytes, of the component data area passed to the component on each call. A value of 0 is used if no component data is required. | size |
*Module | Read-only. This is the path to the module that contains the code for the component. | module_name |
Channels page
The following table lists the attributes that you can set on the Channels page of the Queue Manager properties dialog. To configure the behavior of the queue manager's channels, edit the attributes on the Channels page.
Distributed platforms, such as Windows, UNIX and Linux (x86 and x86-64 platforms)
On distributed platforms, the attributes on the Channels page relate to stanzas in the configuration files. You cannot edit this attributes on remote distributed queue managers.
Attribute | Meaning | Stanza key |
---|---|---|
*Max channels | Type the maximum number of channels, from 1 to 9 999, that can be current (including server-connection channels with connected clients). For z/OS, the value must be between 1 and 9999, with a default value of 200. For all other platforms, the value must be between 1 and 65535, with a default value of 100. On a production system, you could use, for example, the value 1000. If the value of this attribute is reduced, any current channels that exceed the new limit continue to run until they stop. | MaxChannels |
*Max active channels | Type the maximum number of channels that can be active at any one time. The default is the value specified for the MaxChannels attribute. For z/OS, the value must be between 1 and 9999. For all other platforms, the value must be between 1 and 65535. | MaxActiveChannels |
*Max initiators | Type the maximum number of initiators allowed. The default and maximum value is 3. | MaxInitiators |
*MQI bind type | Select the type of connection that channels use to connect to applications. To connect using a standard connection, click STANDARD; to connect without using an agent process, click FASTPATH. | MQBindType |
*Adopt new MCA | This attribute specifies whether an orphaned MCA instance is adopted (restarted) when a new inbound channel request is detected that matches the value of the Adopt new MCA check attribute.
To adopt all channel types, type All. If a FASTPATH channel cannot be safely ended, it is not ended and the adoption fails.
If you do not require orphaned channels to be adopted, type No. | AdoptNewMCAType |
*Adopt new MCA check | This attribute specifies which elements are checked to determine whether an MCA should be adopted when a new inbound channel is detected with the same name as an already active MCA. Type one or more of the following values separated by commas:
| AdoptNewMCACheck |
*Adopt new MCA timeout | Type the number of seconds, from 1 to 3600, that the new process must wait for the old process to end. The default value is 60. | AdoptNewMCATimeout |
*Pipeline length | To allow an MCA to transfer messages using multiple threads, type the number of concurrent threads that the channel will use. The default is 1; if you type a value greater than 1, it is treated as 2. Make sure that you configure the queue manager at both ends of the channel to have a Pipeline length that is greater than 1. Pipelining is effective only for TCP/IP channels. | PipeLineLength |
z/OS platform
On z/OS, the attributes are not configuration attributes; they are just ordinary queue manager attributes like all the other attributes in thez/OS queue manager's properties dialog.
Attribute | Meaning | MQSC parameter |
---|---|---|
Active channels | Type the maximum number of channels, from 1 to 9999, that can be active at any one time. The default value is 200. The value must not be greater than the value of MAXCHL that defines the maximum number of channels allowed. | ACTCHL |
Channel initiator adapters | Specify the number of adapter subtasks, from 0 to 9999, to use for processing WebSphere MQ calls. As a guide, the ratio of adapters to dispatchers should be approximately 8 to 5. However, if you have only a small number of channels, you do not have to decrease the value of this parameter from the default value. Suggested settings: 8 (default) for a test system; 20 for a production system. Specifying a value of 20 adapters gives greater parallelism of WebSphere MQ calls. This is important for persistent messages. Specifying fewer adapters might be better for nonpersistent messages. | CHIADAPS |
Adopt new MCA check | This attribute specifies which elements are checked to determine whether an MCA should be adopted when a new inbound channel is detected with the same name as an already active MCA. Enter one or more of the following values separated by commas. To check the queue manager name and the network address to prevent your channels from being inadvertently shut down, click ALL; to check the network address, click Network address; to check the queue manager name, click Queue manager name; to do no checking, click NONE. | ADOPTCHK |
Adopt new MCA type | This attribute specifies whether an orphaned instance of an MCA of a particular channel type should be restarted automatically when a new inbound channel request matching the adopt new MCA check parameters is detected. This attribute is read-only. | ADOPTTYPE |
Channel initiator dispatchers | Specify the number of dispatchers to use for the channel initiator, from 1 to 9999. As a guideline, allow one dispatcher for every 50 current channels. If you have a small number of channels, however, use the default value of 5. If you are using TCP/IP, the maximum number of dispatchers used for TCP/IP is 100, even if you specify a large value for this attribute. You are recommended to specify a value of 20 on production systems in order to handle up to 1000 active channels. Restart the channel initiator to apply changes to this attribute. | CHIDISPS |
Register with WLM | Specify whether the TCP listener that handles inbound transmissions for the queue-sharing group should register with WLM/DNS. To specify that the listener is not to register with Workload Manager, click No; to specify that the listener is to register with Workload Manager, click Yes. | DNSWLM |
Listener timer | Specify the time interval, in seconds from 5 to 9999, between attempts by WebSphere MQ to restart the listener after an APPC or TCP/IP failure. When the listener is restarted on TCP/IP, it uses the same port and IP address as it used when it first started. Changes to this attribute take effect for listeners that are subsequently started. Listeners that are currently started are unaffected by changes to this attribute. | LSTRTMR |
Channels using LU6.2 | Specify the maximum number of channels that can be current, or clients that can be connected, that use the LU 6.2 transmission protocol. Type a value from 0 to 9999. If you type 0, the LU 6.2 transmission protocol is not used. The value must not be greater than the value of MAXCHL that defines the maximum number of channels allowed. | LU62CHL |
Maximum channels | Type the maximum number of channels, from 0 to 9999, that can be current (including server-connection channels with connected clients). The default value is 200. On a production system, you could use, for example, the value 1000. If the value of this attribute is reduced, any current channels that exceed the new limit continue to run until they stop. The values of ACTCHL, LU62CHL, and TCPCHL must not be greater than the maximum number of channels. | MAXCHL |
Lowest port address | Type the lowest port number, from 0 to 65535, to be used when binding outgoing channels. When all the port numbers between the value of the Lowest port address attribute and the Highest port address attribute have been used, outgoing channel bind to any available port number. The default is 0, which means that all outgoing channels bind to any available port number. Changes to this attribute take effect for channels that are subsequently started. Channels that are currently running are unaffected by changes to this attribute. | OPORTMIN |
Highest port address | Type the highest port number, from 0 to 65535, to be used when binding outgoing channels. When all the port numbers between the value of the Lowest port address attribute and the Highest port address attribute have been used, outgoing channel bind to any available port number. The default is 0, which means that all outgoing channels bind to any available port number. Changes to this attribute take effect for channels that are subsequently started. Channels that are currently running are unaffected by changes to this attribute. | OPORTMAX |
Receive timeout | Specify the approximate length of time that a TCP/IP channel waits to receive data, including heartbeats, from its partner before returning to the inactive state. This attribute applies only to message channels, and not MQI channels. See also the Receive timeout type attribute for more information. | RCVTIME |
Receive timeout type | Set this attribute to specify how the value of the Receive timeout attribute is interpreted. To specify that theReceive timeout value is a multiplier to be applied to the negotiated Heartbeat interval value to determine how long a channel is to wait, set the Receive timeout type attribute to Multiply, then specify a Receive timeoutvalue of zero or in the range 2 through 99 (if you specify zero, the channel does not time out its wait to receive data from its partner); to specify that Receive timeout value is the number of seconds to be added to the negotiated Heartbeat interval value to determine how long a channel is to wait, set Receive timeout type toAdd, then specify a Receive timeout value in the range 1 through 999999; to specify that the Receive timeoutvalue is the number of seconds that the channel is to wait, set Receive timeout type to Equal, then specify anReceive timeout value in the range zero through 999999 (if you specify zero, the channel does not time out its wait to receive data from its partner). | RCVTTYPE |
Minimum receive timeout | Type the minimum length of time, in seconds from 0 to 999999, that a TCP/IP channel waits to receive data, including heartbeats, from its partner before returning to an inactive state. This attribute applies only to message channels, and not to MQI channels. If you use the Receive timeout type attribute to specify that the TCP/IP channel wait time is relative to the negotiated value of the channel's Heartbeat interval value and the resultant value is less than the value of this attribute, the value of this attribute is used. | RCVTMIN |
Channels using TCP | Type the maximum number of channels that can be current, or clients that can be connected, that use the TCP/IP transmission protocol. Type a value from 0 to 9 999 (although note that TCP/IP might not support as many as 9 999 channels). If you type 0, the TCP/IP transmission protocol is not used. The value must not be greater than the value of MAXCHL that defines the maximum number of channels allowed. | TCPCHL |
TCP keepalive | Specify whether the Keepalive facility is used to check that the other end of the connection is still available. If it is not available, the channel is closed. To specify that the Keepalive facility is not to be used, click No; to specify that the Keepalive facility is to be used as specified in the TCP profile configuration data set, click Yes (the interval is specified in the Keepalive Interval attribute on the Extended page of the Channel properties). | TCPKEEP |
TCP stack type | To specify that the channel initiator uses only the TCP/IP address space that is specified in the TCP name attribute, click Single; to specify that the channel initiator can use multiple TCP/IP address spaces, and the default value is the value of the TCP name attribute, click Multiple. | TCPSTACK |
Channel initiator trace auto start | To specify that the channel initiator trace starts automatically, click Yes; to specify that the channel initiator trace does not start automatically, click No. Changes to this parameter take effect when the channel initiator is restarted. If you need to start or stop channel initiator trace without restarting the channel initiator, use the Trace dialog after the channel initiator has started. To open the Trace dialog, in the Navigator view, right-click WebSphere MQ, then click Trace | TRAXSTR |
Channel initiator trace table size | Type the size, in megabytes from 2 to 2048, of the channel initiator's trace data space. Note that changes to this attribute take effect immediately; any existing trace table contents are lost. When you use large z/OS data spaces, ensure that sufficient auxiliary storage is available on your system to support any related z/OS paging activity. You might also need to increase the size of your SYS1.DUMP data sets. | TRAXTBL |
DNS group name | Type the name of the group that the TCP listener handling inbound transmissions for the queue-sharing group should join when using Workload Manager for Dynamic Domain Name Services support (WLM/DNS). The maximum length of this parameter is 18 characters. If this name is blank, the queue-sharing group name is used. Changes to this attribute take effect for listeners that are subsequently started. Listeners that are currently started are unaffected by changes to this attribute. | DNSGROUP |
LU group name | Type the generic LU name to be used by the LU 6.2 listener that handles inbound transmissions for the queue-sharing group. The maximum length of this parameter is 8 characters. If this name is blank, the listener cannot be used. Changes to this attribute take effect for listeners that are subsequently started. Listeners that are currently started are unaffected by changes to this attribute. | LUGROUP |
LU name | Type the name of the LU to use for outbound LU 6.2 transmissions. Set this to be the same as the name of the LU to be used by the listener for inbound transmissions. The maximum length of this parameter is 8 characters. If this name is blank, the APPC/MVS default LU name should be used. This is variable, so the LU name attribute should always be set if you are using LU 6.2. | LUNAME |
LU6.2 member name suffix | Type the suffix of the APPCPM member of SYS1.PARMLIB. This suffix nominates the LUADD for this channel initiator. | |
TCP name | Type the name of either the only, or the default, TCP/IP system to be used, depending on the value of the TCP stack type attribute. This is the name of the z/OS UNIX System Services stack for TCP/IP, as specified in the SUBFILESYSTYPE NAME parameter in the BPXPRMxx member of SYS1.PARMLIB. The default value is TCPIP. The maximum length of this parameter is eight characters. Changes to this parameter take effect when the channel initiator is restarted. | TCPNAME |
Channel initiator service parm | This parameter is reserved for use by IBM. | CHISERVP |
TCP (not z/OS)
The following table lists the attributes that you can set on the TCP page of the Queue Manager properties dialog. If the queue manager uses the TCP/IP transport protocol to communicate with other queue managers, edit the attributes on the TCP page. The attributes on the TCP page relate to stanzas in the configuration files.
Attribute | Meaning | Stanza key |
---|---|---|
*TCP port | Type the port number for TCP/IP sessions. The default is 1414.
The TCP port setting sets the qm.ini TCP port stanza for the queue manager. This is used to control the two following things:
| Port |
*TCP library 1 | Type the name of the TCP/IP socket's DLL. The default is WSOCK32. | Library1 |
*TCP library 2 | If there are two TCP/IP sockets, type the name of the second TCP/IP socket's DLL; if there is only one TCP/IP socket, type the same name as for the TCP library 1 attribute. The default is WSOCK32. | Library2 |
*TCP keepalive | TCP can check periodically that the other end of the connection is still available. If the connection is not still available, the connection is closed. To configure TCP to perform these checks, click YES; to prevent TCP performing these checks, click NO. The default is YES. | KeepAlive |
*TCP listener backlog | Type the maximum number of outstanding connection requests. The default value is -1 which resolves to the default value on the operating system. The default is 100 on Windows and Linux (x86 and x86-64 platforms). | ListenerBackLog |
LU6.2 (not z/OS)
The following table lists the attributes that you can set on the LU6.2 page of the Queue Manager properties dialog. If the queue manager uses the LU 6.2 transport protocol to communicate with other queue managers, edit the attributes on the LU6.2 page. The attributes on the LU6.2page relate to stanzas in the configuration files.
Attribute | Meaning | Stanza key |
---|---|---|
*LU6.2 TP name | Type the TP name to start on the remote site. | TPName |
*LU6.2 library 1 | Type the name of the APPC DLL. The default is WCPIC32. | Library1 |
*LU6.2 library 2 | If there are two APPCs, type the name of the second APPC DLL; if there is only one APPC, type the same name as for theLU6.2 library 1 attribute. The default is WCPIC32. | Library2 |
*LU6.2 local LU | Type the name of the logical unit to use on local systems. | LocalLU |
NetBIOS (not z/OS)
The following table lists the attributes that you can set on the NetBIOS page of the Queue Manager properties dialog. If the queue manager uses the NetBIOS transport protocol to communicate with other queue managers, edit the attributes on the NetBIOS page. The attributes on the NetBIOS page relate to stanzas in the configuration files.
Attribute | Meaning | Stanza key |
---|---|---|
*NetBIOS local name | Type the name by which this computer will be known on the local area network (LAN). | LocalName |
*NetBIOS number of sessions | Type the number of sessions to allocate. The default is 1. | NumSession |
*NetBIOS number of names | Type the number of names to allocate. The default is 1. | NumNames |
*NetBIOS adapter number | Type the number of the LAN adapter to use. The default is 0. | AdapterNum |
*NetBIOS number of commands | Type the number of commands to allocate. The default is 1. | NumCommands |
*NetBIOS library 1 | Type the name of the NetBIOS DLL. The default is NETAPI32. | Library1 |
SPX (not z/OS)
The following table lists the attributes that you can set on the SPX page of the Queue Manager properties dialog. If the queue manager uses the SPX transport protocol to communicate with other queue managers, edit the attributes on the SPX page. The attributes on the SPX page relate to stanzas in the configuration files.
Attribute | Meaning | Stanza key |
---|---|---|
*SPX socket | Type the SPX socket number in hex. The default is SE86. | Socket |
*SPX library 1 | Type the name of the SPX DLL. The default is WSOCK32. | Library1 |
*SPX library 2 | If there is a second SPX, type the name of the second SPX DLL; if there is only one SPX, type the same name as for the SPX library 1 attribute. The default is WSOCK32. | Library2 |
*SPX keepalive | SPX can check periodically that the other end of the connection is still available. If the connection is not still available, the connection is closed. To configure SPX to perform these checks, click YES; to prevent SPX performing these checks, click NO. The default is YES. | KeepAlive |
*SPX board number | Type the number of the LAN adapter to use. The default is 0. | BoardNum |
Publish/Subscribe
The following table lists the attributes that you can set on the Publish/Subscribe page of the Queue Manager properties dialog. ThePublish/Subscribe page replaces the cfgmqbrk application that was supplied with previous versions of WebSphere MQ. To configure the queue manager for publish/subscribe messaging, edit the attributes on the Publish/Subscribe page. The attributes on the Publish/Subscribe page relate to stanzas in the configuration files. For more information about the individual stanzas, see Configuring services and components in theIBM online WebSphere MQ information center.
Attribute | Meaning | MQSC Parameter |
---|---|---|
Publish/Subscribe mode | The Publish/Subscribe mode is used to allow coexistence with Publish/Subscribe engines in WebSphereMQ version 6.0, WebSphere Message Broker V6, and WebSphere Event Broker V6. The three options are:
Compatibility which means that the V7 Publish/Subscribe engine is enabled, but the queued Publish/Subscribe interface is disabled. This means that the Publish/Subscribe engine can coexist with the Publish/Subscribe engines listed above. This is the default value for existing queue managers.
Enable which means that the V7 Publish/Subscribe engine is enabled and the queued Publish/Subscribe interface is enabled. This is the default value for newly created queue managers.
Disabled which means that all Publish/Subscribe functions are disabled.
| PSMODE |
Message Retry Count | The number of times that the channel retries to connect to the remote queue manager before it decides that it cannot deliver the message to the remote queue. This attribute controls the action of the MCA only if the Message retry exit name attribute is blank. If the Message retry exit name attribute is not blank, the value of the Message retry count attribute is passed to the exit for the exit's use but the number of times that the channel retries to connect is controlled by the exit, not by the Message retry count attribute. The maximum value is 999999999, and the default value is 5. | MRRTY |
Publish/Subscribe syncpoint | This option defines whether messages will be processed under syncpoint. The two options are:
If persistent. The message is processed under syncpoint if the message is persistent. This is the default value.
Yes. All messages are processed under syncpoint.
| PSSYNCPT |
Undelivered non-persistent input message | This property defines what the Pub/Sub engine should do with non-persistent input messages that are not delivered. The two options are:
Discard. The undelivered non-persistent message is discarded. This is the default value.
Keep. The undelivered non-persistent message is not discarded. The Pub/Sub Engine will continue to retry to process this message at appropriate intervals and does not continue processing subsequent messages.
| PSNPMSG |
Undelivered non-persistent response | This property defines what the Pub/Sub engine should do with non-persistent responses that are not delivered. The four options are:
Discard. The undelivered non-persistent response is discarded if it cannot be placed on the reply queue.
Keep. The undelivered non-persistent response is not discarded or put on the dead-letter queue. The Pub/Sub Engine will back out the current operation and then retry it at appropriate intervals and does not continue processing subsequent messages.
Normal. Non-persistent responses which cannot be placed on the reply queue are put on the dead-letter queue. If they cannot be placed on the DLQ then they are discarded. This is the default value.
Safe. Non-persistent responses which cannot be placed on the reply queue are put on the dead-letter queue. If the response cannot be sent and cannot be placed on the dead-letter queue then the Pub/Sub Engine will back out of the current operation and then retry at appropriate intervals and does not continue processing subsequent messages.
| PSNPRES |
Tree lifetime | The lifetime, in seconds of non-administrative topics. When this non-administrative node no longer has any active subscriptions, this parameter determines how long the queue manager will wait before removing that node.
Only non-administrative topics that are in use by a durable subscription remain after the queue manager is recycled. Specify a value in the range 0 through 604000. A value of 0 means that non-administrative topics are not removed by the queue manager. The queue manager's initial default value is 1800.
| TREELIFE |
Parent | The name of the parent queue manager to which the local queue manager is to connect as its child in a hierarchy. If the field is left empty, then the queue manager has no parent queue manager, and if there is an existing parent queue manager it is disconnected.
Before a queue manager can connect to a queue manager as its child in a hierarchy, channels must exist in both directions, between the parent queue manager and the child queue manager.
| PARENT |
Publish exit path | The module name containing the publish exit code. The maximum length of this field is 128 characters. The default is no publish exit. | N/A |
Publish exit function | The name of the function entry point into the module containing the publish exit code. The maximum length of this field is 128 characters. | N/A |
Publish exit data | If the queue manager is using a publish exit, it invokes the exit passing an MQPSXP structure as input. The data specified using this attribute is provided in the ExitData field. The maximum length of this field is 128 characters. The default is 32 blank characters. | N/A |
Publish/Subscribe clustering | Controls whether this queue manager participates in Publish/Subscribe clustering. The two options are:
Enabled which means that this queue manager can participate in Publish/Subscribe clustering. This is the default value for newly created queue managers.
Disabled which means that this queue manager cannot participate in Publish/Subscribe clustering.
| PSCLUS |
Archive (z/OS only)
The following table lists the queue manager's system log archive attributes, or parameters, which are displayed in the Initial table of the queue manager's Archive dialog. The values in the Initial table were applied when the queue manager loaded the system parameter module at startup. You can temporarily change and override some of the values while the queue manager is running; the new values are displayed in theSet table. The parameters that you can override are marked with an asterisk (*). For details of the attributes in the Archive tape recordtable, see Archive tape.
The equivalent MQSC attribute for the SET ARCHIVE command is shown for each parameter. For more information about the SET ARCHIVE command, see SET ARCHIVE in the IBM online WebSphere MQ information center.
Attribute | Meaning | MQSC parameter |
---|---|---|
Parameter type | This attribute shows which type of information is displayed in the table. The Initial table displays the initial values that were applied when the queue manager loaded the system parameter module at startup. The Set table displays any values that have been manually overridden since the queue manager started. | (Not applicable.) |
*Allocation unit | Specify the unit in which primary and secondary space allocations are made: Cylinders, Tracks, or Blocks. The default is Blocks. | ALCUNIT |
*Archive prefix 1 | Specify the prefix for the first archive log data set name. See the Time stamp format attribute for a description of how the data sets are named and for restrictions on the length of the prefix. The default prefix is CSQARC1. | ARCPFX1 |
*Archive prefix 2 | Specify the prefix for the second archive log data set name. See the Time stamp format attribute for a description of how the data sets are named and for restrictions on the length of the prefix. The default prefix is CSQARC2. | ARCPFX2 |
*Archive retention period | Specify the retention period, in days from 0 to 9999, to be used when the archive log data set is created. The default is 9999. | ARCRETN |
*Routing code | Specify the list of z/OS routing codes for messages to the operator about archive log data sets. This field is ignored if the value of the Waiting for reply attribute is No. Type up to 14 routing codes, each with a value from 1 to 16, separated by commas. Specify at least one code. | ARCWRTC |
*Waiting for reply | Specify whether a message is to be sent to the operator and a reply is received before attempting to mount an archive log data set. Other WebSphere MQ users might be forced to wait until the data set is mounted, but they are not affected while WebSphere MQ is waiting for the reply to the message. If the device needs a long time to mount archive log data sets, for example a tape drive, click Yes; If the device does not have long delays, for example DASD, click No. | ARCWTOR |
*Block size | Type the block size, from 4097 to 28672 (rounded up to the nearest multiple of 4 096), of the archive log data set. The block size must be compatible with the device type that you specify for the Archive unit 1 attribute. This parameter is ignored for data sets that are managed by the storage management subsystem (SMS). | BLKSIZE |
*Catalog | Specify whether archive log data sets are cataloged in the primary integrated catalog facility (ICF) catalog. To archive log data sets that are cataloged, click Yes; to archive log data sets that are not cataloged, click No. The default is No. | CATALOG |
*Compact | Specify whether data written to archive logs is to be compacted. This option applies only to a 3480 or 3490 device that has the improved data recording capability (IDRC) feature. When this feature is turned on, hardware in the tape control unit writes data at a much higher density than normal, allowing for more data on each volume. If you want the data to be compacted, click Yes; if you do not use a 3480 device with the IDRC feature or a 3490 base model, with the exception of the 3490E, click No. | COMPACT |
*Primary space allocation | Specify the primary space allocation for DASD data sets in the unit that you specified in the Allocation unitsattribute. The value must be from 1 to 999. See z/OS System Setup Guide for a guide to determining the necessary value. | PRIQTY |
*Secondary space allocation | Specify the secondary space allocation for DASD data sets in the unit that you specified in the Allocation unitsattribute. The value must be greater than zero. | SECQTY |
*Protect | Specify whether archive log data sets are to be protected by discrete ESM (external security manager) profiles when the data sets are created. Click Yes to create discrete data set profiles after the logs offload process ends. ESM protection must be active for WebSphere MQ, the user ID associated with the WebSphere MQ queue manager address space must have authority to create these profiles, and the TAPEVOL class must be active if you are archiving to tape. If you do not want to create profiles, click No. | PROTECT |
*Quiesce interval | Specify the maximum number of seconds, from 1 to 999, allowed for the quiesce when an ARCHIVE LOG command is issued with MODE(QUIESCE) specified. | QUIESCE |
*Time stamp format | Specify whether the archive log data set name has a time stamp in it. To include a time stamp in the name, clickYes or Extended, depending on the format that you want to use. If you do not want to include a time stamp in the name, click No. For more information about the formats, see SET ARCHIVE in the IBM online WebSphere MQinformation center. | TSTAMP |
*Archive unit 1 | Specify the device type or unit name of the device that is used to store the first copy of the archive log data set. | UNIT |
*Archive unit 2 | Specify the device type or unit name of the device that is used to store the second copy of the archive log data set. | UNIT2 |
Archive tape
The following table lists the archive tape attributes, which are used in the queue manager's archive tape records. The archive tape records are listed in the Archive tape records table in the queue manager's Archive dialog. You cannot edit these values.
Parameter | Meaning |
---|---|
Parameter type | This attribute shows which type of information is displayed in the table. The Initial table displays the initial values that were applied when the queue manager loaded the system parameter module at startup. The Set table displays any values that have been manually overridden since the queue manager started. |
Tape unit address | The physical address of the tape unit that is allocated to read the archive log. |
Tape unit status | The status of the tape unit. Busy means that the tape unit is busy actively processing an archive log data set; Premount means that the tape unit is active and allocated for premounting; Available means that the tape unit is available, inactive, and waiting for work; Unknown means that the status of the tape unit is unknown. |
Log correlation ID | The correlation ID associated with the user of the tape that is being processed. This is blank if there is no current user. |
Tape volume serial number | The volume serial number of the tape that is mounted. |
Data set name | The data set name on the tape volume that is being processed, or was last processed. |
Attribute | Meaning | MQSC parameter |
---|---|---|
Queue accounting | This attribute specifies whether to collect accounting data about the activity of connections for queues hosted by the queue manager. To switch on accounting data collection for the queue manager's queues, click On; to switch off accounting data collection for the queue manager's queues that have the value Queue Manager in their Queue accounting attribute (see Queue properties), click Off; to switch off accounting data collection for all the queue manager's queues regardless of the setting of the queue's Queue accounting attribute, click None. | ACCTQ |
Log (z/OS only)
The following table lists the queue manager's system log attributes, or parameters, which are displayed in the Initial table of the queue manager's Log dialog. The values in the Initial table were applied when the queue manager loaded the system parameter module at startup. You can temporarily change and override some of the values while the queue manager is running; the new values are displayed in the Settable. The parameters that you can override are marked with an asterisk (*). For details of the attributes in the Log copy record table, seeLog copy.
The equivalent MQSC attribute for the SET LOG command is shown for each parameter. For more information about the SET LOG command, see SET LOG in the IBM online WebSphere MQ information center.
Parameter | Meaning | MQSC parameter |
---|---|---|
Parameter type | This attribute shows which type of information is displayed in the table. The Initial table displays the initial values that were applied when the queue manager loaded the system parameter module at startup. The Set table displays any values that have been manually overridden since the queue manager started. | (Not applicable.) |
*Deallocation interval | Specify the length of time, in minutes, that an allocated archive read tape unit is allowed to remain unused before it is deallocated. The value can be from zero to 1440. If the value is zero, the tape unit is deallocated immediately; if the value is 1440, the tape unit is never deallocated. | DEALLCT |
*Log compression | Specifies the log data compression technique for persistent message logging.
NONE means that log compression is not enabled. This is the default value.
RLE means that run-length encoding log compression is enabled.
ANY means that any compression algorithm supported by the queue manager is enabled. In WebSphere MQversion 7.0.1 and later, the only compression algorithm available for value ANY is RLE.
| COMPLOG |
*Maximum number of log archives | Specify the maximum number of archive log volumes that can be recorded in the BSDS. | MAXARCH |
*Maximum number of tape units | Specify the maximum number of dedicated tape units that can be allocated to read archive log tape volumes. This overrides the value for MAXRTU set by CSQ6LOGP in the archive system parameters. This, together with theDeallocation interval attribute, allows WebSphere MQ to optimize archive log reading from tape devices. | MAXRTU |
Input buffer size | Specifies the size of input buffer storage for active and archive log data sets. | INBUFF |
Output buffer size | Specifies the size of output buffer storage for active and archive log data sets. | OUTBUFF |
*Output buffer count | Specifies the number of output buffers to be filled before they are written to the active log data sets. | WRTHRSH |
Log archive | Specifies whether archiving is on or off. Yes means that archiving is on; No means that archiving is off. | OFFLOAD |
Dual logging used | Specifies whether dual logging is being used. Yes means that dual logging is being used; No means that dual logging is not being used. | TWOACTV |
Dual archive logging used | Specifies whether dual archive logging is being used. Yes means that dual archive logging is being used; Nomeans that dual archive logging is not being used. | TWOARCH |
Dual BSDS used | Specifies whether dual BSDS is being used. Yes means that dual BSDS is being used; No means that dual BSDS is not being used. | TWOBSDS |
Log copy
The following table lists the log copy attributes, which are used in the queue manager's log copy records. The log copy records are listed in theLog copy records table in the queue manager's Log dialog. You cannot edit these values.
Parameter | Meaning |
---|---|
Log copy number | The number of the copy. |
Log used | The percentage of the active log data set that has been used. |
Data set name | The data set name of the active log data set. If the copy is not currently active, this is returned as blank. |
Security (z/OS only)
The following table lists the queue manager's system-wide security attributes, or parameters. You can change two of the values; the parameters that you can change are marked with an asterisk (*). For details of the attributes in the Security switch table, see Security switch.
The equivalent MQSC attribute for the ALTER SECURITY command is shown for each parameter. For more information about the ALTER SECURITY command, see ALTER SECURITY in the IBM online WebSphere MQ information center.
Parameter | Meaning | MQSC parameter |
---|---|---|
*Security timeout | Type, in minutes from 0 to 10080 (one week), how long security information about an unused user ID and associated resources is retained by WebSphere MQ. If you type 0, and the value of the Security interval attribute is not zero, all such information is discarded by the queue manager every Security interval. | TIMEOUT |
*Security interval | Type, in minutes from 0 to 10080 (one week), the interval between checks for user IDs and their associated resources to determine whether the Security timeout has expired. If you type 0, no user timeouts occur. | INTERVAL |
Security switch
The following table lists the security switch attributes, which are used in the queue manager's security switch messages. The security switch messages (one per security switch) are listed in the Security switch table in the queue manager's Security dialog. You cannot edit these values.
Parameter | Meaning |
---|---|
Security switch | The name of the security switch. |
Security setting | The current setting of the security switch, and whether the profile that caused the setting is present. For example, the security switch could be set off because the relevant profile was not found. |
Security profile | The name of the profile that caused the current security setting. |
System (z/OS only)
The following table lists the queue manager's system attributes, or parameters, which are displayed in the Initial table of the queue manager's System dialog. The values in the Initial table were applied when the queue manager loaded the system parameter module at startup. You can temporarily change and override some of the values while the queue manager is running; the new values are displayed in the Set table. The parameters that you can override are marked with an asterisk (*).
The equivalent MQSC attribute for the SET SYSTEM command is shown for each parameter. For more information about the SET SYSTEM command, see SET SYSTEM in the IBM online WebSphere MQ information center.
Parameter | Meaning | MQSC parameter |
---|---|---|
Parameter type | This attribute shows which type of information is displayed in the table. The Initial table displays the initial values that were applied when the queue manager loaded the system parameter module at startup. The Settable displays any values that have been manually overridden since the queue manager started. | (Not applicable.) |
Command user ID | Specifies the default user ID for command security checks. | CMDUSER |
Exit interval | Specifies the time, in seconds, for which queue manager exits can execute during each invocation. | EXITLIM |
Exit tasks | Specifies how many started server tasks to use to run queue manager exits. | EXITTCB |
*Checkpoint count | Specify the number of log records, from 200 to 16000000, that WebSphere MQ writes between the start of one checkpoint and the next. WebSphere MQ starts a new checkpoint after the number of records that you specify has been written. | LOGLOAD |
XCF group name | Specifies the name of the XCF group to which this instance of WebSphere MQ belongs. | OTMACON = (Group) |
XCF member name | Specifies the name of the XCF member to which this instance of WebSphere MQ belongs. | OTMACON = (Member) |
OTMA exit name | Specifies the name of the OTMA destination resolution user exit to be run by IMS. | OTMACON = (Druexit) |
OTMA interval | Specifies the length of time, in seconds, that a user ID from WebSphere MQ is considered previously verified byIMS. | OTMACON = (Age) |
OTMA Tpipe name prefix | Specifies the prefix to be used for Tpipe names. | OTMACON = (Tpipepfx) |
Defer index | Specifies whether the queue manager restart completes before all indexes are built and defers building until later, or whether the queue manager waits until all indexes are built. Yes means that the queue manager restart completes before all indexes are built; No means that the queue manager restart waits until all indexes are built. | QINDXBLD |
Coded character set ID | Specifies the coded character set identifier for the queue manager. | QMCCSID |
Queue-sharing group name | Specifies the name of the queue-sharing group to which the queue manager belongs. | (Not applicable.) |
Data-sharing group name | Specifies the name of the DB2® data-sharing group to which the queue manager is to connect. | (Not applicable.) |
DB2 name | Specifies the name of the DB2 subsystem or group attachment to which the queue manager is to connect. | (Not applicable.) |
DB2 tasks | Specifies the number of DB2 server tasks to use. | (Not applicable.) |
DB2 BLOB tasks | Specifies the number of DB2 server tasks to be used for BLOBs. | (Not applicable.) |
Write RACF®audit records | Specifies whether RACF audit records are written for RESLEVEL security checks that are performed during connection processing. Yes means that RACF audit records are written; No means that RACF audit records are not written. | RESAUDIT |
Routing code | Specifies the list of z/OS routing codes for messages that are not sent in direct response to an MQSC command. There can be 1 - 16 entries in the list. | ROUTCDE |
Send accounting data to SMF | Specifies whether WebSphere MQ sends accounting data to SMF automatically when the queue manager starts.Yes means that accounting data is sent automatically; No means that accounting data is not sent automatically. | SMFACCT |
Send statistics data to SMF | Specifies whether WebSphere MQ sends statistics data to SMF automatically when the queue manager starts.Yes means that statistics data is sent automatically; No means that statistics data is not sent automatically. | SMFSTAT |
*SMF interval | Specify the interval, in minutes from 0 to 1440, between consecutive gatherings of statistics. If you specify a value of zero, both statistics data and accounting data is collected at the SMF data collection broadcast. Changes to this parameter take effect when the current interval expires, unless the new interval is less than the unexpired portion of the current interval, in which case statistics are gathered immediately and the new interval then takes effect. | STATIME |
Trace classes | Specifies the classes for which tracing is started automatically. | TRACSTR |
*Trace table size | Specify the default size, in 4 KB blocks from 1 to 999, of trace table where the global trace facility storesWebSphere MQ trace records. Storage for the trace table is allocated in the ECSA so you must select this value with care. If there is any trace currently in effect, the existing trace table continues to be used, and its size is unchanged. A new global trace table is only obtained when trace is restarted. If a new trace table is created with insufficient storage, the old trace table continues to be used, and the message CSQW153E is displayed. | TRACTBL |
Cluster cache type | Specifies the type of cluster cache. Static means that a static cluster cache is used; Dynamic means that a dynamic cluster cache is used. | (Not applicable.) |
WLM interval | Specifies the time, in minutes, between scans of the queue index for WLM-managed queues. | WLMTIME |
*Service parameter setting | This parameter is reserved for use by IBM. | SERVICE |
Operation Mode | Specifies the operation mode for the queue manager. This attribute can have a value of COMPAT or NEWFUNC, followed by a command level value in the format vrm. For example, 600, 700, or 701. The attribute is read only and can not be changed by the GUI. When this value is set to COMPAT, the user will not be able to access certain function associated with the current installed level and will result in a MQRCCF_FUNCTION_RESTRICTED error. |
I have bookmarked this website and I will keep visiting you for further such interesting posts.
ReplyDeleteQueue Management
Virtual Queue