Server Guide

Specifying a configuration file on IMS

The configuration file, or INI file, is a series of keywords and values that are processed when you start your packaged image. Using an INI file allows you to have generic parameters in your code and specify the actual parameter value inside the INI file, allowing you to change the parameter without repackaging the image. For example, using an INI file would be helpful if one resource is accessed when the application is running in a test environment and another resource is accessed when the application is running in a production environment. Without the INI file, you would have to repackage the image each time you call a different resource.

The data for the INI can be uploaded from a workstation or entered on OS/390. When entering or changing an INI file on OS/390, the left and right square brackets must maintain their hex values of x'AD' and x'BD' respectively.

On OS/390, the default when starting a packaged image is no configuration file. If you want to use configuration options, specify the -INI: command line argument in the CLA option when running the packaged image or building the load module from the Smalltalk image. This argument specifies the location of the INI file to use. If the -INI: command line argument is not present then no INI file is read. The INI file can be placed in two different locations:

Using a configuration file in an HFS directory

To use an INI file that is in an HFS directory when you are running a packaged image, do the following:

  1. Place the INI file into a HFS directory.
  2. Specify the command line argument option -- INI: MM: in the CLA parameter when creating the Smalltalk load module using the JCL procedure ABTIBLD.

    For the CLA parameter, the INI option must be written with back slashes in the place of forward slashes. For example,

    CLA=' =INI:\username\inifile.ini'
    

Using a configuration file in a load module

To use an INI file that is in a load module when you are running a packaged image, do the following:

  1. Place the ini file in a sequential data set, a member of a partition data set, or in a HFS directory.
  2. Copy and Execute the JCL in member ABTXINIJ located in the data set hlq.V4R5M0.SABTJLIB. Modifiy the parameters for ABTINI and OUTFILE where ABTINI specifies the location of the INI file and OUTFILE specifies where the created INI load module is to be stored.
  3. Specify the command line argument option -INI:MM: in the CLA parameter when creating the Smalltalk load module using the JCL procedure ABTIBLD. For example:
    CLA=' =INI:MM:inifile'
    
Note:The data set containing the INI load module must be in the load module search path.

Printing INI information contained in a load module

To find out the contents of the configuration data in a load module, you need to copy and execute the JCL in member ABTXIPRT located in the data set hlq.V4R5M0.SABTJLIB. Modify the parameters for MODNAME and LOADLIB to specify the load module containing the configuration data. The configuration data is written to DD SYSPRINT.


[ Top of Page | Previous Page | Next Page | Table of Contents | Index ]