OSF DCE Application Development Guide--Core Components

Attribute Conﬁguration Language

characters in in parameters must use the cs_stag attribute in the associated ACF.

The cs_drtag attribute has the following syntax:

operation_name ([cs_drtag] parameter_name);

The cs_drtag attribute identiﬁes the code set the client would like the server to use

when returning international characters.

The cs_rtag attribute has the following syntax:

operation_name ([cs_rtag] parameter_name);

The cs_rtag attribute identiﬁes the code set that is actually used when the server sends

international characters to the client. Operations deﬁned in the IDL ﬁle that specify

international characters in out parameters must apply the cs_rtag attribute in the

associated ACF.

Example Using the cs_stag, cs_drtag, and cs_rtag Attributes

Here is an example ACF for an IDL ﬁle in which the operation my_op has the tag

parameters my_stag, my_drtag, and my_rtag, whose types are either unsigned long or

[ref] unsigned long.

my_op( [cs_stag] my_stag, [cs_drtag] my_drtag, [cs_rtag] my_rtag);

For more information about the cs_stag, cs_drtag, and cs_rtag ACF attributes and their

use in internationalized RPC applications, see Chapter 15 of this guide.

18.3.16 The cs_tag_rtn Attribute

The cs_tag_rtn attribute is an ACF attribute for use in RPC applications that handle

international character data. This attribute speciﬁes the name of a user-written routine

that the client and server stubs will call to set an operation’s code set tag parameters to

speciﬁc code set values. The cs_tag_rtn attribute is an optional ACF attribute that you

can use to provide code set tag transparency for callers of your interface’s operations. If

an operation that transfers international character data has the cs_tag_rtn attribute

applied to it in the corresponding ACF, the code set tag parameters will not appear in the

operation’s deﬁnition within the generated header ﬁle. If the cs_tag_rtn attribute is not

used, the operation’s caller must provide appropriate values to the operation’s code set

tag parameters before international character data is marshalled.

The cs_tag_rtn attribute has the following syntax. (See the example at the end of this

section.)

For an interface—

[cs_tag_rtn(tag_set_routine)] interface interface_name

For an operation—

124245 Tandem Computers Incorporated 18− 25