Chapter 6: Menu Commands

This chapter describes the CL commands used to:

· Create ALC menus.

· Authorize users to access menus.

· Change, copy, move, rename and delete ALC menus.

See chapter 7, Menu Option Commands, for information about creating, changing and deleting menu options.

Creating Menus

The Create ALC Menu (CRTALCMNU) command is used to create a new menu.

You can access this command by either of the following methods:

· Select option 2 from the ALC menu.

· Prompt the CRTALCMNU command at any command line.

When you create an ALC menu, an object of type *MENU is created in the library you specify. The menu options and the menu system run time routines are stored in library ALC.

In order to display a menu, library ALC and the library containing the *MENU object must be in your library list.

Note:

You cannot use the OS/400 CRTMNU command to create ALC menus. Only menus created with the CRTALCMNU command will function as ALC menus.

Once you have created a menu, you add, change and delete menu options by:

1. Using the GO command to display the menu.

2. Maintaining the menu with function keys.

The prompted version of the CRTALCMNU command is shown below.

                       Create ALC Menu (CRTALCMNU)

Type choices, press Enter.

Menu . . . . . . . . . . . . . .              Name
Library . . . . . . . . . . .   *CURLIB   Name, *CURLIB
Current library . . . . . . . . *NOCHG       Name, *NOCHG, *MNULIB...
Product library . . . . . . . . *NOCHG       Name, *NOCHG, *NONE
Number of columns . . . . . . . 1           1-3
Text 'description' . . . . . . .

Authority . . . . . . . . . . . *USE         *LIBCRTAUT, *CHANGE, *ALL...

                        Additional Parameters

Allow command entry . . . . . . *YES         *YES, *NO
Log option usage . . . . . . . . *YES         *YES, *NO
Ignore *ALLOBJ authority . . . . *NO          *YES, *NO
Help pannel group . . . . . . . *NONE        Name, *NONE
Library . . . . . . . . . . .              Name, *LIBL, *CURLIB
Help id . . . . . . . . . . . . *NONE        Name, *MENU, *NONE
Initialization program . . . . . *DFT         Name, *DFT, *BASIC, *NONE
Library . . . . . . . . . . .             Name, *LIBL
Position standard F-key text . . *FIRST       *FIRST, *LAST
Heading line 1 . . . . . . . . . *TEXT

Heading line 2 . . . . . . . . . ' '

Heading 1 data area . . . . . . *NONE        Name, *NONE
Library . . . . . . . . . . .              Name, *LIBL, *CURLIB
Heading 2 data area . . . . . . *NONE        Name, *NONE
Library . . . . . . . . . . .              Name, *LIBL, *CURLIB

Create ALC Menu command.

The parameters for the CRTALCMNU command are described below in the order that they appear on the command prompt. Default values are underlined.

Current library

The name of the library to use as the current library when the menu is displayed.

The possible values are:

*NOCHG	The current library does not change when the menu is displayed.
*MNULIB	The library containing the menu becomes the current library when the menu is displayed. After exiting the menu, the current library is restored to the value it had before the menu was displayed.
*CRTDFT	No current library is set while the menu is being displayed. After exiting the menu, the current library is restored to the value it had before the menu was displayed.
library-name	Enter the name of the library to use as the current library.

Product Library

The name of the library to use as the product library when the menu is displayed. The product library appears at the top of the user portion of the library list.

The possible values are:

*NOCHG	The product library does not change when the menu is displayed.
*NONE	No value is used for product library while the menu is displayed.
library-name	Enter the name of the library to use as the product library when the menu is displayed. After exiting the menu, the product library is restored to the value it had before the menu was displayed.

Columns

Enter the number of columns to use to display the menu.

The possible values are:

1	The default is 1 column.
number	Enter a number from 1 to 3. When more than one column is used, text for menu options may be truncated.

Text 'description'

Text that describes the menu. The text will be used as the menu title when the menu is displayed.

The possible values are:

description

Enter up to 50 characters of descriptive text. The text is used as the title for the menu.

Authority

Specify *PUBLIC authority for the menu. *PUBLIC authority applies to users who are not explicitly authorized to the menu.

The possible values are:

