Importing data structures into the IMS Explorer Transaction Message Metadata Editor

You can specify the input and output messages for your IMS mobile service by importing one or more data structure files (COBOL copybooks or PL/I includes) into your IMS Mobile project.

To import data structures:

  1. From the IMS Explorer Transaction Message Metadata Editor, select Input messages in the navigation tree and click Import data structure.
    Tips:
    • If you select a segment or any of the nodes below a segment before you click Import data structure, the wizard automatically populates the specified segment as the target.
    • Start of changeIf the data structure has changed for an existing transaction message, you can reimport the data structure file by clicking Import data structure. Existing custom data structure names (aliases) and remarks are preserved if the 01 level structure remains unchanged. End of change
  2. Specify the location to import the data structures from, and specify the file type.
  3. Click Browse to select the data structure file that contains the COBOL copybooks or PL/I includes to import.
    Tip: If you are importing an application source file that references a COPY or INCLUDE file, import from a local file system with both the application source file and the referenced file in the same directory.
    • If you import the data structures from z/OS, the data structure file does not have a file extension. It takes the file type that is specified in 2.
    • If you import the data structures from a local file system, a file with one of the following extensions takes that file type as default:
      • A COBOL copybook can have any of the following file name extensions: .cbl, .ccp, .cpy, or .cob.
      • A PL/I include can have any of the following file name extensions: .pli, .inc, or .mac.
      Tip: If the file extension is incorrect for the type of file type that the file is, either change the file extension or click Window > Preferences > Importer, and then select either COBOL or PL/I from the list on the left. Then, edit the type of file that is indicated by each file extension.

      If the data structure file does not have a file extension, it takes the file type that is specified in 2.

  4. Select the data structure name and the associated message and segment to import the data structure into.
  5. Click Add to Import List.
  6. In the Import data structure wizard, select Output messages in the navigation tree and click Import data structure.
  7. Repeat steps 3 through 5 for each data structure that you want to import as an output message.
  8. Click Finish to import the fields into the input or output message.
    Start of changeIf you are updating an existing data structure, a dialog opens. Click Yes to replace the existing data structure and preserve your aliases and remarks. Click No to add the data structure as a new, separate data structure.
    Tip: Start of changeFor each additional segment, click the Segments folder and click Add. Repeat the steps from step 3 for each data structure that you want to import as input and output messages. For more information and restrictions, see Adding segments to transaction messages.End of change
    End of change