System Messages: TMQ Catalog 2400-2499


2406	ERROR: Unable to get `DMQ_GROUP_ID` environment variable.
	Description	Need environment variable DMQ_GROUP_ID to be set.
	Action	Properly export the DMQ_GROUP_ID environment variable.

2411	ERROR: Queue names ranging from [74-76], [90-100], [150-199], [4000-6000] are reserved for internal use.
	Description	If queue name is a numeric value, the ranges from [74-76], [90-100], [150-199], [4000-6000] are reserved for internal use.
	Action	Modify the queue name.

2412	ERROR: TMSNAME must begin with TMS_TMQM.
	Description	The TuxMsgQ server configuration in the TUXCONFIG file *GROUPS section does not have the TMSNAME set to TMS_TMQM. The server will not boot.
	Action	Change the TUXCONFIG file to have the TMSNAME set to TMS_TMQM and reboot the TuxMsgQ server.

2420	*ERROR: FML32 error error.*
	Description	When adding or updating a field from an FML buffer, an error occurs. This error occurs when running `Fchg`(3fml) or `Fadd`(3fml).
	Action	Try running the command again. If it fails consistently, contact Oracle Tuxedo Customer Support.
	See Also	`Fchg`(3fml), `Fadd`(3fml)
2431	*ERROR: Cannot configure more than one server* in a group.**
	Description	Only one TMQ_NA or TuxMQFWD is allowed in the same group in the UBBCONFIG file *SERVER section. If more than one, the server will not boot.
	Action	Remove all but one TMQ_NA or TuxMQFWD in the same group in UBBCONFIG file *SERVER section and reboot the server.

2433	*ERROR: Environment variable* set to an invalid value. Ignore it.**
	Description	Environment variables `DMQ_GROUP_ID` or `DMQ_BUS_ID` need to be set.
	Action	Properly export the environment variables `DMQ_GROUP_ID` or `DMQ_BUS_ID`.

2441	*ERROR: The maximum filter memory size cannot be less than default max filter size.*
	Description	When running qspacecreate, the valid filter memory size values cannot be less than the default max filter size.
	Action	Change the filter memory size number to be no less than the default max filter size.

2442	*ERROR: Invalid message class Message Class.*
	Description	The message class is neither `ACK_CLASS` nor `MSG_CLAS_PAMS`.
	Action	Change the message class to `ACK_CLASS` or `MSG_CLAS_PAMS`.

2447	ERROR: Memory allocation failure.
	Description	An attempt to dynamically allocate memory using `tpalloc`() failed.
	Action	Use `tpalloc` to allocate a typed buffer again. If it fails consistently, contact Oracle Tuxedo Customer Support.
	See Also	`tpalloc`(3)
2449	*ERROR: Failed to subscribe. tperrno error.*
	Description	An attempt to subscribe a topic failed.
	Action	Contact Oracle Tuxedo Technical Support and provide the error.
	See Also	`tpqsubscribe`(3c)
2450	ERROR: Duplicated subscription.
	Description	Attempt to subscribe a duplicated topic.
	Action	Contact Oracle Tuxedo Technical Support.
	See Also	`tpqsubscribe`(3c)
2451	*ERROR: Failed to unsubscribe. tperrno error.*
	Description	An attempt to unsubscribe a topic failed.
	Action	Contact Oracle Tuxedo Technical Support and provide the error.
	See Also	`tpqunsubscribe`(3c)
2453	*ERROR: Service name of service routine TuxMsgQ* cannot exceed the max length of service name characters.**
	Description	The length of TuxMsgQ service name is more than 128 characters (i.e., len characters or more).
	Action	Re-enter the command with a threshold command that is 128 characters or less in length.
	See Also	`TuxMsgQ`
2459	ERROR: The owner must be a valid primary queue.
	Description	When the "-o" option is used to create/change the secondary queues in the tmqadmin command, if the owner is not the valid primary queue, an error is returned.
	Action	The owner should be a primary queue previously created in the same qspace.

2460	ERROR: Write SAF, message length exceeds block size.
	Description	When `WSC_JOURNAL_CYCLE_BLOCKS` environment variable is non-zero, if `WSC_JOURNAL_MSG_BLOCK_SIZE` environment variable is not set or its value is zero, an error is returned.
	Action	When `WSC_JOURNAL_CYCLE_BLOCKS` environment variable is non-zero, the value of `WSC_JOURNAL_MSG_BLOCK_SIZE` environment variable must be non-zero.

2462	*ERROR: Failed to allocate blocks for SAF journal, errno = os_errno.*
	Description	Failed to initialize the `tmqsaf.jrn`.
	Action	According to os_errno, check the file system where `tmqsaf.jrn` is located.

2463	*ERROR: Failed to write SAF journal header, errno = os_errno.*
	Description	Failed to write SAF journal header into `tmqsaf.jrn`.
	Action	According to os_errno, check the file system where `tmqsaf.jrn` is located.

2464	ERROR: SAF structure does not match configuration `WSC_JOURNAL_PREALLOC/WSC_JOURNAL_FIXED_SIZE/WSC_JOURNAL_CYCLE_BLOCKS`.
	Description	The environment variables cannot be changed after `tmqsaf.jrn` is created.
	Action	Properly export the environment variables.

