Adding a Control Number

Edit online

You can define a control number either from the control numbers page or from the partner profile's control numbers page. When you define a control number from a partner profile's control numbers page you can select whether you want to define that partner's corporation name as a sender or a receiver. For details about how to add a control number from the Partner profiles page, see Defining a Control Number for a Partner Profile.

To add a control number

  1. In IBM® webMethods B2B, go to Settings icon > Control numbers.

  2. Click Add Control Number.

  3. In the Control number definition section of the Add control number dialog box, provide the following details.

    Field Description
    Sender Sending partner's full corporation name.
    Receiver Receiving partner's full corporation name.
    Standard The EDI standard of the documents in which to use the control number. Select one of the following from the list: EANCOM, ODETTE, TRADACOMS, UCS, UNEDIFACT, VICS, X12, VDA.
    Mode The production mode associated with the interchange or group (or transmission or batch) header for which to use the control number. Possible values are:
    • Production
    • Test
    • Custom
      Note: For TRADACOMS, the only valid value is Production. For VDA, the value is always set to Custom
    Group Specifies whether the control number is to be used for an interchange (or transmission) header or a group (or batch) header. Possible values are:
    • All. If you are adding a control number that is to be used for all group-level documents.
    • Envelope. If you are adding a control number for an interchange-level (or transmission-level) document. This is selected by default.
    • Custom. If you are adding a control number for a specific group type.
    Note: For VDA, the value is always set to Envelope.
    Group name This field is enabled when you select Custom in the Group field. It specifies the name of the group. For example, for group-level (or batch-level) document that has a specific group type you can provide the following:
    • For non-TRADACOMS documents, provide the name of the group. For example, PO or IN.
    • For TRADACOMS documents, the name of the batch or file type. For example, NVHDR or ORDHDR.
    Version The version of the EDI standard selected. For example, for an ANSI X12 or UNEDIFACT interchange the version might be 00401 and for a group it might be 4010. For a TRADACOMS batch or transmission, the version can only be 1. For a TRADACOMS file, specify the version of the file document type.
    • When you select TRADACOMS as Standard the Version field is text box and you can type required value.
    • When you select TRADACOMS as Standard and Envelope as the Group, the version value in the Version field is auto-populated as 1.
  4. In the Settings section of the Add control number dialog box, provide the following details.
    Field Description
    Duplicate detection window Indicates a range of numbers that IBM webMethods B2B uses to determine whether a number is duplicate or out-of-sequence. Default value is 100. This value should be less than half the difference between the Maximum and Minimum value specified, that is: Duplicate detection window < (Maximum-Minimum)/2
    Note: This is not applicable to outbound documents.
    Next control number The next control number that you expect for the interchange or group (or transmission or batch) to use. Default value is 1. The value should be as follows: Maximum<= Next control number <= Minimum
    Minimum The lowest number that the control number can have. Default value is 1. For VDA, the minimum value is 0.
    Maximum The highest number that the control number can have. Default value is 999999. The maximum value that you can specify is 99999999999999. If IBM webMethods B2B calculates the next expected control number and that number is greater than the control number maximum, then IBM webMethods B2B sets the control number to the value you specify in the Minimum field.
    Increment The value that IBM webMethods B2B uses to increment the control number to determine the next expected control number. Default value is 1. The increment value should be within the range: Maximum ~ Minimum.

  5. Click Add. The control number is created and listed on the Control numbers page under the Control numbers defined by you section. Once a control number is created, its association with the partner can be viewed on the Partners > Partner profiles > Control numbers page. You can modify the settings configured for a control number or delete a control number by clicking