BEA Logo BEA MessageQ Release 5.0

  Corporate Info  |  News  |  Solutions  |  Products  |  Partners  |  Services  |  Events  |  Download  |  How To Buy

 

   MessageQ Doc Home   |   Configuration Guide for OpenVMS   |   Previous Topic   |   Next Topic   |   Contents   |   Index

Directories and Logical Names

 

This appendix lists the BEA MessageQ directories and logical names.

Directories

Table D-1 lists the BEA MessageQ directories.

Table D-1 BEA MessageQ Directories

Directory

Logical

Description

[DMQ$Vnn]

.

BEA MessageQ root area.

[.CVT]

.

BEA MessageQ Conversion Utility

[.DMQNS]

.

Default lightweight namespace area.

[.DOC]

DMQ$DOC

Documentation files and release notes.

[.EXAMPLES]

DMQ$EXAMPLES

Sample programs.

[.EXE]

DMQ$EXE

Executable files and command files.

[.LIB]

DMQ$LIB

Library holding area for standard object and text libraries.

[.LOCAL.C]

.

Catalog files for localization.

[.MRS.bbbb_ggggg]

DMQ$MRS

MRS Server data file area for DQFs and SAFs.

[.USER.bbbb_ggggg]

DMQ$USER
DMQ$ACCESS

Specific user customizing area. The extension is the 4-digit bus ID and 5-digit group ID.

[.LOG.bbbb_ggggg]

DMQ$LOG

Specific group server log file area.

[.USER.CLIENT]

Initialization and header files for the BEA MessageQ Client for OpenVMS.

[.USER.TEMPLATE]

User customizing area template. Files should be moved before attempting to alter any files.

Logical Names

Table D-2 lists the BEA MessageQ logical names. The second column in the table refers to whether the logical names are dynamically translated when a program attaches its first queue.

Table D-2 BEA MessageQ Logical Names

Logical Name

Dynamic

Description

BEADIR

.

Directory specification for BEA MessageQ root area. This logical name is used by the message catalogs.

DMQ$ACCESS¹

.

Directory specification of BEA MessageQ access control files.

DMQ$BLOCKING_CONFIRM¹

.

Controls whether or not the PAMS_CONFIRM_MSG routine waits for a response from the recovery system.

DMQ$CHKPT_FILE¹

.

File specification of a file that counts the number of times the COM Server has been booted. Generates unique sequence numbers.

DMQ$BUS_GROUP¹

Y

Contains the current bus ID and group ID.

DMQ$DCL_NUMBER³

Y

Base ten number that overrides the queue number submitted to PAMS_ATTACH_Q.

DMQ$DEBUG³

Y

Controls the built-in BEA MessageQ debug code:

  • ERROR = Display only error messages.

  • TRACE = Trace module calls.

  • ALL = Display both trace and error messages.

DMQ$DEBUG_MEMORY³

Y

Enables tracing of global memory structures. For troubleshooting purposes only.

DMQ$DEBUG_SELECT³

Y

Enables trace dumping of the selection list. For troubleshooting purposes only.

DMQ$DEF_XGRP_BUF_POOL

Y

Overrides the default cross group buffer value on an unsolicited connection.

DMQ$DEFAULT_SEND_TMO³

Y

Overrides the timeout value for the pams_put_msg service.

DMQ$DISABLE_FORCEX³

Y

Controls whether the COM Server forces all processes that are attached to the COM Server to exit along with it. The default is NO. YES = COM Server does not perform the forced exit.

DMQ$DISABLE_SYSOUT³

Y

Controls whether BEA MessageQ logs events to SYS$OUTPUT. YES = Printing disabled.

DMQ$DISK¹

.

Device specification of the disk where BEA MessageQ is installed.

DMQ$DOC¹

.

Directory specification of BEA MessageQ documentation.

DMQ$DNS_DIRECTORY³

.

Default DNS namespace and specification used by various BEA MessageQ routines.

DMQ$ENTRYRTL¹

.

File specification of the installed BEA MessageQ run-time library DMQ$ENTRYRTLVnn.EXE.

DMQ$ERROUT²

Y

Device specification of the alternate BEA MessageQ console device. If not specified, BEA MessageQ messages are printed on the system console.

DMQ$EXAMPLES¹

.

Directory specification of BEA MessageQ example programs.

DMQ$EXE¹

.

Directory specification of BEA MessageQ executable modules.

DMQ$EXECRTL¹

.

File specification of the installed EXEC mode BEA MessageQ routines in DMQ$EXECRTLVnn.EXE.

DMQ$EXIT_PURGE³

Y

Controls the purging of pending LLS messages when the process exits.NO = do not purge messages.

DMQ$GMT_OFFSET³

Y

The time difference in hours between local system time and Greenwich Mean Time (GMT). The value of this logical name must be set for TCP/IP network communications.

DMQ$GROUP_SYNCHRONIZE4

.

Enables automatic synchronized cluster group failover. Setting this to NO will require that failover be managed by the user. The default is YES.

