D.2 Logical Names
Table D-2 lists the 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.
Logical Name | Dynamic | Description |
---|---|---|
DMQ$ACCESS¹ | . | Directory specification of 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 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$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 MessageQ logs events to SYS$OUTPUT.
YES = Printing disabled. |
DMQ$DISK¹ | . | Device specification of the disk where MessageQ is installed. |
DMQ$DOC¹ | . | Directory specification of MessageQ documentation. |
DMQ$DNS_DIRECTORY³ | . | Default DNS namespace and specification used by various MessageQ routines. |
DMQ$ENTRYRTL¹ | . | File specification of the installed MessageQ run-time library DMQ$ENTRYRTLV nn.EXE. |
DMQ$ERROUT² | Y | Device specification of the alternate MessageQ console device. If not specified, MessageQ messages are printed on the system console. |
DMQ$EXAMPLES¹ | . | Directory specification of MessageQ example programs. |
DMQ$EXE¹ | . | Directory specification of MessageQ executable modules. |
DMQ$EXECRTL¹ | . | File specification of the installed EXEC mode MessageQ routines in EXECRTLV nn.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_SYNCHRONIZE 4 | . | 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 MessageQ message headers on the user's terminal.
YES = print message headers. |
DMQ$INIT_FILE¹ | . | File specification of the MessageQ initialization file. |
DMQ$LIB¹ | . | Directory specification of the
MessageQ libraries. |
DMQ$LOG¹ | . | Directory specification of the
MessageQ user area. |
DMQ$MRS¹ | . | Directory specification for the MRS data files. |
DMQ$MRS_CHECK_ML 5 | . | Enables MRS validation scan of the internal MRS message list. For troubleshooting purposes only. |
DMQ$MRS_CHECK_PL 5 | . | Enables MRS validation scan of the internal MRS process list. For troubleshooting purposes only. |
DMQ$MRS_CHUNK_SIZE 4 | . | Controls the journaling chunk size for DQF and SAF journals. |
DMQ$MRS_CLEANUP_ON_CLOSE 5 | . | Enables MRS to delete a DQF or SAF journal file on close if the file is empty. |
DMQ$MRS_DISABLE_JOURNALING 4 | . | Disables all journaling. This logical is processed by the COM Server only. Default is NO. |
DMQ$MRS_DQF_CONTROL 5 | . | Disables operation of DQF files unless explicitly requested by a control message. |
DMQ$MRS_FREE_FILE_MAX 4 | . | 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_MIN 4 | . | 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_DEPTH 5 | . | 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_DEPTH 5 | . | Controls the depth of the confirmation ring buffer. The default value is 10. |
DMQ$MRS_SAF_CONTROL 5 | . | Disables operation of SAF files unless explicitly requested by a control message. |
DMQ$MRS_SERVER_CHECK_TIMER 5 | . | 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_PL 5 | . | Enables MRS tracing of the internal MRS process list. For troubleshooting purposes only. |
DMQ$MRS_TRACE_STATE 5 | . | Enables MRS tracing of internal MRS state changes. For troubleshooting purposes only. |
DMQ$MSGSHR¹ | . | File specification of the 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_INTERVAL 4 | . | Controls the number of seconds between low buffer pool warning messages. The default is 120 seconds. |
DMQ$OPCOM_TARGET² | Y | Redirects console event logging to OPCOM. See Chapter 13 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, or SYSERR. |
DMQ$PROCESS_OUTPUT³ | Y | Sets output direction to any of the following file output streams: console, EVL_LOG, USER_LOG, SYSOUT, or SYSERR. |
DMQ$TRACE_OUTPUT³ | Y | Sets output direction to any of the following file output streams: console, EVL_LOG, USER_LOG, SYSOUT, or SYSERR. |
DMQ$QTRANSFER_MAX_PROCS 5 | . | 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
MessageQ software being used (for example, DMQVnn). |
DMQ$SBS_ETH_MOT_ONLY 5 | . | Allows only Ethernet broadcasting via the SBS server when set to YES.
The default is NO. |
DMQ$SBS_MAX_ASM_Q 5 | . | Overrides the default number of SBS assembly queues.
The default is 10. |
DMQ$SBS_MAX_MSG_SIZE 5 | . | Overrides the default size of the SBS assembly queue. Can not exceed 32000. |
DMQ$SBSE_REXMIT_TIMEOUT 5 | . | Overrides the default retransmission timer.
The default is 30 seconds. |
DMQ$SBSE_mmmm_MAX_HB 5 | . | Overrides the maximum heartbeat interval for the specified MOT mmmm defined in the group initialization file. |
DMQ$SBSE_mmmm_POLL_INT 5 | . | 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 MessageQ global sections. |
DMQ$SERVER_TRACE³ | Controls the tracing of 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 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_CON_ABORT
DMQ$DECNET_CON_ABORT 5 |
. | 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_NAME 5 | . | 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. |
DMQLD_TRACE_LEVEL 5 | . | 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_TIMEOUT 5 | . | 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_INTERVAL 5 | . | Defines the interval between pings.
The default value is 30 seconds. |
DMQLD_MAX_DATAIO_LEN 5 | . | 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_RETRY 5 | . | In the case where we have a TCP stack which reports a warning for NETUNREACH or HOSTUNREACH, we offer a retry for the I/O operation. The retry value can be from 1 to 60 attempts.
The default value is 0, NOT to retry. NOTE: BEA 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_DELAY 5 | . | 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. |
This appendix provides the following error log information:
This section lists and describes COM Server and Link driver error log messages. Use the following Key to understand conventions used in this section:
Key:
Accepting connect from system system_name (as alias alias_name n.n.n.n) for group g (group_name)
The message indicates that the connection will be accepted, but under
the name "alias_name" instead; to match existing definitions
in the MessageQ initialization file and enforce consistency. All
further console messages referring to this connection will display the
"alias_name" system name, as will the MessageQ Monitor
program(s).
User Action: If aliases are being used and both names
refer to the same system, no action is necessary.
:
If the indicated system names "system_name" and "alias_name" do not refer to the same system, this indicates there are two systems on your network with the same network address, or with inconsistent network databases. You'll need to correct this situation and update the MessageQ initialization file if necessary.
Accepting connect from system system_name for group g (group_name)
Accepted connect from system system_name for group g (group_name)
An error occurred while freeing messages for process q PID (pid)
Attempt to double define group g into the RT
Bad DECnet connect IOSB status for link to group g (group_name) on system system_name
Bad PAMS_SET_TIMER return status for X-Group auto reconnect
Bad PAMS_SET_TIMER return status for X-group connect
Bad PAMS_SET_TIMER return status for X-group connect to group g
Bad PAMS_SET_TIMER return status for X-Group link protocol
Bad status from LIB$ASN_WITH_MBX in XDECNET
Bad XDECNET_POST_OOB_READ call
Bad XDECNET_POST_OOB_READ call for self
Changing outbound for group g (group_name) to match inbound
Connection for group g (group_name) to system system_name is down
Could not locate transport address (port number)
DECnet communications lost to message queue group g (group_name)
DECnet communications lost to message queue group g (group_name) --- file not accessible
DECnet communications lost, 3rd party, to message queue group g (group_name)
DECnet data overrun from message queue group g (group_name)
DECnet link exit to message queue group g (group_name)
DECnet path lost to message queue group g (group_name)
Detected DECnet network shutdown
Dropped link to group g (group_name)
Dropped link to group g (group_name) due to LLS buffer pool exhaustion
Dropped link to group g (group_name)
Dropped link to remote logical group g which is incompatible with expected group g (group_name)
Duplicate process notification request from g.q discarded
Duplicate queue notification request from g.q
Duplicate Queue number passed to ENQ_PROCESS_LOCK_ASK routine = q
ENQ failed for "lock_name"
ENQ failed for DMQCS_GRP_LOCK of group g
ENQ for "lock_name" not previously locked by process, releasing lock
ERROR --- No available temporary queues
Error converting protocol for group g (group_name)
Error during QIO xgroup send - grp:g
Error while posting X-group rcv QIO for group g - channel #n
Error from X410_POST_READ_OOB_CHAN QIO for group g --- channel #n
Error returned from X200_POST_CONNECT_REQUEST QIO
Error while posting X-group rcv QIO for group g --- channel #n Dropped connection to group g
Exceeded max number of outstanding queue cleanup requests - request q dropped.
Exceeded process notification table --- request from g.q discarded
Exceeded queue notification table --- request from g.q
Exceeded routing visit count - UMA taken
+ discarded msg --- Src=g.q Target=g.q class=n type=n
Exceeded write quota on link
+ discarded msg --- Src=g.q Target=g.q class=n type=n
Exceeded X-Group notification table --- request from g.q discarded
Failed on DMQCS_XDN_GET_READ_BUFFER
Failed on $CRELNM of termination mailbox lnm
Failed on $GETDVIW of temporary mailbox for Server spawning
Failed on LIB$GET_VM_PAGE for DECnet MBX
Failed on LIB$GET_VM_PAGE for DECnet abort link driver
Failed on LIB$GET_VM_PAGE for DECnet TCB buffer
Failed on LIB$GET_VM_PAGE for DECnet LCB
Failed on LIB$SPAWN of Server server_name
Failed on SYS$GETJPIW call for DMQ queue g.q
Failed on searching rights list for "username" for DMQ queue g.q
Failed on termination mbx SYS$QIO
Failed to accept connect request from system system_name for group g
Failed to accept connect request from system system_name for group g (group_name)
Failed to allocate GROUP entry during connect from group g --- Link dropped
Failed to allocate local buffer for I/O to group g (group_name)
Failed to allocate group entry during connect from group g - Link dropped to system system_name.
Failed to allocate msg buffer for sending X-Group msg to group g (group_name)
Failed to allocate msg buffer for group notify msg.
Failed to allocate msg buffer for notify msg
Failed to connect group g (group_name) to system system_name - System name is unknown
Failed to convert outgoing message
+ discarded msg --- Src=g.q Target=g.q class=n type=n
Failed to create temporary mailbox for Server spawning
Failed to create termination mailbox read buffer
Failed to map global section --- program exiting
Failed to create MessageQ DECnet object --- DECnet DISABLED
Failed to create n DECnet x-group queue heads n pagelets.
Failed to create DECnet x-group write tokens
Failed to create DECnet x-group write tokens free list
Failed to create Event Logger MBX
Failed to create n entry RT Notify Table
Failed to create n entry Queue Notify table
Failed to find group entry during connect from group g
** Failed to init the print stream **
Failed to initialize DECnet communication
Failed to load NT into TCB for group g (group_name), table entry = group_index, NT = cur_nt
Failed to send group notify msg to g.q
Failed to send notify msg to g.q
Failed to send PAMS request CHKPT_FILE_RESP msg to g.q
Failed to send PAMS request NAK msg to g.q
Failed to send queue notify msg to g.q
Failed to send RT update notify msg to g.q
Failed to start network listener
Failed to startup the MessageQ Event Logger - Exiting
Failed to startup the server_name
Failed to translate rights ID "rights_id" for DMQ queue g.q
Failed to wakeup process to complete the queue attach --- PID: "pid"
Fatal error while creating GNT
Fatal error while creating Large LLS Pool
Fatal error while creating MCS
Fatal error while creating MRQ Section
Fatal error while creating Medium LLS Pool
Fatal error while creating Small LLS Pool
GNT already exists --- Reinitializing
Group g (group_name) OUTBOUND link to system system_name is not responding
Ignored connect confirm from system system_name group g due to security match failure
Ignoring connect request from system system_name - group g is in link management transition
Ignoring connection for group g (group_name) from system system_name --- link already established
Ignoring connection from system system_name for group g group_name --- connection already on another transport
Ignoring LD_REQUEST_ACCEPTED msg from g.q --- cannot locate link
Ignoring LD_REQUEST_ACCEPTED msg from g.q --- unexpected error
Ignoring LD_REQUEST_DENIED msg from g.q --- cannot locate link
Ignoring LD_REQUEST_DENIED msg from g.q --- unexpected error
Invalid disable queue notification request from g.q
Invalid DMQ$BUS_GROUP = "s"
Invalid queue list request from g.q
Invalid Queue Notification Request from g.q
Invalid msg targeted to server_name
+ discarded msg - Src=g.q Target=g.q class=n type=n
Invalid X-Group number g specified for self
Invalid X-Group request to declare a temporary SQ - Source=g.q
Invalid undeclare SQ request --- SQ #q Source=g.q
Large buffer size is too small, adjusting large buffer size to n
Large LLS Pool already exists --- two DMQ COM Servers running.
Link Driver has terminated
Link Management request from g.q rejected
Listener is down - network not currently accessible
Load complete message received from g.q --- Ignored
Local host address lookup failed
Local host name lookup failed
Local system is system_name, transport addr s
Local system system_name is not listed for this group g under this transport
Local system name is too long
Logical DMQ$SET_GBLSEC_PROT value "s" is invalid
** LOW BUFFER WARNING --- LARGE FREE LIST --- TOTAL:n CURR:n WARN:n **
** LOW BUFFER WARNING --- MEDIUM FREE LIST --- TOTAL:n CURR:n WARN:n **
** LOW BUFFER WARNING --- SMALL FREE LIST --- TOTAL:n CURR:n WARN:n **
MCS already exists --- two DMQ COM Servers running.
Medium buffer size is too small, adjusting medium buffer size to n
Medium LLS Pool already exists --- two DMQ COM Servers running.
Message lost (undeliverable)
+ discarded msg --- Src=g.q Target=g.q class=n type=n
Message received from bus returned error
Msg from system system_name is larger than negotiated maximum for group g (group_name)
MONITOR terminate requests are disabled
Msg lost (bad target address)
+ discarded msg --- Src=g.q Target=g.q class=n type=n
Network listener has been restarted
Network listener is down!
Network is down - all links will be dropped
Network protocol error occurred for message queue group g (group_name)
No available temporary queues - Unable to allocate temp SQ - Source=g.q
No available temporary queues --- Unable to allocate queue --- Source=g.q
No memory for buffer for message queue group g (group_name)
Protocol error on OUTBOUND link for group g (group_name) to system system_name
Rejected connect attempt to/for group g - Ownership transfer denied by g.q
Rejected connect request for group g - system could not be determined
Rejected connect request for group g from system system_name (system_address) - address disagrees with network database
Rejected connect request for group g from system system_name - outbound attempt failed
Rejected connect request for group g from system system_name (system_address) - system not found in network database
Rejected connect request from system system_name due to security match failure (group unknown)
Rejected connect request from system system_name due to wrong bus
Rejected connect request from system system_name group g due to security match failure
Rejected connect request from system system_name for group g (group_name) - Connection already in progress by b.g
Rejected connect request from system system_name for group g (group_name) - connection currently in progress
Rejected connect request from system system_name for group g (group_name) - connection still in progress
Rejected connect request from system system_name group g - Group disabled
Rejected connect request from system system_name for group g (group_name) - group is already connected
Rejected connect request from system system_name for group g (group_name) - group is disabled
Rejected connect request from system system_name (system_address) - Improper Protocol response received
Rejected connect request from system system_name for group g group_name -Link Driver or network is shutting down
Rejected connect request from system system_name for group g (group_name) - Link is currently in transition
Rejected connect request from system system_name for group g (group_name) - Lost conflict resolution
Rejected connect request from system system_name for group g (group_name) - read link is currently in transition
Rejected connect request from system system_name for group g (group_name) - write link is currently in transition
Rejected connect request from system system_name (system_address) - protocol not supported
Remote system not listed for this group/transport
Server_name has exited
Skipping connect to group g (group_name) - Failed to send external ownership request to b.g
Skipping connect to group g (group_name) - No outbounds possible or allowed
Skipping connect to group g (group_name) - System address cannot be determined
Skipping connect to group g (group_name) - unexpected error encountered
Small LLS Pool already exists --- two DMQ COM Servers running.
Starting server_name
Server_name Initialized
SYS$CRELNM failed to create logical_name in lnm tbl table_name
SYS$CRELNM failed to create DMQ$VERSION
This linkdriver is already running --- exiting
This transport is not listed for this group g
Timed out waiting for link driver(s) to start
Transport address doesn't match xgroup entry
Transport address is already in use by another process
Transport not supported by group
TP PROTOCOL ERROR: invalid substate n on INBOUND link to group g (group_name)
TP PROTOCOL ERROR: invalid substate n on OUTBOUND link to group g (group_name)
Unable to deassign DECnet data I/O channel for group g in XDECNET
Unable to deassign DECnet OOB channel for group g in XDECNET
Unable to declare temporary SQ --- Source=g.q
Unable to locate DECnet TCB for group g
Unable to locate local group definition --- Cross-group disabled
Unable to return link management response to g.q
Unable to return list of groups to g.q
Unable to return list of processes to g.q
Unable to return list of queues to g.q
Unable to return queue notify disable response to g.q
Unable to send link arbitration msg for group g to g.q
Unable to send message to target - exceeded x-group buffer maximum
+ discarded msg - Src=g.q Target=g.q class=n type=n
Unblock msg lost (buffer allocation failed)
XGroup not enabled --- program exiting
X-Group write failed to group g (group_name)
+ Discarded msg --- Src=g.q Target=g.q class=n type=n
X-Group write failed to group g (group_name)
+ Message lost - protocol translation or UMA failure
X-Group write pool overflow for group g