menu_banner (2K)

mnu_control(upd3) - Update Menu Control data

mnu_control(upd3) (18K)

This function allows the contents of the CONTROL table of the menu database to be reviewed and changed if necessary. It is equivalent to a configuration file which can contain the settings for numerous different options. The current options are:

Field List
Field NameTypeDescription
Default Language String Required. Used to define the default language to be used by the internationalisation feature.
Login Type String Required. Identifies if the LOGON screen is to use user_id or email_address to identify the user.
Password Change String Required. This has the following options:
  • At Random - The user can change his password whenever he likes, not when the system tells him to.
  • After 'n' logons - The user must change his password after passing through the logon screen 'n' times, where 'n' is specified in PASSWORD_COUNT below.
  • After 'n' days - The user must change his password 'n' days after the previous change, where 'n' is specified in PASSWORD_DAYS below.
Password Count Integer Optional. Only relevant when PASSWORD_CHANGE above is set to 'n' logons.
Password Days Integer Optional. Only relevant when PASSWORD_CHANGE above is set to 'n' days.
Password Retries Integer Optional. If set to a non-zero value a logon attempt with an invalid password can have this number of retries before the user's record on the menu database is marked as disabled.
Password Warning Integer Optional. If PASSWORD_CHANGE is set to 'logons' or 'days' this is the number of logons/days warning that will be given before a user's current password will expire. Any message will be generated during the logon process and shown on the MENU screen.
Format: Minimum length Integer Required. This specifies the minimum length for all new user passwords.
Format: Number of digits Integer Optional. This identifies the minimum number of numeric digits that a new password must contain.
Format: Upper case chars Integer Optional. This identifies the minimum number of uppercase characters that a new password must contain.
Format: Lower case chars Integer Optional. This identifies the minimum number of lowercase characters that a new password must contain.
Password Encryption? Boolean This option defines how user passwords will be stored in the menu database:
  • NO - as plain text (not very secure).
  • YES - encrypted (more secure).

Whenever this value is changed all the records on the USER table will be updated accordingly.

If it is ever required to change the encryption mechanism the following procedure is advised:

  • Update all existing passwords from encrypted to plain text.
  • Change the encryption mechanism.
  • Update all existing passwords from plain text to encrypted.
Hide Passwords? Boolean If this option is turned ON then user passwords will not be visible in any screen except where it is input. This will make exsting passwords invisible to all other users.
Authentication? string This identifies if the user password is to be authenticated internally, or via an external RADIUS or LDAP server.
Pagination Width numeric This defines how the pagination area is displayed.
Scrolling Width numeric This defines how the scrolling area is displayed.
Shutdown Start Time Optional. This identifies the start of the time period during which all users (except those with global access) will be locked out of the system. This is to allow periods of down time for system maintenance or upgrades to be scheduled. Users who try to access the system during any shutdown period will not be able to progress beyond the logon screen.
Shutdown End Time Optional. This identifies the start of the shutdown period.
Shutdown Warning Time Optional. Anybody who accesses the system between this time and SHUTDOWN_START will receive a message warning them of the scheduled shutdown.
Shutdown Days Boolean Optional. This accompanies SHUTDOWN_START. This identifies the days on which the shutdown times are effective. Please refer to FAQ55 for more details.

http://www.tonymarston.net
http://www.radicore.org