*USE	Users are allowed to display and use the menu.
*LIBRCRTAUT	The value specified for the Create Authority parameter (CRTAUT) for the library in which the menu is being created is used for *PUBLIC authority.
*CHANGE	Users are allowed to display the menu as well as add, change and delete menu options.
*ALL	Users are allowed to display the menu; add, change and delete menu options; and delete the menu itself.
*EXCLUDE	Users are not allowed to access the menu.

Allow Command Entry

Indicate whether users should be allowed to enter commands from this menu or whether to restrict users to numeric menu options only.

The possible values are:

*YES	Command entry is allowed. Users with LMTCPB(*YES) specified in their user profile are still prevented from entering commands.
*NO	Users cannot enter commands from this menu. Only valid menu options may be selected.

Log Option Usage

Indicate whether to log access to the options on this menu.

The possible values are:

*NO	No log entries are generated for this menu.
*YES	A log entry is generated each time a user selects an option from this menu. The entries can be viewed or printed with the Display ALC Log (DSPALCLOG) command.

Ignore *ALLOBJ Authority

Indicate whether to ignore *ALLOBJ special authority when checking to see if a user is authorized to menu options on this menu.

If your system security level—as determined by the QSECURITY system value—is less than 30, the system grants *ALLOBJ special authority to all users. A user with *ALLOBJ special authority can access all objects on the system. Since ALC menu options are system objects, a user with *ALLOBJ special authority would normally be able to access all menu options, regardless of the authority specified for the option.

This parameter allows systems running at security levels 10 and 20 to restrict access to ALC menu options. Authority to access each option is checked as if the user did not have *ALLOBJ authority.

The possible values are:

*NO

Users with *ALLOBJ special authority can access all options on this menu.

*YES

*ALLOBJ authority is ignored when determining authority to access options on this menu, unless the user is QSECOFR.

Authority checking for users without *ALLOBJ authority occurs normally. Users with *ALLOBJ authority can only access an option on this menu if one or more of the following is true:

· *PUBLIC authority is sufficient.

· The user is explicitly authorized to the menu option.

· The user's group profile is explicitly authorized to the menu option.

Note:

1. When *YES is specified for this parameter, it may take slightly longer for a user with *ALLOBJ special authority to display the menu.

2. When *YES is specified for this parameter, authorization lists and secondary group profiles are not checked when determining whether a user with *ALLOBJ special authority can access options on this menu.

Help Panel Group

The qualified name of the panel group to use as help text for the menu.

Panel groups are created from source with the Create Panel Group (CRTPNLGRP) command. See source file ALC/EXAMPLES for an example of how to create panel group help for a menu.

The possible single values are:

*NONE

No help is associated with the menu. If you specify *NONE for this parameter, you must also specify *NONE for the Help id (HLPID).

The possible panel group values are:

name	The name of the *PNLGRP object that contains help text for the menu.

The possible library values are:

*LIBL	The panel group help is found using the job library list.
*CURLIB	The panel group help is found in the current library.
library-name	The name of the library containing the panel group help for the menu.

Help ID

Specify an ID to use to identify the help specifications for this menu within the panel group.

The ID specified is used as the first part of the "help name" to identify help modules for this menu within the panel group. For overview help, the help name is the same as the ID specified. For menu option help, the help name is comprised of the ID specified, followed by a slash (/) and the menu option number.

For example, if "ABC" is specified for Help ID, the following statement in the panel group source defines overview help for the menu:

:help name='ABC'.

The following statement in the panel group source defines help for menu option 1:

:help name='ABC/1'.

See source file ALC/EXAMPLES for an example of how to create panel group help for a menu.

The possible values are:

*NONE	No help id is specified. NONE is only valid for this parameter if NONE was also specified for the Help Panel Group (HLPPNLGRP) parameter.
*MENU	The menu name is used as the id to identify the help panels for this menu within the panel group.
help-ID	Specify the ID used to identify the help panels for this menu within the panel group.

Initialization Program

Enter the qualified name of a user-written program to call to complete the initial menu setup. This program can define function keys, add standard menu options and perform other common initialization tasks.

The program must accept two ten-character parameters:

