CRTMSGFMNU (Create Message File Menu)

CRTMSGFMNU Command syntax diagram

 

Purpose

The Create Message File Menu (CRTMSGFMNU) command creates a menu (display file) from the specified message files. The user can specify that this menu be created either in a fixed-format, with options 1 through 24 arranged in two columns, or in free-format.

To create a menu from the source member, use the Create System/36 Menu (CRTS36MNU) command.

Restriction: The CRTMSGFMNU command can be run either in the System/36 environment or, when library QSSP is installed, on the iSeries 400.

 

Required Parameters

CMDTXTMSGF
Specifies the qualified name of the command text message file that contains the text for the command that runs when the corresponding option is selected. The CMDTXTMSGF parameter must identify an existing message file and not a Screen File Generator (SFGR), or a System/36 message source member. Trailing ## symbols are required on the CMDTXTMSGF name. The menu (display file) name is the message-file-name without the ## symbols. The run-time menu processor appends the trailing ## symbols to the menu name to determine the message file name. This is the name of the message file that contains messages whose text is the command that is run for any option selected.

The name of the command text message file can be qualified by one of the following library values:

*CURLIB: The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.

library-name: Specify the name of the library to be searched.

Note: The CMDTXTMSGF library is where the menu display file is created. This is a requirement of the run-time menu processor.

message-file-name-##: Specify the name of the message file used to create the menu. Trailing ## symbols are required.

 

Optional Parameters

OPTTXTMSGF
Specifies the qualified name of the option text message file that contains the text that is displayed on the menu to describe the options that can be selected.

The OPTTXTMSGF parameter must identify an existing message file and not a message source member.

*NONE: No option text message file is used. The CMDTXTMSGF parameter is used to specify the option text.

The name of the option text message file can be qualified by one of the following library values:

*CMDLIB: The command library is used to locate the option text message file.

*CURLIB: The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.

library-name: Specify the name of the library to be searched.

message-file-name: Specify the name of the option text message file used for the descriptions of the options on the menu being created. The message ID prefix of USR is required unless IGCDTA(*YES) is specified.

REPLACE
Specifies whether the existing display file is replaced by the new file. More information on this parameter is in Commonly used parameters.

*NO: No replacement occurs.

*YES: The existing display file is replaced by the one being created.

Note: A display file is not created if a program, message file, or any other non-display file already exists in the menu library. Only one System/36 "load member" of a given name may exist in any given library.

FREEFORM
Specifies that the menu is created either in free-format or in a fixed-format, using two columns with twelve items in each column.

*NO: Free format is not used. The menu is created by using a fixed format with two-columns.

*YES: The menu is created using free-format.

DDSLIST
Specifies whether a partial or full DDS compiler listing is provided.

*PARTIAL: A partial compiler listing is provided.

*FULL: A full DDS compiler listing and cross-reference are provided.

MAXDEV
Specifies the maximum number of devices that can use the menu at one time.

5: The maximum number of devices is five.

number-of-devices: Specify the maximum number of devices that can use the menu at one time. The possible values range from 1 through 256.

AUT
Specifies the authority given to users who do not have specific authority to the menu object, who are not on an authorization list, and whose user group has no specific authority to the menu object.

*LIBCRTAUT: The public authority for the menu object is taken from the value on the CRTAUT parameter of the target library (the library that is to contain the menu object). The public authority is determined when the menu object is created. If the CRTAUT value for the library changes after the menu object is created, the new value does not affect any existing objects.

*USE: The user can perform basic operations on the menu object, such as running a program or reading a file. The user cannot change the menu object. *USE authority provides object operational authority, read authority, and execute authority.

*CHANGE: The user can perform all operations on the object except those limited to the owner or controlled by object existence authority and object management authority. The user can change and perform basic functions on the object. Change authority provides object operational authority and all data authority.

*ALL: The user can perform all operations except those limited to the owner or controlled by authorization list management authority. The user can control the object's existence, specify the security for the object, change the object, and perform basic functions on the object. The user also can change ownership of the menu object.

*EXCLUDE: The user cannot access the menu object.

authorization-list-name: Specify the name of the authorization list used.

TOFILE
Specifies the qualified name of the source file (to-file) in which to store the data description specifications (DDS) source that was used to create the object. If the file does not exist, the requester must be authorized to the Create Source Physical File (CRTSRCPF) command so it can be created. This parameter is ignored if TOMBR(*NONE) is specified.

