ICQAMRMI Parameters (Foreground and Batch)

The invocation parameters to ICQAMRMI are described below. A value that is underlined represents the default value of the keyword.

MODE(INST | EXP)

specifies the mode of operation. The functions of the allowable values, INST and EXP, are:

INST: performs mass processing of installation files with or without upgrade files.
EXP: performs the mass export process.

The default value is INST. If you specify MODE with no value, or if you specify a value that is not allowed, processing terminates.

BACKUP(Y | N)

specifies whether backup copies are to be made of applications that are replaced. The functions of the allowable values, Y and N, are:

Y: The tables that are to be modified are exported to the backup installation file, ICQBACK, before they are updated.
N: Backup installation files of the tables to be updated are not created.

If you specify BACKUP with no value or if you specify a value that is not allowed, processing terminates.

Specifying BACKUP(Y) causes additional overhead in processing because an additional export is performed for each application that is replaced. However, specifying BACKUP(Y) allows you to restore the original application, if necessary.

The following parameters identify the application definition that contains the control information for the Application Manager function. The mass installation file process must extract this information. If the following three parameters do not uniquely define the Application Manager application, processing may be unsuccessful.

AMNAME(application_manager_appl_name | ICQAPPLMGR)

specifies the name of the Application Manager application. AMNAME and AMLANG keywords are used to uniquely specify the application in the library defined by the STMALIB keyword. In addition, the library allocated to STMALIB contains the look-up table.

The default name is based on the name of the application at the time of the product's installation, ICQAPPLMGR. If you specify the name of a non-existent application, processing terminates.

AMLANG(application_manager_appl_language | ENGLISH)

specifies the language of the Application Manager application.

If you specify a value that does not represent a valid application language, the Application Manager application is not allocated and processing terminates.

The default language is English.

STMALIB(application_administrator_library_name | ICQAMTAB)

specifies the ddname of the system administrator library. STMALIB applies only to foreground invocation. This library is used to access the information in the look-up table and in the Application Manager application. The library must be allocated before it can be used.

If you are running interactive (foreground) and you want to process table data sets other than the defaults, you should allocate another file and override STMALIB.

The default ddname is ICQAMTAB.