Menu name
Menu library name

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

The single values are:

*DFT	The default initialization program is used. This default can be viewed or changed with the Change ALC Defaults (CHGALCDFT) command.
*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:

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 initialization program.

Position of Standard F-Key Text

Indicate whether standard function key text (F3=Exit, F4=Prompt, etc.) should be shown before or after text for any user-defined function keys at the bottom of the menu.

The possible values are:

*FIRST	The standard function key text is shown first. The user must press F24 to display text for any user-defined function keys.
*LAST	Text for any user-defined function keys is shown first. The user must press F24 to see the standard function key text. If there are no user-defined function keys for this menu, the standard function key text is shown first.

Heading Line 1

Specify a heading to display on line 1 of the menu. The heading will be centered automatically by ALC.

The possible values are:

*TEXT

The menu text is displayed as the heading.

*DTAARA

The heading text is retrieved from a data area at run time. Using this option, you can tie the text for several different menus to a single data area and maintain the text in a single place.

You can also use this option to let the job library list determine which text is displayed at run time.

If *DTAARA is specified for this parameter, you must specify a value other than *NONE for the "Heading 1 Data Area" (DTAARA1) parameter.

heading-text

Specify up to 50 characters of text.

Heading Line 2

Specify a heading to display on line 2 of the menu. The heading will be centered automatically by ALC.

The possible values are:

blank	No text is displayed on line 2.
*TEXT	The menu text is displayed as the heading.
*DTAARA	The heading text is retrieved from a data area at run time. Using this option, you can tie the text for several different menus to a single data area and maintain the text in a single place. You can also use this option to let the job library list determine which text is displayed at run time. If DTAARA is specified for this parameter, you must specify a value other than NONE for the "Heading 2 Data Area" (DTAARA2) parameter.
heading-text	Specify up to 50 characters of text.

Heading 1 Data Area

Enter the qualified name of a data area from which to retrieve the menu heading at run time. The data area must be of type *CHAR and at least 50 bytes long.

If *DTAARA is specified for the "Heading Line 1" (HEADING1) parameter, the first 50 bytes of the data area are used for heading text.

The possible values are:

*NONE	No data area is specified.
name	Enter a valid data area name.

The possible library values are:

*LIBL	The data area is found using the job library list.
*CURLIB	The data area in the job's current library is used.
library-name	Enter the name of the library containing the data area.

Heading 2 Data Area

Enter the qualified name of a data area from which to retrieve the menu heading at run time. The data area must be of type *CHAR and at least 50 bytes long.

If *DTAARA is specified for the "Heading Line 2" (HEADING2) parameter, the first 50 bytes of the data area are used for heading text.

The possible values are:

*NONE	No data area is specified.
name	Enter a valid data area name.

The possible library values are:

*LIBL	The data area is found using the job library list.
*CURLIB	The data area in the job's current library is used.
library-name	Enter the name of the library containing the data area.

Related Commands:

The following menu commands are discussed elsewhere in this chapter:

Delete ALC Menu (DLTALCMNU)

Copy ALC Menu (CPYALCMNU)

Save ALC Menu (SAVALCMNU)

Restore ALC Menu (RSTALCMNU)

For more information about the following commands, prompt the command and press F1 to view the on-line help text:

Change ALC Menu (CHGALCMNU)

Edit Object Authority (EDTOBJAUT). Used to authorize users to access a menu.

Rename Object (RNMOBJ). Used to rename a menu.

Move Object (MOVOBJ). Used to move a menu from one library to another.

Changing Menu Attributes

The Change ALC Menu (CHGALCMNU) command is used to change an existing menu.

You can access this command by any of the following methods:

· While viewing a menu, key F23 and then select option 22.

· Select option 3 from the ALC menu.

· Prompt the CHGALCMNU command at any command line.

Note:

1. You must have *CHANGE authority to a menu to change its attributes.

2. Do not use the OS/400 CHGMNU command to change ALC menus. The CHGMNU command allows you to change some attributes that could cause the menu to function incorrectly.

The parameters for the CHGALCMNU command are much the same as those for the CRTALCMNU command.

Related Commands:

The following menu commands are discussed elsewhere in this chapter:

Create ALC Menu (CRTALCMNU)

Delete ALC Menu (DLTALCMNU)

Copy ALC Menu (CPYALCMNU)

Save ALC Menu (SAVALCMNU)

Restore ALC Menu (RSTALCMNU)

For more information about the following commands, prompt the command and press F1 to view the on-line help text:

Change ALC Menu (CHGALCMNU)

Edit Object Authority (EDTOBJAUT). Used to authorize users to access a menu.

Rename Object (RNMOBJ). Used to rename a menu.

Move Object (MOVOBJ). Used to move a menu from one library to another.

Convert Menu to ALC (CVTMNUALC). Used to convert a non-ALC menu to ALC.

Copying Menus

is used to make a complete copy of an ALC menu. All menu attributes, options and authorities are copied.

You can access this command by either of the following methods:

· Select option 4 from the ALC menu.

· Prompt the CPYALCMNU command at any command line.

Note:

Do not use the OS/400 CRTDUPOBJ command to copy an ALC menu. When copied in this way, the new menu will share all attributes and options with the original menu, but any changes made to either of the menus will immediately effect the other as well. Using the CRTDUPOBJ command creates two identical menus that will always have exactly the same attributes and menu options.

The prompted version of the CPYALCMNU command is shown below.

The parameters for the CPYALCMNU command are described below in the order that they appear on the command prompt. Default values are underlined.

From Menu

The qualified name of the menu to be copied. This is a required parameter.

The possible values are:

menu-name

The name of the menu to be copied.

The possible library values are:

*LIBL	The menu is found using the job library list.
*CURLIB	The menu is found in your current library.
library-name	Enter the name of the library containing the menu.

To Menu

The qualified name of the new menu.

The possible values are:

*FROMMENU	The source and target menus are have the same name.
menu-name	The name of the new menu.

The possible library values are:

*FROMLIB	The new menu is copied to the same library as the original menu.
*CURLIB	The menu is created in your current library.
library-name	Enter the name of the library to contain the new menu.

Related Commands:

The following menu commands are discussed elsewhere in this chapter:

Create ALC Menu (CRTALCMNU)

Delete ALC Menu (DLTALCMNU)

Save ALC Menu (SAVALCMNU)

Restore ALC Menu (RSTALCMNU)

For more information about the following commands, prompt the command and press F1 to view the on-line help text:

Change ALC Menu (CHGALCMNU)

Edit Object Authority (EDTOBJAUT). Used to authorize users to access a menu.

Rename Object (RNMOBJ). Used to rename a menu.

Move Object (MOVOBJ). Used to move a menu from one library to another.

Authorizing Users To Access Menus

is used to control which users are authorized to access a menu.

You can access this command by any of the following methods:

· While viewing a menu, key F23 to access the maintenance window; then select option 26.

· Select option 5 from the ALC menu.

· Prompt the EDTOBJAUT command at any command line.

The EDTOBJAUT command is a system command. It is due to the fact that ALC menus are OS/400 objects that you can use the EDTOBJAUT command to edit their authority.

The prompted version of the EDTOBJAUT command is shown below.

Specify the menu name and library for the Object parameter, and *MENU for the Object type parameter.

After you fill in the parameters and press Enter, the Edit Object Authority screen is displayed. From this screen you can authorize new users to the menu and change the authority for users already authorized to the menu.

A typical Edit Object Authority screen is shown below.

See the on-line help text for more information about using the Edit Object Authority command and display.

Remember:

· *USE authority is required to use a menu.

· *CHANGE authority is required to change a menu’s attributes, and to add, change or delete menu options.

· *ALL authority is required to edit authority for the menu and to delete the menu.

Related Commands:

The following menu commands are discussed elsewhere in this chapter:

Create ALC Menu (CRTALCMNU)

Copy ALC Menu (CPYALCMNU)

Delete ALC Menu (DLTALCMNU)

Save ALC Menu (SAVALCMNU)

Restore ALC Menu (RSTALCMNU)

For more information about the following commands, prompt the command and press F1 to view the on-line help text:

Change ALC Menu (CHGALCMNU)

Rename Object (RNMOBJ). Used to rename a menu.

