Setting InteractionSpec properties

Once you have added a Java method or methods, you need to specify the InteractionSpec properties for each EIS transaction.

  1. On the Java™ method Page, in the Java Methods field, select the Java method for which you want to specify the ECI InteractionSpec properties.
  2. In the InteractionSpec class list, select the InteractionSpec class your method will use.
  3. In the InteractionSpec properties for your Java method field, specify the InteractionSpec properties for your method. These properties include:
    1. functionName: Type in the Function Name property to match the name of the CICS® program.
    2. commareaLength: commareaLength refers to the length of the data element,
    3. replyLength: The ReplyLength property sets the length of the data stream to be returned from the Gateway daemon to the J2C application. You can reduce the data transmitted over the network if the data returned by CICS is less than the full COMMAREA size, and you know the size of the data in advance.
    4. TPNName: TPNName refers to the name of the CICS TPN Transaction under which you want all programs started by the resource adapter to run. TPNName takes precedence if both TranName and TPNName are specified. If the TPNName is set on the ECIInteractionSpec, this overrides any values set at deployment time (or on the managedConnectionFactory, if nonmanaged).
    5. tranName: The name of the CICS Transaction under which you want all programs started by the resource adapter to run. The called program runs under a mirror transaction, but is linked to under the tranName transaction name. This name is available to the called program for querying the transaction ID. Some servers use the transaction ID to determine security and performance attributes for the called program. In those servers, you are recommended to use this parameter to control the processing of your called programs. Setting the tranName in the ECIInteractionSpec overrides the value as set at deployment (or on the ManagedConnectionFactoryif nonmanaged).
    6. executeTimeout: To specify a value for ECI timeout, set the ExecuteTimeout property of the ECIInteractionSpec class to the ECI Timeout value. Allowable values are:
      • 0 (No timeout) This is the default value.
      • Positive integer (Time in milliseconds.)
      Note: If you are using a CICS Transaction Gateway on z/OS®, you cannot specify a value for ECI timeout. As an alternative, you can set the TIMEOUT parameter in the EXCI options table DFHXCOPT
    7. interactionVerb: The interactionVerb sets the type of interaction your transaction will perform. Allowable values are:
      • SYNC_SEND for an asynchronous call,
      • SYNC_RECEIVE to retrieve a reply from an asynchronous call.
      • SYNC_SEND_RECEIVE for a synchronous call.
Now that you have saved the data bean properties, you can click Finish to exit the wizard, or click Next to create a Web page, EJB, or Web Service to deploy your J2C Java bean.
Terms of use | Feedback
(C) Copyright IBM Corporation 2000, 2005. All Rights Reserved.