DMQ$HEADERS³

Y

Controls the printing of BEA MessageQ message headers on the user's terminal. YES = print message headers.

DMQ$INIT_FILE¹

.

File specification of the BEA MessageQ initialization file.

DMQ$LIB¹

.

Directory specification of the BEA MessageQ libraries.

DMQ$LIBGP¹

.

File specification of the BEA MessageQ shareable image DMQ$LIBGPVnn.EXE

DMQ$LIBFML32¹

.

File specification of the BEA MessageQ shareable image DMQ$LIBFML32Vnn.EXE

DMQ$LOG¹

.

Directory specification of the BEA MessageQ log area.

DMQ$MRS¹

.

Directory specification for the MRS data files.

DMQ$MRS_CHECK_ML5

.

Enables MRS validation scan of the internal MRS message list. For troubleshooting purposes only.

DMQ$MRS_CHECK_PL5

.

Enables MRS validation scan of the internal MRS process list. For troubleshooting purposes only.

DMQ$MRS_CHUNK_SIZE4

.

Controls the journaling chunk size for DQF and SAF journals.

DMQ$MRS_CLEANUP_ON_CLOSE5

.

Enables MRS to delete a DQF or SAF journal file on close if the file is empty.

DMQ$MRS_DISABLE_JOURNALING4

.

Disables all journaling. This logical is processed by the COM Server only. Default is NO.

DMQ$MRS_DISABLE_SH4

.

Disables submitter history checking when set to YES. The deafult is NO. To use this logical name, define it in DMQ$SET_SERVER_LOGICALS.COM in the MRS section.

Disabling submitter history checking increases the chances of duplicate recoverable SAF messages being delivered to the receiving application. Applications must be capable of handling duplicate messages before enabling this logical. Duplicate SAF messages may occur in non-FIFO order, typically with a single message stutter caused by a link transition.

DMQ$MRS_DQF_CONTROL5

.

Disables operation of DQF files unless explicitly requested by a control message.

DMQ$MRS_FREE_FILE_MAX4

.

Limits the number of FREE files that the MRS Server may create during recoverable messaging. The default value is calculated by the MRS Server based on the NUM_DQF_AREAS and NUM_SAF_AREAS (DMQ$INIT.TXT). Cannot be smaller than DMQ$MRS_FREE_FILE_MIN.

DMQ$MRS_FREE_FILE_MIN4

.

Controls the minimum number of FREE files that the MRS Server may use during recoverable messaging. The default value is 10. To turn the Free File Engine OFF, set it to 0.

DMQ$MRS_READ_AHEAD_DEPTH5

.

Controls the read ahead buffer depth. This value can be tuned to increase MRS read I/O performance. The default value is 4. It is not recommended that this value be changed.

DMQ$MRS_RING_DEPTH5

.

Controls the depth of the confirmation ring buffer. The default value is 10.

DMQ$MRS_SAF_CONTROL5

.

Disables operation of SAF files unless explicitly requested by a control message.

DMQ$MRS_SERVER_CHECK_TIMER5

.

Internal time which MRS uses to check the state of adjacent MRS servers. Value is in tenths of seconds with with a valid range of 30 to 3000 seconds (5 minutes). Default is 600 (1 minute).

DMQ$MRS_TRACE_PL5

.

Enables MRS tracing of the internal MRS process list. For troubleshooting purposes only.

DMQ$MRS_TRACE_STATE5

.

Enables MRS tracing of internal MRS state changes. For troubleshooting purposes only.

DMQ$MSGSHR¹

.

File specification of the BEA MessageQ message table.

DMQ$OBJECT_CACHE_SIZE³

Y

Sets the maximum number of queue names that be stored the PAMS_LOCATE_Q process cache. Valid setting are 20 to 32000. The default value is 128.

DMQ$POOL_CHK_WARNING_INTERVAL4

.

Controls the number of seconds between low buffer pool warning messages. The default is 120 seconds.

DMQ$PSSRTL¹

.

Supplied for backwards compatibility. Points to DMQ$ENTRYRTL.

DMQ$OPCOM_TARGET²

Y

Redirects console event logging to OPCOM. See Managing a BEA MessageQ Environment, for a full description.

DMQ$GROUP_OUTPUT³

Y

Sets output direction to any of the following file output streams: CONSOLE, EVL_LOG, USER_LOG, SYSOUT, SYSERR, MEMLOG, or NONE.

DMQ$PROCESS_OUTPUT³

Y

Sets output direction to any of the following file output streams: CONSOLE, EVL_LOG, USER_LOG, SYSOUT, SYSERR, MEMLOG, or NONE.

DMQ$TRACE_OUTPUT³

Y

Sets output direction to any of the following file output streams: CONSOLE, EVL_LOG, USER_LOG, SYSOUT, SYSERR, MEMLOG, or NONE.

DMQ$QTRANSFER_MAX_PROCS5

.

Defines the number of concurrent streams the Qtransfer Server can handle at one time. The default is 5.

