Configuring a Pragma user

Ensure that you are using the Pragma version identified in the Platform Support Matrix, or newer.

  1. Select Start > Local FortressSSH Configuration from the Windows menu to access Pragma’s configuration.
  2. Select Users > Default.
  3. Specify this information:
    Default Screen Mode
    • Select Advanced Console or Full Console. These modes are the only supported screen mode compatible with Pragma’s Screen Draw Options.
    Home Directory
    • Click Browse to select the directory where metarf.exe is located. Typically, this directory is: [ SCE installation folder ]\rf\metarf
    Allow system beep to pass to client
    • Select this check box to all RF equipment to receive the ASCII bell control character. The Meta RF application emits ASCII bell characters to cause the system to beep when normal application errors occur.
    CodePage Translation
    • Select the check box and specify 65001 Unicode (UTF-8). The Meta RF application uses UTF8 to encode unicode characters on the RF screen. For multibyte languages, the use of a PuTTY telnet client on a Windows desktop is required to render the UTF8 text.
    • Multibyte language customers cannot use

      Meta RF

      from the Windows command prompt. They must use the PuTTY client application and the PuTTY configuration for successful Unicode font rendering of Curses RF screens over Windows emulation.
  4. Select Users > Console Settings.
  5. Specify this information:
    Shell/Custom Program
    • Click Browse to select the directory where metarf.exe is located. Leave Startup Program empty.
    Screen Draw Options
    • Select these check boxes:
    • Use optimized screen read
    • Line by line screen comparison
    • Clear to eoln outside of drawing rectangle
    • Enable Application Wrap
  6. Select Users > Default > Environment Variable
  7. Set up these environment variables:
    • HH_locale: Determines the language of the login screen.
      • Specify en in the Value field and select Replace in the Location if exist field.
      • The HH_locale parameter is for the login screen only. After an RF user is logged into the Meta RF application, the user’s configured locale in the WMS determines how RF screen text is localized. Every RF user has User Preferences – Regional and General which specify all user locale preferences.
    • HH_device: Determines the device dimensions, 16x20 and 8x40.
      • Specify 16x20 or 8x40 in the Value field and select Replace in the Location if exist field.
    • TMPDIR: Location for logging files.
      • Specify a location for the files in the Value field and select Replace in the Location if exist field.
    • These parameters are set globally for all users in the MetaRF.ini file. However, the Pragma variables override those in the MetaRF.ini file in order to customize the experience by Windows login user. For example, if you have some devices that are 16x20 and some that are 8x40, you can configure two Window users in Pragma and setup the devices to automatically connect and login to the respective user for their device dimensions.
    • Note: Note:
      The user is still presented with the WMS login prompt to give their specific WMS credentials. The Windows login is a second login used only for the Pragma connection.
    • The Windows and Pragma user must have permission to write or create files in this directory.
  8. Optionally, to capture metarf.exe diagnostic log files, select Console Settings > Shell/Custom Program and add -l, lowercase L, to the end of shell/custom program directory. Add the TMPDIR Pragma environment variable to point the log files to a directory.
    • The Windows and Pragma user must have permission to write or create files in this directory.