Installing the Adabas/Natural Interface

How to:

The mainframe programs necessary to create Adabas/Natural programs are packaged as an archive with the iWay 6.0.1 Service Manager (SM) installation.

By default, on Windows, the archive location is:

C:/Program Files/iWay60/etc/setup/natural.zip

This archive provides the iway.natural.bin binary file, which contains the following programs:

AASNATC and AASSUBC are components of the Adabas/Natural interface used by the iWay Transaction Adapter for CICS. AASNATD is a diagnostic program to be used under the guidance of Customer Support Services.


Top of page

x
Procedure: How to Upload the Adabas/Natural Interface Programs

To upload the Adabas/Natural programs:

  1. Unzip the natural.zip file and extract the iway.natural.bin binary file.
  2. Allocate a dataset on MVS to which the binary file will be uploaded.

    Use lrecl 80, recfm fb, blksize 3120, organization PS. Five TRKs are adequate.

  3. FTP the binary file to the MVS dataset allocated in step 2.

    If you are running the FTP on MVS, use the following FTP subcommands:

    binary
    LOCSITE LRECL=80 BLKSIZE=3120 RECFM=FB
    get iway.natural.bin mvs.allocated.bin (replace

    If you are running the FTP command on another host, use:

    binary
    quote site LRECL=80 BLKSIZE=3120 RECFM=FB
    put iway.natural.bin mvs.allocated.bin (replace
  4. Unpack the uploaded file into a preexisting MVS PDS load library (not PDSE).
    1. Enter the following command from the TSO READY prompt:
      RECEIVE indataset(mvs.allocated.bin)
    2. When prompted for an input, respond with:
      DATASET(mvs.loadlib)
  5. Confirm that the expected members have been added to the target load library.
  6. Add the target load library (PDS) to DFHRPL or copy the programs to an existing DFHRPL library so the programs are made available to the CICS region.

Top of page

x
Procedure: How to Add the CICS Definitions

To add the CICS definitions:

  1. Define the programs AASNATC and AASSUBC to CICS.
  2. Define an alternate mirror transaction with program DFHMIRS and TWA 128.

    A mirror transaction with TWA of 128 is required for the AASNATC program to invoke the Natural Nucleus. You may copy the other parameters from system transaction CPMI.

    A transaction name of IWAY is suggested.


iWay Software