Menu Service Procedure Interface › Menu Service Procedure Statements › $MHOPT=ENTRY Statement

$MHOPT=ENTRY Statement

This statement indicates initial entry into a menu. When the value of &$MHOPT is ENTRY, you can use the menu service procedure to perform any special processing that is required before the display of the menu.

Read-Only Variables

This statement contains the following read-only variables:

&$MHOPT

This variable is set to ENTRY.

&$MHAPPLID

This variable is set to the ID of the application to which the menu belongs.

&$MHMENUNUM

This variable is set to the menu number.

Modifiable Variables

This statement contains the following modifiable variables:

&$MHAUTHMAP

Use this variable to control the access to menu options. This variable can be set to a map (15 characters in length) with each character corresponding to a menu option. Valid values for each character are as follows:

1

Access to the menu option is allowed.

0

Access to the menu option is not allowed. If this variable is set, it is used as the menu map for the user. If it is not set, access is allowed to all menu options.

&$MHINWAIT

Use this variable to set a time-out when the menu is not receiving any input. This variable can be set to an INWAIT value (between 0 and 86400 seconds) that is used when displaying the menu. If this value is zero, the menu does not time out. If the INWAIT time expires, the service procedure is called with &$MHOPT set to TIMEOUT.

&$MHDOUBLESPC

Use this variable to specify whether a blank line should be inserted before each input line on the menu. If this variable is set to YES (the default), a blank line is inserted before each input field line on the menu. If this variable is set to NO, input field lines are displayed as defined for the menu.

&$MHINPUTJUST

Use this variable to specify the value of the JUST keyword on the #FLD panel statement. Valid values are LEFT, RIGHT, ASIS, and CENTER. The default is LEFT.

&$MHINPUTMODE

Use this variable to specify the value of the MODE keyword on the #FLD panel statement. Valid values are SBCS and MIXED. The default is SBCS.

&$MHCOMMAND

Use this variable to enable the processing of commands that are not known to the system. If this value is YES, the service procedure is called with &$MHOPT set to COMMAND.

&$MHFK1..24

Use these variables to override the standard function key actions.

&$MHFKLAB1..24

Use these variables to override the standard function key labels.

&SYSMSG

Use this variable to return a message. If an error occurs during special processing, this variable must be set to an error message.

Return Codes

The variable &RETCODE must be set by the menu service procedure to one of the following return codes:

0

Proceed; display the menu

8

Terminate the menu