Chapter 3:  Installation

 

 

This chapter describes

·         How to install the A la Carte Menu and Security System.

·         How to include the appropriate libraries in a job's library list.

·         How to set product default values.

 

Note:

Version 3.0 of ALC can only be installed on a machine that is running V4R2 or later of the operating system.  If your operating system release is less than V4R2, request Release 2.3 of ALC from Bug Busters.

 

 

Automatic Installation Procedure

This procedure will:

·         Install library ALC, containing the latest version of the A la Carte Menu and Security system.

·         Automatically configure the ALC software for your machine.

 

Note:

If you currently have an earlier version of ALC installed on your system:

·         The old library will be renamed and the new version will be installed.

·         Your current menus, settings and options will be preserved.

 

 

To perform the installation:

1.       Sign on as QSECOFR.

2.       Ensure that no other jobs have library ALC in their library list.  You can use the following command to assist you:

      WRKOBJLCK  OBJ(QSYS/ALC)  OBJTYPE(*LIB)

3.       Insert the distribution media into the appropriate drive.

4.       Run the following command at any command line, replacing “device-name” with the actual name of the tape or optical device you are using:

      LODRUN DEV(device-name)

5.       You may now skip to Verifying Installation.

 

Manual Installation Procedure

You should always use the Automatic Installation Procedure whenever possible, especially when installing to a machine that has a previous version of ALC.

Use manual installation if you wish to copy library ALC from one machine to another and you do not have the original distribution media.  Library ALC must have been saved using the SAVLIB command.

  1. Sign on as QSECOFR.
     

  2. If you have an existing version of library ALC currently installed, rename it to ALCOLD.
     

  3. Mount the media on the appropriate device.
     

  4. Restore library ALC using the following command:

      RSTLIB  SAVLIB(ALC)  DEV(device-name)  VOL(*MOUNTED)
     

  5. If you had a previous version of ALC installed, use the CPYALCDTA command to copy your data from the old ALC library to the new library:

      CPYALCDTA  OLDLIB(ALCOLD)  NEWLIB(ALC) CPYALCMNU(*NO)

Verifying Installation

To verify that the ALC product is installed correctly, enter the following commands at any command line:

1.       ADDLIBLE  ALC

2.       GO ALC

If the ALC menu is displayed, installation is complete.

 

Setting Your Library List

Library ALC must be in the library list of jobs using or maintaining ALC menus.  The way you choose to accomplish this may depend on your installation.  Choose one of the following:

·         Specify library ALC for the product library (PRDLIB) parameter on the Create ALC Menu (CRTALCMNU) command each time you create an ALC menu.  Library ALC will be added to the product portion of the job's library list while the menu is displayed.  This is the recommended procedure.

·         Add library ALC to the initial library list parameter of job descriptions controlling jobs that will use ALC.

·         Execute the command ADDLIBLE ALC in individual jobs that will use ALC.

 

Note:

Changing your system values to include library ALC in either the system library list (QSYSLIBL) or the user library list (QUSRLIBL) is not recommend, as this will make it much more difficult to upgrade to a new release of the product.

 

 

Determine the best method for your installation and perform the changes required.

 

Setting Product Defaults

The Change ALC Defaults (CHGALCDFT) command can be used to tailor product default values to suit your installation.

You can access this command by:

The prompted version of the CHGALCDFT command is shown below.

The parameters for the CHGALCDFT command are described below in the order that they appear on the command prompt.

Default Initialization Program

Enter the qualified name of a user-written program to call to initialize newly created menus. This program can define function keys, add standard menu options and perform other common initialization tasks.  The value specified here can be overridden for individual menus.

The program must accept two ten-character parameters: 

  1. Menu name

  2. Menu library name

See source file ALC/EXAMPLES for an example of how to create an initialization program. 

The possible single values are:

*BASIC

A basic initialization program provided by ALC is used. This program adds an *F15 option to the menu which, when selected, allows the user to jump to a new menu by selecting it from a list.
 
*NONE No initialization program is called.

The other possible values are:

program-name

Enter the name of an initialization program to call.

The possible library values are:

*LIBL

The program is found using the job library list.
 

library-name

The name of the library containing the program.

Software Expiration Date

The expiration date for the ALC software is shown in month/day/year format. A value of *PERM is displayed if the software is permanently authorized to your machine. This value cannot be changed.

Software Release Level

The ALC software release level is shown. This value cannot be changed.