OS 2200 Open DTP View Data Source Wizard

This topic describes the OS 2200 Open DTP View Data Source Wizard screens and the procedures required to complete the wizard.

Welcome

  1. Ensure that you have completed the tasks listed in Preparing to Use the OS 2200 Open DTP Data Source Wizards.

  2. Know the data descriptions that you want to capture.

  3. Select the Don't show this welcome screen again check box to skip this screen in the future.

  4. Click Next to display the next screen.

Select View Source Files

  1. Click Add… to select one or more source files which contain View definitions.

  2. If you need to remove a file from the list, click on the file name to select it.  Then click Remove.

  3. When you have identified all of your files containing View definitions, click Next.

View Parser Errors

This dialog appears if syntax errors were detected in one of more of the source files you specified.

Remove the offending file from the list of source files or edit the source file to correct the errors detected.

Select View Subtypes

  1. To see the list of fields in a particular View, click the + to expand the tree.

  2. Click the checkbox in front of each View you want to import. This will open the Properties of View dialog box.

  3. Click Next.

Properties of View Dialog

You use this dialog to define the properties of a new ePortal Server Message representing a View data record.

  1. Use the radio buttons to define the direction of the message flow:

    • If you always use this message to send data from the client to the OS 2200 server, select Input.

    • If you always use this message to receive data from the OS 2200 server, select Output.

    • If the message might be used to both send and receive data, then select Both.

  2. If you select Output for the message direction, the View Buffer type does not need to be specified.  In this case, ePortal will accept either an X_COMMON or an X_C_TYPE buffer as a legal reply from the service on the OS 2200.

    If you select Input or Both for the message direction, you can specify the View buffer type as follows:

    • X_COMMON – This View buffer type is intended for use when invoking a server written in COBOL.  This type is more limited in the type of fields that the View may contain.  Specifically, the field types int, float, double, string, and carray cannot be used with X_COMMON.

    • X_C_TYPE – This View buffer type is intended for use when invoking a server written in C or Java.  This type allows all View field types If X_COMMON does not support all of the field types in your View definition, X_C_TYPE is the only viable choice.

        If X_COMMON supports all of the field types in your View definition, the dialog selects X_COMMON by default; you can override this and select X_C_TYPE if the service on the OS 2200 expects the buffer type to be X_C_TYPE.

  3. If you select Input or Both for the message direction, you can optionally supply the name of the Open DTP service on the OS 2200 server that you will invoke with this message.  If you supply a value, ePortal initializes the metatdata field tpservicename__ using the value you supply.

    Alternatively, you can leave the service name blank.  Later, you can supply a value for the metadata field tpservicename__ with Orchestration or by using the code in your presentation projects.  For example, you may decide to leave the service name blank if you plan to use this message to call more than one service on the OS 2200 server. Also, refer to Handling Updates to the OS 2200 Open DTP Service Name.

Completing the Open DTP View Data Source Wizard

  1. Review the list of View subtypes which you are importing.

  2. Click Finish.