Create S/36 Menu (CRTS36MNU)

The Create System/36 Menu (CRTS36MNU) command creates a menu (display file and command message file) from your source members. You 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.

Restriction: Option 5 of the operating system must be installed to run this command. This command can be run either natively or in the System/36 environment.

Parameters

Keyword	Description	Choices	Notes
CMDTXTMBR	Command text source member##	Name	Required, Positional 1
OPTTXTMBR	Option text source member	Name, *NONE	Optional, Positional 2
CMDTXTSRC	Command text source file	Qualified object name	Optional, Positional 3
	Qualifier 1: Command text source file	Name, QS36SRC
	Qualifier 2: Library	Name, *CURLIB
OPTTXTSRC	Option text source file	Qualified object name	Optional, Positional 4
	Qualifier 1: Option text source file	Name, QS36SRC
	Qualifier 2: Library	Name, CMDLIB, CURLIB
MNULIB	Menu library (LOADLIB)	Name, CMDLIB, CURLIB	Optional, Positional 5
REPLACE	Replace menu	NO, YES	Optional
FREEFORM	Free form menu	NO, YES	Optional
KEEP	Keep option text msg file	NO, YES	Optional
DDSLIST	DDS listing	PARTIAL, FULL	Optional
MAXDEV	Maximum devices	1-256, 5	Optional
AUT	Authority	Name, USE, ALL, CHANGE, EXCLUDE, *LIBCRTAUT	Optional
TOFILE	To DDS source file	Qualified object name	Optional
	Qualifier 1: To DDS source file	Name, QDDSSRC
	Qualifier 2: Library	Name, MNULIB, CMDLIB, *CURLIB
TOMBR	To DDS source member	Name, *NONE	Optional
IGCDTA	User specified DBCS data	NO, YES	Optional
TGTRLS	Target Release	Character value, CURRENT, PRV	Optional

Top

Command text source member## (CMDTXTMBR)

Specifies the source member that contains the System/36 message source that is used to create the command text message file. This message file defines the commands that are used when an option is selected. The message IDs must begin with USR.

This is a required parameter.

member-name-##: Specify the name of the source file member to use for the command text message file being created. The trailing ## symbols are required. The menu (display file) name is the same as the member name without the ## symbols.
Note: The message file name specified within the source member must be the same as the source member name.

Option text source file (OPTTXTMBR)

Specifies the source member that is used to create the option text message file, or a screen format generator (SFGR) source member used to create the menu display file.

*NONE: The option text is taken from the command text message file. If OPTTXTMBR(*NONE) is specified, FREEFORM(*NO) must also be specified.
member-name: Specify the name of the source member to use for the descriptions of the options on the menu you are creating. The member can contain either the SFGR or the System/36 message source. A source member must be specified when *YES is specified on the Free form menu (FREEFORM) parameter.

Command text source file (CMDTXTSRC)

Specifies the source file in which the command text member is located.

QS36SRC: The source file, QS36SRC, is used.
file-name: Specify the name of the source file that contains the member specified on the Command text source member## (CMDTXTMBR) parameter.

The possible library values are:

*CURLIB: The current library for the job is used to locate the file. 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 where the file is located.

Option text source file (OPTTXTSRC)

Specifies the name and library of the source file in which the option text member is located.

QS36SRC: The source file, QS36SRC, is used.
file-name: Specify the name of the source file that contains the member specified on the Option text source member (OPTTXTMBR) parameter.

The possible library values are:

*CMDLIB: The library specified on the Command text source file (CMDTXTSRC) parameter is used to locate the file.
*CURLIB: The current library for the job is used to locate the file. 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 where the file is located.

Menu library (LOADLIB) (MNULIB)

Specifies the menu library that is used to store the created menu.

*CMDLIB: The library specified on the Command text source file (CMDTXTSRC) parameter is used to store the file.
*CURLIB: The current library for the job is used to store the file. 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 where the menu is located.

Replace menu (REPLACE)

Specifies whether an existing display file is replaced.

*NO: An existing display file is not replaced.
*YES: An existing display file is replaced by the one being created.
Note: The menu is not created if it has the same name and library as an existing program or message file.

If terminating errors are encountered, the existing display file is not replaced. If the display file already exists, the AUT parameter is ignored, and the authorities for the old display file are copied to the new display file that replaces it.

Free form menu (FREEFORM)

Specifies whether the menu is created in free-format or in a fixed-format.

*NO: Free-format is not used. The menu is created using a fixed-format with two-columns. The message number corresponds to the option number.
*YES: The menu is created using free-format. If *YES is specified, a value must be specified on the Option text source member (OPTTXTMBR) parameter. Option text message numbers correspond to the row numbers on the screen.

