Handling Updates to the OS 2200 Open DTP Service Name

When you created a server message for an OS 2200 Open DTP Data Source, you specified the message direction as follows:

If you selected Input or Both Input and Output for the message direction, then you had the option of providing a value for the Open DTP service name. Refer to the “Importing Open DTP Records” topic in Creating an OS 2200 Open DTP Data Source Project.

As described in Metadata Fields, the server message includes a metadata field named tpservicename__ to represent the Open DTP service name.  This field has the following property settings:

The InitialValue property represents the initial value for the field.  For a Web page presentation, the Visible property controls whether the Web page contains a control for the field or not. For a Web service presentation, the Visible property controls whether the field is included as a parameter for the Web method or not.

If you need to set or update the service name after the import, perform the following procedure to set the service name:

  1. In the ePortal Message View window, expand the Server Messages folder, right-click the server message to be modified, and click Edit. The server message appears in the <server message name>.eprec tab.

  2. Click on the field tpservicename__ to select it.

  3. Press Alt-Enter to open the property window to see the field properties.

  4. Enter the new service name for the InitialValue property.  Make sure the Visible property is False.

  5. Click Save from the File menu to save the changes.

  6. If the property AutoRecreateClient is False, repeat steps 1-5 above for the corresponding client message.

If you want to specify the service name at runtime rather than at design time, perform the following procedure:

  1. In the ePortal Message View window, expand the Server Messages folder, right-click the server message to be modified, and click Edit. The server message appears in the <server message name>.eprec tab.

  2. Click on the field tpservicename__ to select it.

  3. Press Alt-Enter to open the property window to see the field properties.

  4. Set the Visible property is True.  After a project build, this will cause this field to appear in the presentation so that it can be set at runtime.

  5. You can set InitialValue to a default value if you like, or you can leave this blank.

  6. Click Save from the File menu to save the changes.

  7. If the property AutoRecreateClient is False, repeat steps 1-6 above for the corresponding client message.