Attachmate Verastream Transaction Integrator Guide

 

Set Operation Attributes

There are four operation attributes available to you. Using these attributes, you can determine how specific information is displayed to the client.

What is an operation attribute?

Operation Attributes Description
Username Security attribute

When implemented, the client user is prompted for the value when the runtime service is invoked. The value the user enters is passed to the host program as part of the service. If appropriate credentials are not provided, the runtime service will fail to retrieve data from the host.

Password Security attribute

When implemented, the client user is prompted for the value when the runtime service is invoked. The value the user enters is passed to the host program as part of the service. If appropriate credentials are not provided, the runtime service will fail to retrieve data from the host.

Locale When implemented, the locale attribute identifies a particular combination of language and geographical region to flag an element so that the runtime service can properly handle data representation specific to that language or region. For example, whether, when representing numbers, the displayed format will use commas or periods as separators (100,000,00 or 100.000.00).

There may be more than one object of a given type used in a locale. For example, most locales require a NumberFormat object for currency values as well for as regular numbers. The following code shows how these NumberFormat objects may be obtained:

Locale italian = new Locale("it", "IT");
NumberFormat decimalFormat = NumberFormat.getDefault(italian);

When migrating legacy HPDs, use the locale attribute to convert decimals to commas.

Don't Translate When implemented, the client data is sent to and returned from the host verbatim and is not translated from PC code pages to EBCDIC and back again. When set on an input, the input value supplied by the client for that element is not translated before it is sent to the host. When set on an output, the host response for that element is not translated before it is returned to the client output API.

You can turn off field translation only for a field that is type PIC X(n) in a COBOL copybook. If you choose to disable translation for a specific element, make sure that the value meets the criteria as follows:

PIC X(n) where n = any alphanumeric character allowable from the character set of the computer.
RACF Group (IMS only) Resource Access Control Facility (RACF) is an IBM program that provides access control to the host system.

Use the RACF group attribute to supply unique security-related data to your client operation. If security is active at the host and the client operation is designed to require these values, then you must supply the UserID, Password, and RACF-Group information. If the client operation does not require RACF parameters, then the runtime service will use the values configured in the runtime configuration file.

 

To Set Operation Attributes

  1. In the Client Operation editor, select the element on which to add the operation attribute.

    When you add a client operation, you can choose to have input elements created that use the Username and Password attributes. On the New Client Operation dialog box, choose Add input elements for security attributes Username and Password.

    When you select this option, the client user is prompted for these values when the service is invoked. The values the user enters are passed to the host program as part of the service. If appropriate credentials are not provided, the service will fail to retrieve data from the host.

  2. From the Operations menu, select New Attributes, and then select the attibute you want to add.
  3. The attribute label is added to the Client Operation editor and the runtime service is flagged.
Related Topics
Bullet Create a Client Operation
Bullet Import Legacy Applications
  Attachmate