System i: Programming Message Handling APIs - IBM
System i: Programming Message Handling APIs - IBM
System i: Programming Message Handling APIs - IBM
Create successful ePaper yourself
Turn your PDF publications into a flip-book with our unique Google optimized e-Paper software.
CCSID conversion status indicator for data. The following values may be returned:<br />
0 No conversion was needed because the CCSID of the data matched the CCSID you wanted the data<br />
converted to.<br />
1 No conversion occurred because either the data was 65535 or the CCSID you wanted the data converted to<br />
was 65535.<br />
2 No conversion occurred because you did not ask for any message data to be returned or the data did not<br />
contain any *CCHAR type data.<br />
3 The data was converted to the CCSID specified using the best fit conversion tables.<br />
4 A conversion error occurred using the best fit conversion tables so a default conversion was attempted. This<br />
completed without error.<br />
-1 An error occurred on both the best fit and default conversions. The text was not converted.<br />
CCSID conversion status indicator for text. The following values may be returned:<br />
0 No conversion was needed because the CCSID of the text matched the CCSID you wanted the text converted<br />
to.<br />
1 No conversion occurred because either the text was 65535 or the CCSID you wanted the text converted to was<br />
65535.<br />
2 No conversion occurred because you did not ask for any text to be returned.<br />
3 The text was converted to the CCSID specified using the best fit conversion tables.<br />
4 A conversion error occurred using the best fit conversion tables so a default conversion was attempted. This<br />
completed without error.<br />
-1 An error occurred on both the best fit and default conversions. The data was not converted.<br />
Coded character set identifier (CCSID) for data. The coded character set identifier that the replacement<br />
data is returned in. This only applies to the part of the replacement data that corresponds to a convertible<br />
character data type (*CCHAR). All other replacement data will not be converted before it is returned and<br />
can be considered to have a CCSID of 65535. If a conversion error occurs or if the CCSID you requested<br />
the data to be converted to is 65535, the CCSID of the data is returned. If there is no *CCHAR<br />
replacement data, 65535 is returned. Otherwise the CCSID you wanted the data converted to is returned.<br />
For more information about message handler and its use of CCSIDs, see CCSID support for messages.<br />
For more information about the *CCHAR field type, see the Add <strong>Message</strong> Description (ADDMSGD)<br />
command.<br />
Coded character set identifier (CCSID) for text. The coded character set identifier that the message text<br />
is returned in. If a conversion error occurs or if the CCSID you requested the message text to be<br />
converted to is 65535, the CCSID that the message text is stored in is returned. Otherwise the CCSID you<br />
wanted your message text converted to is returned. If you do not want the text converted before it is<br />
returned to you but you do want to know the CCSID that the message text is stored in, specify 65535 on<br />
the coded character set identifier to return text and data in parameter. The CCSID that the message text is<br />
stored in is returned in the coded character set identifier for text output field.<br />
This applies to the following fields only:<br />
v <strong>Message</strong><br />
v <strong>Message</strong> with replacement data<br />
v <strong>Message</strong> help<br />
v <strong>Message</strong> help with replacement data<br />
v <strong>Message</strong> help with replacement data and formatting characters<br />
v <strong>Message</strong> help with formatting characters<br />
Note: This CCSID value does not apply to the replacement data that has been substituted into the text.<br />
See the coded character set identifier for data for this information.<br />
<strong>Message</strong> <strong>Handling</strong> <strong>APIs</strong> 21