# Define Msg-Field or Buffer-Field Conversion Panel

You can map the fields of a message definition with the fields of a buffer definition for a conversion rule in the Define Msg-Field / Buffer-Field Conversion panel.

## Panel Layout

    SXTP03F --------- Define Msg-Field / Buffer-Field Conversion - Row 1 to 1 of 1
    Command ===>                                                   Scroll ==> CSR

     Conversion Id   ===> New_Rule1
     Using Message   ...: New-Msg1
     Using Buffer    ...: New-Buffer1
     Max Buffer Size ===> 0

    Trunc Reqd BfFld Msg Field                | Num Buffer Field
      -    -   ----- ------------------------ | ---- -----------------------------
      Y    Y   1     String-field             | 1 STRING-FIELD
    ******************************* Bottom of data ********************************

## Field Description

The following table lists the fields in the Define Msg-Field / Buffer-Field Conversion panel:

Field | Description
--- | ---
Conversion Id | The name of the conversion rule.
Using Message | The name of the message definition.
Using Buffer | The name of the buffer definition.
Max Buffer Size | Optional. The maximum size of the buffer (data area) for communication. Numeric value only. Default value: 0. When this value is 0, the size of the buffer is determined by the field definitions. When this value is not 0, this value overrides the determination from the fields. The size you specify must be greater than or equal to the field determination.
Trunc | You can specify whether to truncate data that extends beyond the specified buffer length allocated for a message field. If the inbound data is longer than the available space in the destination buffer and the truncate option is set to Y, the string is limited to the length specified in the Buffer Length field on Buffer Field Details panel. If the data exceeds the specified length and the truncate option is set to N, the conversion fails. Valid selections: Y(es), N(o) and S(ystem). Default selection: Y. S specifies that the field is a system field, in which case no mapping to the buffer field is required.
Reqd | Required. You can specify whether the field is required for a conversion. Valid selections: Y(es) and N(o). Default selection: Y. For an inbound process, if you set this field to Y, the transaction is not completed successfully unless a field with this name is encountered in the inbound Rendezvous message. If you set this field to N, no specific check is made as to the availability of that message field in the Rendezvous message. For an outbound process, if you set this field to N, and the data type is numeric and the contents of the field is not initialized by the host-side application, the field is initialized by the Transformer and no editing errors occur.
BfFld | The sequence number of the buffer field that is to be mapped to the message field.
Msg Field | The name of the field in the message definition.
Num | The sequence number of the field in the buffer definition.
Buffer Field | The name of the field in the buffer definition.

Copyright © TIBCO Software Inc. All rights reserved.