Authority (AUT)

Specifies the authority you are giving the users who do not have specific authority to the object, who are not on the authorization list, and whose user group has no specific authority to the object.

If REPLACE(*YES) is specified and the display file already exists, the Authority (AUT) parameter is ignored and the authorities for the old display file are copied to the new display file that replaces it.

*LIBCRTAUT: The authority for the object is the same as the value specified on the Create authority (CRTAUT) parameter of the library in which the object is being created. If the value specified on the CRTAUT parameter is changed, the new value will not affect any existing objects.

*USE: The user can perform basic operations on the object, such as running a program or reading a file. The user cannot change the object. Use (*USE) authority provides object operational (*OBJOPR), read (*READ), and execute (*EXECUTE) authorities.

*ALL: The user can perform all operations except those limited to the owner or controlled by authorization list management (*AUTLMGT) 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 object.

*CHANGE: The user can perform all operations on the object except those limited to the owner or controlled by object existence (*OBJEXIST) and object management (*OBJMGT) authorities. The user can change and perform basic functions on the object. *CHANGE authority provides object operational (*OBJOPR) authority and all data authority. If the object is an authorization list, the user cannot add, change, or remove users.

*EXCLUDE: The user cannot access the object.

authorization-list-name: Specify the name of an authorization list to be used for authority to the object. Users included in the authorization list are granted authority to the object as specified in the list. The authorization list must exist when the object is created.

To DDS source file (TOFILE)

Specifies the name of the source file in which to store the DDS source that is used to create the menu. The file need not already exist. If you are authorized to the CRTSRCPF (Create Source Physical File) command, and the file does not exist, a new source file is created.

QDDSSRC: The source file, QDDSSRC, is used.
file-name: Specify the name of the source file in which to store the DDS source.

The possible library values are:

*MNULIB: The menu library is used to locate the source file.
*CMDLIB: The command library is used to locate the source file.
*CURLIB: The current library for the job is used to locate the source file. 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 where the source file is located.

To DDS source member (TOMBR)

Specifies the name of the source file member in which to store the DDS source. 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 source file specified on the To DDS source file (TOFILE) parameter.
member-name: Specify the name of the source file member in which to store the DDS source. If the member does not exist, it is added. If it already exists, it is replaced.

User specified DBCS data (IGCDTA)

Specifies whether the display file contains double-byte character data.

*NO: The display file contains no double-byte character data. Option text message IDs must begin with USR.
*YES: The display file or the message files contain double-byte character data. Option text message IDs may begin with USZ. To get the full benefit of this function, an IGC version of the operating system must be installed.

Target Release (TGTRLS)

Specifies the release level of the operating system on which you intend to use the object being saved.

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, V5R3M0 is version 5, release 3, modification 0.

Valid values depend on the current version, release, and modification level of the operating system, and they change with each new release. You can press F4 while prompting this command parameter to see a list of valid target release values.

*CURRENT: The object is to be restored to, and used on, the release of the operating system currently running on your system. The object can also be restored to a system with any subsequent release of the operating system installed.
*PRV: The object is to be restored to the previous release with modification level 0 of the operating system. The object can also be restored to a system with any subsequent release of the operating system installed.
character-value: Specify the release in the format VxRxMx. The object can be restored to a system with the specified release or with any subsequent release of the operating system installed.

Examples

CRTS36MNU   CMDTXTMBR(MENU##)  OPTTXTMBR(SFGRMBR)
            CMDTXTSRC(MYLIB/QS36SRC)  OPTTXTSRC(MYLIB/QS36SRC)
            MNULIB(WORKLIB)  REPLACE(*YES)
            FREEFORM(*YES)  KEEP(*YES)

This command creates a free format menu display from the specified SFGR source member, placing the resulting menu into library WORKLIB. Since the SFGR source is being used, FREEFORM(*YES) and KEEP(*YES) are required. The layout of the menu display is controlled by the format definition located in the SFGR source member. No special checking is done to ensure that the display file defined by this source is valid when used by the system as a menu.

Error messages

*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 ##.
SSP5755: Unable to create $BMENU work file.
SSP5756: Command message file name must be longer than 2 characters.
SSP5758: Command text source member &1 not found.
SSP5759: Option text source member &1 not found.
SSP5760: Command text message file has wrong name.
SSP5761: Option text message file has wrong name.
SSP5763: Option text member name should not be same as menu name.
SSP5766: Option text source library &1 was not found.
SSP5767: Menu library &1 not found.
SSP5768: Command text source library &1 not found.
SSP5772: Option text source member required for free format menu.
SSP5773: Command and option text member names 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.
SSP9080: Object &1 in use; it cannot be shared.