Setting environment variables for the CLI

Before you can use the CLI, you must set environment variables that determine:

Queue managers

Use the environment variables with names of the form DNI_QM_instance to specify the queue manager that is associated with each instance. For example, if instance INST1 uses the queue manager QM1 and instance INST2 uses the queue manager QM2, set the following environment variables:

export DNI_QM_INST1=QM1
export DNI_QM_INST2=QM2

Default instance

To set the default instance, use the environment variable DNI_I. For example, to set the instance to INST1, specify:

export DNI_I=INST1

Default OU

To set the default OU, use the environment variable DNI_OU. For example, to set the OU to BANKA, specify:

export DNI_OU=BANKA

Default service

To set the default service addressed when a command is entered, use the environment variable DNI_S. For example, to set the service to DNI_SECADM, specify:

export DNI_S=DNI_SECADM

Default code page for command-file mode

To set the default code page that the CLI uses for data conversion in a command-file mode, use the environment variable DNI_CPCF. For example, to set the code page to IBM-273, specify:

export DNI_CPCF=IBM-273

Note: Command files delivered with FTM SWIFT usually require code page IBM-1047.

Timeout interval

The default timeout interval (in milliseconds per command) that the CLI waits for a response before it issues an error message is 20000 milliseconds (20 seconds). To set a different timeout interval, use the environment variable DNI_TO. For example, to set the timeout interval to 1 second specify:

export DNI_TO=1000

Date and time formatting

To switch off the date and time formatting, use the environment variable DNI_FMT. For example, to switch off the formatting, specify:

export DNI_FMT=OFF

Language environment

To set your language and region codes, use the DNI_FMT and LANG environment variables. See Languages and regions for a list of all supported codes. For example, to set the language code to English and the region code to United States, specify:

export DNI_FMT=ON
export LANG=en_US

The language environment of a CLI environment is independent of the language environment used by FTM SWIFT. For example, FTM SWIFT might be installed in an environment that uses the German language and region codes (de_DE), but your CLI language environment might be set to en_CA, allowing you to enter and display the date, time, and numbers in Canadian English format.

Switch off the formatting by setting the DNI_FMT environment variable to OFF:

export DNI_FMT=OFF

Then, the setting of the LANG parameter is ignored, and the input/output format for dates is YYYY-MM-DD and the input/output format for times is hh:mm:ss. For example, for date:

2009-12-31

and for times:

23:55:20

Note: All users of FTM SWIFT must ensure that their z/OS® UNIX environments and host emulators use code page IBM-1047. To set this code page in your z/OS UNIX environment, log on to z/OS UNIX and enter:

export LANG=C
export LC_ALL=C

How you set this code page for your emulator depends on the emulator you use.

During the customization procedure described in Preparing a user profile for each runtime system on which a broker runs, the following profile, which sets the CLI environment variables, was generated:

/var/ftmswift_v300/run/dniprofile

To create and use your own, customized copy of this profile:

Copy this profile to your home directory.
Change the values in the copy as needed
Run the profile:
- If you work with the CLI occasionally, run the customized CLI profile each time you begin a CLI session.
- If you work with the CLI often, add a statement to your .profile to call the CLI profile, so that each time you open a session the CLI parameters are loaded.