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

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.

Keep option text msg file (KEEP)

Specifies whether the option text message file is kept when the compilation is complete.

*NO

The option text message file is not kept.

*YES

The option text message file is kept. If the option text source member contains the screen format generator (SFGR) source and has the same name as the menu, then KEEP(*YES) is required.

DDS listing (DDSLIST)

Specifies whether a partial or full DDS compile listing is provided.

*PARTIAL

A partial listing is provided.

*FULL

A full DDS listing and cross-reference are provided.

Maximum devices (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. Valid values range from 1 through 256.

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.