Move Object (MOVOBJ). Used to move a menu from one library to another.

Deleting Menus

is used to delete an ALC menu.

You can access this command by either of the following methods:

· Select option 6 from the ALC menu.

· Prompt the DLTALCMNU command at any command line.

Note :

Do not use the OS/400 DLTMNU command to delete ALC menus. This will delete the *MENU object only and will not delete the associated menu options nor update internal ALC control information.

The prompted version of the DLTALCMNU command is shown below.

The parameters for the DLTALCMNU command are described below in the order that they appear on the command prompt. Default values are underlined.

Renaming Menus

The Rename Object (RNMOBJ) command is used to rename a menu.

You can access this command by either of the following methods:

· Select option 7 from the ALC menu.

· Prompt the RNMOBJ command at any command line.

The RNMOBJ command is a system command. It is due to the fact that ALC menus are OS/400 objects that you can use the RNMOBJ command to rename them.

The prompted version of the RNMOBJ command is shown below.

Specify the menu name and library for the Object parameter, and *MENU for the Object type parameter.

See the on-line help text for more information about the Rename Object command.

Related Commands:

The following menu commands are discussed elsewhere in this chapter:

Create ALC Menu (CRTALCMNU)

Copy ALC Menu (CPYALCMNU)

Delete ALC Menu (DLTALCMNU)

Save ALC Menu (SAVALCMNU)

Restore ALC Menu (RSTALCMNU)

For more information about the following commands, prompt the command and press F1 to view the on-line help text:

Change ALC Menu (CHGALCMNU)

Edit Object Authority (EDTOBJAUT). Used to authorize users to access a menu.

Move Object (MOVOBJ). Used to move a menu from one library to another.

Moving Menus

The Move Object (MOVOBJ) command is used to move a menu to a different library.

You can access this command by either of the following methods:

· Select option 8 from the ALC menu.

· Prompt the MOVOBJ command at any command line.

The MOVOBJ command is a system command. It is due to the fact that ALC menus are OS/400 objects that you can use the MOVOBJ command to move them.

The prompted version of the MOVOBJ command is shown below.

Specify the menu name and library for the Object parameter, and *MENU for the Object type parameter.

See the on-line help text for more information about the Move Object command.

Related Commands:

The following menu commands are discussed elsewhere in this chapter:

Create ALC Menu (CRTALCMNU)

Copy ALC Menu (CPYALCMNU)

Delete ALC Menu (DLTALCMNU)

Save ALC Menu (SAVALCMNU)

Restore ALC Menu (RSTALCMNU)

For more information about the following commands, prompt the command and press F1 to view the on-line help text:

Change ALC Menu (CHGALCMNU)

Edit Object Authority (EDTOBJAUT). Used to authorize users to access a menu.

Rename Object (RNMOBJ). Used to rename a menu.

Saving Menus

If you save library ALC and all of the user libraries containing ALC menus as a part of your normal back procedure, you do not need to take any extra steps to backup ALC menus.

Two commands are provided, however, to let you save and restore individual ALC menus. Use the Save ALC Menu (SAVALCMNU) and Restore ALC Menu (RSTALCMNU) commands to:

· Save an ALC menu from one system and restore it to another system.

· Save a backup copy of a menu to a tape or save file before making changes to the menu.

· Save an ALC menu from one library and restore a copy of the menu to another library.

· Save an ALC menu which contains menu options that adopt the authority of another user profile. See

When you save and restore ALC menus using these commands, all menu attributes, options and authorities are preserved.

You can access the SAVALCMNU command by either of the following methods:

· Select option 9 from the ALC menu.

· Prompt the SAVALCMNU command at any command line.

The prompted version of the SAVALCMNU command is shown below.

The parameters for the SAVALCMNU command are described below in the order that they appear on the command prompt. Default values are underlined.

Device

Enter the name of the device to use to save the menu. This is a required parameter.

The possible values are:

*SAVF	The menu is saved to a save file. When you specify *SAVF for this parameter, you must also specify a save file name for the Save file parameter.
device-name	Enter the name of a tape device to use to save the menu.

Volume Identifier