Note: See special case for TOMBR when QS36DDSSRC is specified.

The name of the DDS source file can be qualified by one of the following library values:

*CMDLIB: The command library is used to locate the source file.

*CURLIB: The current library for the job is searched. If no library is specified as the current library for the job, the QGPL library is used.

library-name: Specify the name of the library to be searched.

QDDSSRC: The IBM-supplied source file, QDDSSRC, is used.

file-name: Specify the name of the source file in which to store the DDS source.

TOMBR
Specifies the name of the source file member in which to store the data description specifications (DDS) source. If the member does not exist, it is created. When the member name is the same as that of the display file name, and the to-file is QS36DDSSRC in the same library as the display file being created, the DDS is saved in this member only if the compile operation of the display file is successful. To guarantee that the DDS is saved, specify the name of some other source file, library, or member.

*NONE: The DDS source is not stored in the to-file.

member-name: Specify the name of the source file member in which to store the DDS source.

IGCDTA
Specifies whether the file contains double-byte character set (DBCS) data.

*NO: The file does not process DBCS data.

*YES: The file processes DBCS data.

TGTRLS
Specifies the release level of the operating system on which you intend to use the menu being created.

When specifying the target-release value, the format VxRxMx is used to specify the release, where Vx is the version, Rx is the release, and Mx is the modification level. For example, V3R6M0 is version 3, release 6, modification level 0.

Valid values depend on the current version, release, and modification level, and they change with each new release. See the Valid Values for TGTRLS Parameter table in the Backup and recovery topic in the Information Center for a complete list of valid values.

Note: To use the menu on the target system, save the object specifying the target release level that was specified on the create command and then restore it on the target system.

If your system is running V3R7M0 and you want to create an object for distribution to a V3R6M0 system :

  1. Create the object with TGTRLS(V3R6M0) or TGTRLS(*PRV).

  2. Save the object with TGTRLS(V3R6M0) or TGTRLS(*PRV).

  3. Restore the object on the V3R6M0 system. The object also can be restored on a later release of the operating system.

*CURRENT: The menu is to be used on the release of the operating system currently running on your system. The menu can also be installed on a system with any subsequent release of the operating system installed.

*PRV: The menu is to be used on the previous release with modification level 0 of the operating system. The menu can also be installed on a system with any subsequent release of the operating system installed.

target-release: Specify the release in the format VxRxMx. The menu can be used on a system with the specified release or with any subsequent release of the operating system installed.

Example for CRTMSGFMNU 

CRTMSGFMNU   CMDTXTMSGF(MYMENU##)
  REPLACE(*YES)  FREEFORM(*NO)

This command creates a menu by using a message file named MYMENU. The message file is located in the current library for the job and it contains the commands run for each menu option. Because no OPTTXTMSGF parameter is specified, the text of the command appears on the screen in place of the option text. REPLACE(*YES) specifies that an existing display file is replaced. The created display file is in a fixed-format, with options 1 through 24 arranged in two 12-element columns.

Error messages for CRTLMSGFMNU

*ESCAPE Messages

SSP4464
Member &3 in file &1 in use, cannot be shared.
SSP5004
&1--This load member exists, but is not a $SFGR member.
SSP5005
&1 display file already exists.
SSP5011
&1 not allowed for display file name.
SSP5017
TOFILE library &1 not found.
SSP5019
Terminating errors in $SFGR input specifications.
SSP5027
TGTRLS(*PRV) allowed with changes only when existing display file created for previous release.
SSP5451
Existing file &1 is not a display file.
SSP5750
Command message file messages 1-24 contain only blank text.
SSP5751
Command text message file name must end with ##.
SSP5752
Command text message file library &1 not found.
SSP5753
Command text message file &1 not found.
SSP5754
Option text message file &1 not found.
SSP5755
Unable to create $BMENU work file.
SSP5756
Command message file name must be longer than 2 characters.
SSP5757
Command text message file has no MIC in 0001-0024 range
SSP5762
Option text message file name cannot be same as menu name.
SSP5770
Option text message file required for free format menu.
SSP5774
Command and option message files must not be the same.
SSP6124
Unexpected error occurred.
SSP7375
Error &1 received by &2 utility.
SSP8663
User not authorized to access &1.
SSP8679
Not authorized to access member &1.