DMQ$ROOT¹

.

The root directory name of the BEA MessageQ software being used (for example, DMQVnn).

DMQ$SBS_ETH_MOT_ONLY5

.

Allows only Ethernet broadcasting via the SBS server when set to YES. The default is NO.

DMQ$SBS_MAX_ASM_Q5

.

Overrides the default number of SBS assembly queues.
The default is 10.

DMQ$SBS_MAX_MSG_SIZE5

.

Overrides the default size of the SBS assembly queue. Can not exceed 32000.

DMQ$SBSE_REXMIT_TIMEOUT5

.

Overrides the default retransmission timer.
The default is 30 seconds.

DMQ$SBSE_mmmm_MAX_HB5

.

Overrides the maximum heartbeat interval for the specified MOT mmmm defined in the group initialization file.

DMQ$SBSE_mmmm_POLL_INT5

.

Overrides the polling interval for the specified MOT mmmm defined in the group initialization file.

DMQ$SCRIPT³

Y

Controls script processing. This logical should provide the file specification for the script file. If the script file cannot be found then the user will be prompted for one. A value of N will disable scripts.

DMQ$SYMBOLS³

Y

Specifies the type-class file to be loaded for script processing. The default is DMQ$USER:P_TYPECL.H.

DMQ$SET_GBLSEC_PROT²

.

Overrides the protection mask on the BEA MessageQ global sections.

DMQ$SET_LNM¹

.

File specification for the installed BEA MessageQ shareable image DMQ$SET_LNM_TABLEVnn.EXE.

DMQ$SERVER_TRACE³

Controls the tracing of BEA MessageQ Server-specific information. YES = Trace on. This logical generates many trace lines for each message in the server log file.

DMQ$SPAWN_SERVERS²

.

Suppresses the start of BEA MessageQ servers when it is set to NO.

DMQ$VERIFY_ON³

Y

Enables verification of global sections in the DMQ$LLS_VERIFY utility. The default is NO.

DMQ$PRIMARY_DECNET_LD²

.

Controls which DECnet link driver is the primary driver. The default is V2. Setting this logical to V3 will force the DECNETV3 driver to be the primary DECnet link driver and the DECNETV2 (COM Server) driver to be the secondary DECnet link driver.

DMQ$TCPIP_LD¹

.

Controls which TCP/IP link driver is used.

DMQ$TCPIP_CON_ABORT5
DMQ$DECNET_CON_ABORT5

.

Controls the connection abort timer. When a link connection is being established, at the beginning of the protocol handshake, the connect abort timer is started. The timer is canceled when the link is successfully established. The default value is 90 seconds.

DMQ$TCPIP_LD_NAME5

.

Override the default hostname returned by a call to gethostname(). This logical name can be used to define an alternate interface for the linkdriver activity.

DMQ$USER¹

.

Directory specification for the BEA MessageQ user area.

DMQ$VPS_USER¹

.

File spec of the BEA MessageQ shareable image DMQ$VPS_USERVnn.EXE.

DMQ$VPS_EXEC¹

.

File spec of the BEA MessageQ installed shareable image DMQ$VPS_EXECVnn.EXE.

DMQLD_TRACE_LEVEL5

.

Defines and overrides the value for LD tracing. This value is a bit mask which is defined as follows:

  • 1 = skinny trace, I/O completions, message processing

  • 2 = dump data from each I/O

  • 4 = full tracing of all routines

DMQLD_PING_TIMEOUT5

.

Defines how long, in seconds, we wait to hear from a V4 group as a result of a ping request. The default is set to 90 seconds.

DMQLD_PING_INTERVAL5

.

Defines the interval between pings. The default value is 30 seconds.

DMQLD_MAX_DATAIO_LEN5

.

Defines the maximum number of bytes that will be used on a single write to the link. The default value is 65534 bytes.

DMQLD_TCP_UNREACH_RETRY5

.

In the case where a TCP stack reports a warning for NETUNREACH or HOSTUNREACH, a retry is offered for the I/O operation. The retry value can be from 1 to 60 attempts.
The default value is 0, do not retry.

Note: BEA Systems recommends this retry feature be avoided and the customer focus placed on the repair of the network that is generating these up/down transitions between hosts.

DMQLD_TCP_UNREACH_DELAY5

.

Used in conjunction with the DMQLD_TCP_UNREACH_RETRY to vary the delay between retry attempts. This value is not used if DMQLD_TCP_UNREACH_RETRY is not enabled.
The default value is 60 seconds.

DMQNS_DEFAULTPATH

.

Directory specification of the namespace root directory.

DMQNS_DEVICE

.

The default pathname for the namespace (based on the definition for DMQNS_DEVICE).

1Set by DMQ$BOOT.COM.
²Optionally set by DMQ$BOOT.COM.
³Optionally set by user at DCL level.
4Set by DMQ$SET_SERVER_LOGICALS.COM.
5Optionally set by DMQ$SET_SERVER_LOGICALS.COM.