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:
To use an INI file that is in an HFS directory when you are running a
packaged image, do the following:
For the CLA parameter, the INI option must be written with back slashes in
the place of forward slashes. For example,
To use an INI file that is in a load module when you are running a packaged
image, do the following:
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.Specifying a configuration file on IMS
Using a configuration file in an HFS directory
CLA=' =INI:\username\inifile.ini'
Using a configuration file in a load module
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