Enter the volume identifier to use when saving the menu to tape.

The possible values are:

volume-id

Specify a volume identifier to check.

Sequence Number

Enter the sequence number to use when saving the menu to tape.

The possible values are:

*END	The menu is saved after the last sequence number currently on the tape.
1-9999	Specify the sequence number to use when saving to tape.

Label

Enter the name to use to identify the data file on the tape.

The possible values are:

*LIB	The name of the library from which the menu is saved is used as the file label.
data-file-identifier	Specify up to 17 characters to identify the data on the media.

File Expiration Date

Specify the expiration date to use when saving the menu to tape. The data on the media cannot be overwritten until after the specified date.

The possible values are:

*PERM	The data on the save media is protected permanently.
expiration-date	Specify the date when protection for the data on the media ends.

End of Tape Option

Specify the action to take after saving the menu to tape.

The possible values are:

*REWIND	The tape is rewound.
*LEAVE	The tape is not rewound at the completion of the save operation.
*UNLOAD	The tape is unloaded.

Save File

Specify the qualified name of the save file to use when *SAVF is specified for Device. The save file must exist at the time of the save operation.

The possible values are:

name	Enter the name of an existing save file.

The possible library values are:

*LIBL	The save file is found using the job library list.
*CURLIB	The save file is found in the current library.
library-name	Enter the name of the library containing the save file.

Target Release

Specify the earliest release of the operating system on which you intend to restore and use the menu.

The possible values are:

*CURRENT	The current release of your operating system is used.
*PRV	The release of the operating system previous to yours is used.
VxRyMz	Enter a specification in the form VxRyMz, where x is the version, y is the release and z is the modification level.

Clear

Specify whether to clear data on the save media before the save operation.

The possible values are:

*NONE	Existing data in the save file or on the save media is not cleared before the save operation.
*ALL	The first and all successive volumes of the save media are cleared.
*AFTER	Only save volumes after the first volume are cleared.

Data Compression

Specify whether to compress the data during the save operation.

The possible values are:

*DEV	Compress is done by the save device if it is capable of compression.
*NO	The data is not compressed.
*YES	The data is compressed by the system curing the save operation.

Related Commands:

The following menu commands are discussed elsewhere in this chapter:

Create ALC Menu (CRTALCMNU)

Copy ALC Menu (CPYALCMNU)

Delete ALC Menu (DLTALCMNU)

Restore ALC Menu (RSTALCMNU)

For more information about the following commands, prompt the command and press F1 to view the on-line help text:

Change ALC Menu (CHGALCMNU)

Edit Object Authority (EDTOBJAUT). Used to authorize users to access a menu.

Rename Object (RNMOBJ). Used to rename a menu.

Move Object (MOVOBJ). Used to move a menu from one library to another.

Restoring Menus

The Restore ALC Menu (RSTALCMNU) command is used to restore a menu that was previously saved using the Save ALC menu (SAVALCMNU) command.

You can access this command by either of the following methods:

· Select option 10 from the ALC menu.

· Prompt the RSTALCMNU command at any command line.

The prompted version of the RSTALCMNU command is shown below.

The parameters for the RSTALCMNU command are described below in the order that they appear on the command prompt. Default values are underlined.

Saved Library

Enter the name of the library from which the menu was originally saved. This is a required parameter.

The possible values are:

library-name

Enter the name of the save library.

Device

Enter the name of the device to use to restore the menu. This is a required parameter.

The possible values are:

*SAVF	The menu is restored from a save file. When you specify *SAVF for this parameter, you must also specify a save file name for the Save file (SAVF) parameter.
device-name	Enter the name of a tape device to use to restore the menu.

Volume Identifier

Enter the volume identifier to use when restoring the menu from tape or diskette.

The possible values are:

*MOUNTED	The volume that is mounted on the device is used.
volume-id	Specify a volume identifier to check.

Sequence Number

Enter the sequence number to use when restoring the menu from tape.

The possible values are:

*SEARCH	The tape is searched for the sequence number that contains the menu being restored.
1-9999	Specify the sequence number to use when restoring from tape.

Label

Enter the name to use to identify the data file on the tape or diskette.

The possible values are:

*LIB	The name of the library from which the menu was saved is used as the file label.
data-file-identifier	Specify up to 17 characters to identify the data on the media.

End of Tape Option

Specify the action to take after restoring the menu from tape.

The possible values are:

*REWIND	The tape is rewound.
*LEAVE	The tape is not rewound at the completion of the restore operation.
*UNLOAD	The tape is unloaded.

Save File

Specify the qualified name of the save file to use when *SAVF is specified for Device.

The possible values are:

name	Enter the name of the save file containing the saved menu.

The possible library values are:

*LIBL	The save file is found using the job library list.
*CURLIB	The save file is found in the current library.
library-name	Enter the name of the library containing the save file.

Optical File Name

When restoring from CD, specify the name of the file on the CD that contains the save image.

The possible values are:

*SAVLIB	The optical file name is the same as the name of the library from which the menu was saved.
file-name	Specify the name of the CD file from which to restore the menu.

Allow Object Differences

Specify whether differences of ownership or authorization encountered during the restore operation are allowed.

The possible values are:

*NONE	If the menu already exists in the library to which it is being restored, the ownership and authorization attributes of the existing menu and the menu to be restored must match.
*ALL	The menu being restored replaces an existing menu, regardless of possible differences in ownership or authorization attributes. You must have ALLOBJ special authority to specify ALL for this parameter.

Restore To Library

Enter the name of the library to which the menu should be restored. The library must already exist.

The possible values are:

*SAVLIB	The menu is restored to the same library from which it was saved.
library-name	Enter the name of the target library for the restore.

Authority to Restore

Specify how to set authority when restoring on top of an existing menu.

The possible values are:

*NEW	Existing authority is replaced. Authority for the restored menu and menu options matches the authority they had at the time they were saved. When restoring on top of an existing menu, the authority from the save image replaces the authority that the existing menu and menu options had.
*OLD	Existing authority is preserved. When restoring on top of an existing menu, the restored menu and menu options will have the same authority they had before the restore operation. Menu options that did not previously exist are restored with the authority they had at the time they were saved.

Related Commands:

The following menu commands are discussed elsewhere in this chapter:

Create ALC Menu (CRTALCMNU)

Copy ALC Menu (CPYALCMNU)

Delete ALC Menu (DLTALCMNU)

Save ALC Menu (SAVALCMNU)

For more information about the following commands, prompt the command and press F1 to view the on-line help text:

Change ALC Menu (CHGALCMNU)

Edit Object Authority (EDTOBJAUT). Used to authorize users to access a menu.

Rename Object (RNMOBJ). Used to rename a menu.

Move Object (MOVOBJ). Used to move a menu from one library to another.

Rebuilding Menus

The Rebuild Menu (RBDALCMNU) command is used to Use this command to rebuild a menu after restoring your entire system from backup. System pointers stored with ALC menus are no longer valid if the menus or menu options are restored using the regular OS/400 RSTOBJ or RSTLIB commands.

When this command is run for an ALC menu, all menu options and internal pointers are reset so that the menu will work properly.

To avoid needing to rebuild menus, you should use the Save ALC Menu (SAVALCMNU) and Restore ALC Menu (RSTALCMNU) commands to save and restore menus whenever possible.

You can access the Rebuild Menu command by either of the following methods:

· Select option 38 from the ALC menu.

· Prompt the RBDALCMNU command at any command line.

The prompted version of the RBDALCMNU command is shown below.

The parameters for the RBDALCMNU command are described below in the order that they appear on the command prompt. Default values are underlined.

*USRLIBL	Menus in any library in the user portion of the library list are included.
*LIBL	Menus in any library in the job library list are included.
*CURLIB	Menus in the current library are included.
*ALLUSR	Menus in all user libraries are included.
*ALL	Menus in all libraries are included.
library-name	The name of the library containing the menu or menus to be rebuilt.

Related Commands:

The following menu commands are discussed elsewhere in this chapter:

Save ALC Menu (SAVALCMNU)

Restore ALC Menu (RSTALCMNU)

*ALL	All menus in the specified libraries are included.
generic-name	Enter a menu name, or a generic name ending in an asterisk (*).