2465	ERROR: SAF journal block size does not match configuration `WSC_JOURNAL_MSG_BLOCK_SIZE`.
	Description	The `WSC_JOURNAL_MSG_BLOCK_SIZE` environment variable does not match the SAF journal block size read from `tmqsaf.jrn`.
	Action	Reset `WSC_JOURNAL_MSG_BLOCK_SIZE` environment variable to match the SAF journal block size in `tmqsaf.jrn`.

2466	ERROR: Configuration `WSC_JOURNAL_SIZE` is greater than fixed file size.
	Description	If the file size of `tmqsaf.jrn` is fixed and it is a journal cycle file, its file size should be greater than the `WSC_JOURNAL_SIZE` environment variable value.
	Action	Reset the `WSC_JOURNAL_SIZE` environment variable value to be less than the `tmqsaf.jrn` file size.

2467	*ERROR: Fixed SAF file size is too small, should be file_size.*
	Description	When the `tmqsaf.jrn` file size is fixed and it is less than the `WSC_JOURNAL_SIZE` environment variable value, if it fails to extend the size to file_size, an error is returned.
	Action	Try running the command again. If it fails consistently, contact Oracle Tuxedo Customer Support.

2468	*ERROR: Failed to read message header from SAF, returned return_val, errno = os_errno.*
	Description	Failed to read message header from SAF
	Action	According to os_errno, check the file system where the `tmqsaf.jrn` is located.

2469	ERROR: Read SAF, message buffer allocation failed.
	Description	Failed to enlarge or free message buffer.
	Action	Try running the command again. If it fails consistently, contact Oracle Tuxedo Customer Support.

2470	*ERROR: Failed to read var* bytes message from SAF, returned return_val, errno = os_errno.**
	Description	Failed to read message from SAF into message buffer.
	Action	Try running the command again. If it fails consistently, contact Oracle Tuxedo Customer Support.

2471	*ERROR: SAF is full, cannot extend for var* bytes message.**
	Description	There is no more space to put the message when the `tmqsaf.jrn` file size is fixed.
	Action	Restart the client after increasing the `WSC_JOURNAL_SIZE` environment variable value.

2473	*ERROR: Failed to write message header to SAF, errno = os_errno.*
	Description	Failed to write message header to `tmqsaf.jrn`.
	Action	Try running the command again. If it fails consistently, contact Oracle Tuxedo Customer Support.

2474	*ERROR: Failed to write message to SAF, errno = os_errno.*
	Description	Failed to write message to `tmqsaf.jrn`
	Action	Try running the command again. If it fails consistently, contact Oracle Tuxedo Customer Support.

2475	*ERROR: Failed to send message from SAF tmqerrno, target address [qspace, qname], message class msgClass, type msgType, size msgSize, message deleted from SAF journal.*
	Description	Resending message from SAF journal failed due to bad parameter, message is dropped from SAF journal.
	Action	Provide the correct parameters.

2480	*ERROR: `DMQNS_DEFAULTPATH` environment variable is too long; it should be less than length.*
	Description	Before booting TMQ_NA, the `DMQNS_DEFAULTPATH` environment variable should be set. Its length must be less than length.
	Action	Properly export the `DMQNS_DEFAULTPATH` environment variable.

2483	*ERROR: `DMQNS_DEVICE` environment variable is too long; it should be less than length.*
	Description	Before booting TMQ_NA, the `DMQNS_DEVICE` environment variable should be set. Its length must be less than length.
	Action	Properly export the `DMQNS_DEVICE` environment variable.

2484	ERROR: TMQ_NA cannot initialize bus namespace.
	Description	If TMQ_NA supports global (bus) namespace, it sets the namespace path location that points to the default namespace root directory. The total length of `DMQNS_DEVICE` and `DMQNS_DEFAULTPATH is too long.`
	Action	Properly export the `DMQNS_DEVICE` and `DMQNS_DEFAULTPATH.`

2485	*ERROR: Failed to advertise xx_GLOBAL_NA* service for OTMQ NAMING SERVER. tperrno=error messag.**
	Description	TMQ_NA attemps to advertise 'xx_GLOBAL_NA'. If an error occurs when attempting to advertise this service, an error is returned.
	Action	Increase the `MAXSERVICES` parameter in the `ubbconfig(5)` file. Run `tmloadcf(1)` on the new file. Reboot the application. If this error occurs consistently, contact Oracle Tuxedo Technical Support.

2486	ERROR: TMQ_NA cannot initialize group namespace.
	Description	TMQ_NA will initialize group namespace in its own process space. It will load the specified qalias-file by the `tmqadmin()` subcommand `qspacecreate` into memory. If it cannot read the qalias-file specified by `qspacecreate`, an error is returned. When this TMQ_NA supports global naming, either `DMQNS_DEVICE` or `DMQNS_DEFAULTPATH` is not set, an error is also returned.
	Action	Confirm the qalias-file location is correct. If the TMQ_NA supports global naming, both `DMQNS_DEVICE` and `DMQNS_DEFAULTPATH` need be set.

2487	*WARN: Naming configuration is wrong. This record is ignored. alias.*
	Description	If the alias type is neither local(l/L) nor global(g/G), ans error is returned.
	Action	Correct the alias type.

2490	*ERROR: qspace name cannot be NULL and its length should be less than length.*
	Description	There are two options "-r" and "-g" in TMQ_NA's clopt. They are used to indicate which qspace provides the global naming service. When the qspace is NULL or its length is too long, an error is returned.
	Action	Provide the correct qspace name or group id.