Migrating application manager tables from previous releases of the information center facility

This section contains the steps to convert the Application Manager tables from previous releases of the Information Center Facility.

Ensure that you are in an active ISPF session (for example, use the TSO/E option under ISPF) to make the Information Center Facility inactive.
Activate the ISPF log data set, so that messages are logged into it. For example, select option 0.2 on the ISPF/PDF main panel to use or change the log data set default options.
Select ISPF option 6 (COMMAND) on the ISPF/PDF main panel.
Allocate the following file names from the previous release:
- ICQAMTAB data set for the administrator Application Manager tables that are to be converted.
- ICQCMTAB data set for the user Application Manager tables that are to be converted.
Execute the following command to convert your existing Application Manager tables. You must specify the panel and message libraries. For example, exec is the command that is executing the conversion CLIST (ICQAMCR1) and panels and messages are the parameters passed to ICQAMCR1.
```
exec 'icq.tsoe25.icqcclib(icqamcr1)' 'panels(icq.tsoe24.icqplib) 
messages(icq.tsoe24.icqnew.mlib)'
```
Note: The data set names mentioned in the preceding example should be changed to those of the actual CLIST, panel, and message libraries that were used to install TSO/E. Specify the data set names fully qualified and without quotes.

The TSO/E panel and message libraries are required because ICQAMCR1 needs the constant values in the non-display panel, ICQSIEAM, and in the new messages. The conversion procedure may be performed before or after customizing the values in ICQSIEAM. Customizing the values in ICQSIEAM is described in Preparing the Information Center Facility for use.

Messages on your screen report the progress of the conversion, first a "Beginning conversion" indicator, then table-by-table status messages, indications of applications being converted, and finally an "Ending conversion" indicator. These messages are also written to the ISPF log data set.
The conversion routine creates the following data sets, which contain the newly converted tables.
- (prefix).ICQAMCNV - for the new system administrator library
- (prefix).ICQCMCNV - for the new system user library
If you set the prefix using the TSO PROFILE(PREFIX) command, the prefix is syspref. If you do not set the prefix, the system defaults it to SYSUID.
Free the old allocations to ICQAMTAB and ICQCMTAB.
Either rename the data sets (containing the newly converted tables) using the names specified in the logon procedure for ICQAMTAB and ICQCMTAB, or change the logon procedure to include the correct data set names.
Use the converted tables either to allocate the new data sets to the file names ICQAMTAB and ICQCMTAB, or to re-logon with the updated logon procedure described in the previous step.
After the tables have been converted, start the Information Center Facility as an Application Manager administrator.

To complete the installation process of TSO/E, install the applications using the member names shown in Table 1. Several of the applications are replacements for older applications. Therefore, compare the new installation files with your current application definitions to determine any customization that may have to be re-done.

The applications are provided in ICQ.ICQILIB. When installing the applications from ICQ.ICQILIB, set the Available field on the main application definition panels (ICQAME20, ICQAME30, and ICQAME35) to Y. It is important that this field is correctly set for ICQAPPLMGR.

The first seven applications shown in Table 1 contain Application Manager functions and must be installed first. Then install the last four. ICQAPPC must be installed last.

Table names shown are the names that are distributed with TSO/E 2.3.0 and later. If you have used Application Manager to convert the Information Center Facility prior to TSO/E 2.3.0, the created names may be different from those listed in Table 1.

Table 1. Information center facility applications for TSO/E
Application name	Application description	Member name	Table name
ICQPVTAMGR	TSO/E Private Application Manager	ICQFF004	ICQMFAA6
ICQGRPAMGR	TSO/E Group Application Manager	ICQFF000	ICQMFABD
ICQGRPSPEC	TSO/E Group Specification	ICQFF001	ICQMFABE
ICQGCPRT	End-User Interface to Print Services	ICQFF002	ICQMFABF
ICQISPFDEF	Set ISPF System Defaults	ICQFF003	ICQMFAAQ
ICQAPPLMGR	TSO/E Application Manager	ICQFF005	ICQMFAAE
ICQENROLL	TSO/E User Enrollment	ICQFF006	ICQMFAAJ
ICQPROGRAM	TSO/E Programmer Services	ICQFP000	ICQMPAA#
ICQUTILITY	Information Center Facility Utilities	ICQFP002	ICQMPABG
ICQUSER	TSO/E User Services	ICQFP001	ICQMPAA9
ICQAPPC	APPC/MVS Administration Dialog	ICQFF007	ICQMFABH