Important

   

This documentation space contains information about PATROL Agents when deployed in a TrueSight Operations Management environment. If you are a BMC Helix Operations Management user, see PATROL Agent 22.1 for BMC Helix Operations Management. Open link

dget_text()

Get message text by defining locale domain.

Syntax

dget_text(domain_name, message_ID)

Parameters

Parameter

Definition

domain_name

file name for message catalog Use only characters that are permitted in file names.

message_ID

text string that identifies a message

Description

The dget_text() function returns a message that has a text string as the message ID. The get_text() and dcget_text() functions serve the same purpose, but dget_text() requires that you specify domain_name. You do not specify a locale category for dget_text(), because this function uses the MESSAGES category of the current locale. The domain_name and category determine the name of the catalog file and the directory path according to the following format:

PATROL_HOME/lib/nls/locale/locale_name/ML_category/domain_name.bo

The dget_text() function returns message_ID when it cannot find a message that matches the relevant message_ID, domain_name and category. It also returns message_ID when the current locale is the same as the CTYPE locale.

Note

This function provides support for internationalized PSL scripts. For more information about internationalization, see Internationalized PSL Scripts.

Example

The following is an example of the dget_text() function.

function display_dget_text(domain, msg_id)
{
ret = dget_text(domain, msg_id);
printf("Message = %s \n", ret);
}
display_dget_text("test_msg", "hello");
Was this page helpful? Yes No Submitting... Thank you

Comments