Support

When you try to assign scripts and toolbars to a specific users screen, there exists [is] a Select button to search [for] and select the script/toolbar. But, when you save the changed configuration, an error message window appears, indicating that there exists a problem with the toolbar/script because it is not found in the default toolbar or script directory.

The new version requires the scripts and toolbars to be in a standard configuration location. This location contains separate subfolders for Appearance Schemes, Keyboards, Scripts, Toolbars and Xlate (Character Translations). The eXpress Net program knows to look in the root of this configuration directory for the User and Host configuration, and to find the scripts and other needed files in the subfolders.

If you have configured any users in Version 3 of UTS eXpress Net, and wish to import those old configuration files to the new Version 4, we have provided a convenient tool for you.

There is a conversion utility that is provided during the installation. It should be located in your program directory where you installed the administration program and it is called “UTSNetConvert.exe”. You can run that program and select your USERS.XPU file. It will convert your settings and save the file in the same directory as USERS.USET.
The host connections file called QPortNet.Cfg does not need any conversion.

Question: I would like to ask about the UTS key functions in the UTS eXpress program. I need to add a new UTS key function, but I do not know what to do. Can I add the key function myself, or do you have to add the key for me? The keys that I want are, such as, cursor to end display, / character, etc.

Answer: Many keys are already configured, but you can change them to whatever you want.
To view all the keys as they are configured by default, select Show Keyboard Help Window from the View menu on any opened screen.

Editors note: This answer has been modified from its original form to reflect the procedures used with eXpress, Version 4.

To configure any of those keys differently, click the Configure UTS eXpress Plus button on the UTS eXpress Plus Control Panel. Since a keyboard’s configuration may now be assigned to a particular screen, select the screen tab for which you wish to have a custom keyboard. On the Appearance and Keyboard tab (Other Settings tab in eXpress IT), click the Custom Keyboards button and configure any of the existing UTS function keys, as you would like them. Notice that you can name your keyboard configuration by using the New Keyboard function and then select that keyboard on the Appearance and Keyboard tab.

If you have requirements that are not a standard UTS function key, such as, cursor to end of display, you can record a script and assign an action key to the script that will cause that script to be executed. For example:

1. From any opened screen window, select Start Script Recorder from the Script menu.
2. Type Cursor-to-Home (Home key) followed by Backspace key.
3. From the screen window, select End Script Recorder from the Script menu.
4. Enter a file name when prompted (example: Cursor to EOD).
   Your recorded script will look like this:
   ' *** Script recorded by UTS eXpress Plus Script Recorder
Sub Main()
UTSKey UK_CURSOR_TO_HOME
UTSKey UK_CURSOR_LEFT
' *** End of recorded script
End Sub
5. Next, click the Configure button on the UTS eXpress Plus Control Panel.
6. Select your screen and on the Script and Actions tab, click the Script Manager button.
7. Select your keyboard from the Keyboard Name list and click the Custom Keyboards button.
8. Select the script near the bottom of the Key Actions list (Cursor to EOD).
9. On the virtual keyboard, click the key or key combination (Ctrl+End) that will be used to activate the script.
10. Click the Set Key Assignment button.
11. The next time you type that key sequence (Ctrl+End) from the screen window, that script will be executed.

Note: For eXpress IT users, the above procedure is similar but you work with Macros, not Scripts.

Sometimes it is convenient to change certain eXpress keyboard settings to be more compatible with the way you use other software. For instance, UTS users might want to switch the default Cursor-to-Home and Cursor-to-Start-Line to behave more like Windows. It might also be beneficial to link this change to a particular screen but not others. To begin the switch, click the Configure button on the eXpress Control Panel and click the desired screen tab (e.g., Screen 4). Next, select the Appearance and Keyboard tab and click the Custom Keyboard button.

Click the New Keyboard button and give it a name. You will be asked to verify if this is to be a copy.

In the Key Actions list box, scroll down until you see the desired Key Function. In this instance, we are looking for CURSOR TO HOME and CURSOR TO START LINE.

Since we are making a switch, we must first “undefine” one of the two keys. Select CURSOR TO HOME with the mouse and click the Undefine Key button. Next, select CURSOR TO START LINE and click the Type a Key Sequence button. Press the Home key when you see the “Please press the desired key sequence now” message box. Click the Yes button at the next prompt followed by the Redefine button.

Complete the switch by selecting CURSOR TO HOME, click the Type a Key Sequence button, press Ctrl+Home, Yes and OK.

Finally, select the new keyboard name from the Select Custom Keyboard Layout drop-down list box. You’re done. The keys are switched and assigned to the screen. OK out of the configuration process and check you key switch out.

Part of the flexibility of UTS eXpress Net 4’s configuration allows an administrator to designate users in one of three categories: power, limited and restricted.

Restricted users can not change ANY of their settings. They get only what the administrator assigned to them for host connections, appearance, scripts, terminal screen settings, etc. This also includes ‘Auto Open Session’.

Limited users have the ability to change everything with the exception of the Host Connections and Routes Assignments. Only the administrator can assign and configure the connections and routes. The user can then change their own colors, fonts, scripts and even the ‘Auto Open Session’. However, because they have this ability to manage their own configuration, the administrator ONLY has control over their connection information. If the administrator sets an option, such as the ‘Auto Open Session’ for a limited user, it will not show for that user since they manage their own configuration. Only restricted users would show those settings from the administrator.

Power Users run eXpress Net in a way that they have control over every aspect of the emulator. There are NO settings that are carried over from the administrator because the user has FULL privileges to configure how they want.

If you want to control ALL aspects of your installations, I would suggest making users “Restricted” so you can set options such as the ‘Auto Open Session’. If you want your users to decide options like that on their own, then you can make them “Limited”. You might want to make yourself a ‘Power’ user.

For those of you interested in learning about how easy it is to generate complete I-QU PLUS-1 programs to reorganize DMS 1100 databases, KMSYS Worldwide has created a I-QU ReorgComposer demonstration that is readily available from our web site.

The reorganization isolates a CALC owner and its members in a single area. The generated code takes into consideration any sets that span to adjoining areas.

Fancy Screen Prints

Sometimes it is nice to jazz up a screen print to position the output on the page where you want it.

Here is a small script that will do a screen print (within rectangle) in 9-pt Courier New font. If you want to use a larger font, you might want to remove the PrintRect reference and adjust the script accordingly.

Note: The script below does substitution for special characters such as delimiters (hex 1c thru 1f) in the T27 environment but could easily be adapted for UTS usage:

Sub Main()
Dim x as Integer
Dim y as Integer
Dim c as String
Dim NewLine as String
Dim LineHeight as Integer
Dim Margin as Integer
PrintBeginDoc
‘ Set printer font
PrintSetFont "Courier New"
PrintSetFontStyle fsNormal
PrintSetFontSize 9
‘ Calculate margin as one inch
Margin = PrintPageHeight / 10
‘ Calculate line height based on current font
LineHeight = PrintTextHeight("X")
PrintMoveTo Margin, Margin
For x = 1 to 25
PrintMoveTo Margin, Margin + x * LineHeight
NewLine = ""
For y = 1 to 80
c = Mid(GetScreenLine(x), y, 1)
If c = Chr(&H1f) or c = Chr(&H1e) or _
c = Chr(&H1c) or c = Chr(&H1d) Then
NewLine = NewLine & " " ‘ Substitute space
Else
NewLine = NewLine & c
End If
Next y
Print NewLine
Next x
PrintRect Margin, Margin, Margin + (Margin * 6), _
Margin + (LineHeight * (x + 1)), 5
PrintEndDoc
End Sub

Description Details: Database area has 50% in primary pages 50% in overflow pages. If no changes are made to the physical record size can an in place reorg be executed to reassign database area to maximum amount of records in primary pages and a minimum amount in overflow pages? Or is an Unload then Reload then fix pointers necessary to change the number of primary and overflow pages to an area?

Answer: You need to do an unload/reload. The “in-place” choice only generates a DMS MODIFY which will not cause records to be moved.
If you have requirements that are not a standard UTS function key, such as, cursor to end of display, you can record a script and assign an action key to the script that will cause that script to be executed. For example:

Special Key Macro

Question
With my old emulator, the Shift+End key combination would select all of the text in a field. There does not appear be a comparable function in eXpress Plus. Why?

Answer
The Shift+End key combination is a block selection keystroke reserved by Windows and, as such, may not be overridden; however, a script may be used to select text. Also, an alternate action key or key combination may be assigned to activate the script.

The following script selects the text in an unprotected field located at the current cursor position. Only the significant text is selected; i.e., trailing spaces are ignored. The script may be utilized with both T27 eXpress Plus and UTS eXpress Plus products.

You can copy the following code and past it into a file named SelectField.bas.

‘This script selects all typed characters in the current field.’
Sub Main()
Dim CRow as Integer
Dim CCol as Integer
Dim SCol as Integer
Dim ECol as Integer
Dim FoundBlank as Integer
Dim s as Integer
Dim l as Integer
Dim EndDel as String
' Get the cursor row and column.CRow = GetCursorRow()CCol = GetCursorCol()
If (GetScreenAttribute(CCol, CRow) and 8) = 8 Then ' Cursor must be in' an unprotected area.
Exit SubEnd If
' Find the end of the field (or end of the line)
s = CCol
ECol = 80
Do
If (GetScreenAttribute(s, CRow) and 8) = 8 Then
s = s - 1
ECol = s
Exit Do
End IfIf s >= 80 Then
Exit Do
End If
s = s + 1
Loop' s now points to character before next protected region' Work backward to the first non space (or beginning of the field)'
then get the end of the selection
SCol = 1
FoundBlank = False
Do
If (GetScreenAttribute(s, CRow) and 8) = 8 ThenSCol = s + 1Exit Do
End If
If FoundBlank = False and GetScreenText(s, CRow, 1) <> " " ThenFoundBlank = True
ECol = sEnd If
If s = 1 ThenSCol = sExit
Do
End Ifs = s - 1Loop' Move the cursor the start of the field.SetCursor SCol, CRow' Mark the selectionMarkBlock SCol, CRow, ECol, CRowRefreshScreen'
Done.
End Sub

Making Use of the IQU Security SGS’s In Order to Control IQU Access to a Production Environment

Question

Are we right in assuming that batch programs (IQU) started by either a user in demand or a system scheduler are subjected to the scrutiny of scanning the ‘Security Groups’ we’ll create?

Also, it looks as if one could get carried away building these SGS. Any tips on how to keep it relatively simple?

Answer

The answer to your first question is “YES”. With I-QU PLUS-1 security, it is all or nothing. When security is enabled in the COMUS configuration, I-QU does a top-down search through the file (and element) that you specify. Any match against an ACCESS sgs ends the search; otherwise, the search continues. If the search falls off the end of the file, security fails; i.e., access is denied.

Yes, you can get carried away with applying security.

TIP: Start simple and keep it simple! For example, you probably only have one or two people that actually do reorgs. Put them in a DBGROUP that allows them access to all reorg utilities that make alterations: PFIX and SCHUTL. All other utilities are harmless; PBLD, QRYSCH, QINDEX. For the IQU program, you define ALLOWED/DENIED access by IO type. The type of access you want, you specify by GROUP.

Here is a simple example where we have divided DMS access into two groups (the example in the IG is a bit overpowering at first glance). All other file types are wide open. We don’t necessarily recommend that, however, especially for something potentially destructive as DIO.

USER GROUP NONREORGS HAS CHAZ
USER GROUP REORGS HAS BOB LEW
SCHEMA GROUP DEMOSCH HAS DEMOSCH
SUBSCHEMA GROUP DEMOSUB HAS DEMOSUB
SCHEMAFILE GROUP DEMOFILE HAS FILE,UDS$$SRC*SCHABS
ACCESS TO DMR ST ALLOWED FOR NONREORGS FOR ;
RETRIEVAL INVOKING DEMOSUB OF DEMOSCH FILE DEMOFILE
ACCESS TO DMR ST ALLOWED FOR REORGS FOR LOAD ;
INVOKING DEMOSUB OF DEMOSCH FILE DEMOFILE
ACCESS TO DMR $ALL ALLOWED FOR $ALL FOR LOAD
UTILITY TYPE REORGTYPE HAS PBLD PFIX SCHUTL
ACCESS TO UTILITY REORGTYPE ALLOWED FOR REORGS
ACCESS TO UTILITY REORGTYPE DENIED FOR $ALL
ACCESS TO UTILITY $ALL ALLOWED FOR $ALL
ACCESS TO PCIOS $ALL ALLOWED FOR $ALL FOR $ALL
ACCESS TO DIO $ALL ALLOWED FOR $ALL FOR $ALL
ACCESS TO RDMR $ALL ALLOWED FOR $ALL

Considering an Upgrade? Perhaps this will convince you.

Question

“We have been using your product back since 1.0 came out. We are looking into the possibility of an upgrade but were wondering if you had any documentation that would show enhancements that were added after 1.0 came out so we could get a feel of what the differences were? What would be the possibility of getting a copy of the latest version for us to test drive to see if we want to consider the possibility of upgrading?

Answer

That’s a great question! The number of enhancements to UTS eXpress Plus since the Version 1 days are almost too numerous to mention, but I will make an attempt to outline at least the newest features.

Version 1 was a 16-bit Windows edition and, as such, was limited by the scope of that operating environment. With the many improvements in Windows technology, UTS eXpress Plus has evolved into the most robust emulator available to date. The current version (Version 4) was developed in the Windows XP environment and takes full advantage of that 32-bit platform. Version 4’s major enhancement allows the user to tailor each screen to a particular environment (BIS, DPS transaction, etc.). For example, each screen can have its own keyboard configuration, script menu, appearance and customized toolbar. The following is a list of major enhancements since Version 1:

• Color configurations now conform to standard Windows colors;
• Input Recall list now retained between sessions;
• More drag-and-drop capabilities in the visual configuration;
• Multiple screen captures to print and/or file;
• Screen “Send to” option allowing screens to be e-mailed as text or bitmap attachments;
• Supports user-developed Local Printer Objects;
• Built-in script recorder to record frequently used, user tasks;
• Keys can be mapped to either terminal functions, like “Transmit”, or to execute predefined scripts;
• Each screen can have an automatic sign-on script assigned which is executed when the screen is initially opened;
• Most configuration settings are now independent of registry settings in accordance with new Windows standards;
• And higher security measures include single point sign on.

For a more extensive list of all UTS eXpress Plus features, please see the UTS eXpress Plus page. You may also download an evaluation version of the software from that same page.

How do I distribute a common configuration?

Question

“I’m trying to put together a simple distribution set-up so that we can begin deploying T27 eXpress IT to our roughly 200 users…. Most of our users program a number of function keys to pull up various user screens. Most everyone uses a few of [the] function keys for the same commands site-wide. What we wanted to do was to build a MACROS.CFG file that had about 90 or so pre-defined macros already in it, but most of them unassigned. Our thinking was that we could install the T27 eXpress IT then copy the MACROS.CFG file to the scripts directory.

Then we could bring up the Macro Manager and simply choose the macros we wanted, then assign them to a key or key sequence….

“I hope you understand what it is I’m trying to do and can shed some light on the situation. We REALLY don’t want to have to sit at each workstation where we install the product and create all of these macros for each installation….

“Is what we’re trying to do possible and if so, are we approaching it incorrectly?”

Answer

No, your approach is perfect.

Under eXpress, Version 4, distributing configurations is not only possible but easy. To conform to the Windows XP standard, all configuration settings are now stored in files rather than in the Windows Registry as you discovered.
Once you have configured all the macros that you want, simply distribute C:\Documents and Settings\ \Application Data\KMSystems\T27_EXPRESS_IT_4.0\CONFIGURATION\Scripts\MACRO.CFG via a shared file server, or by other means, to each user. The file should be placed in a similar folder on the user’s system.

Editor’s Note: Most configuration files for the emulator are found in the CONFIGURATION folder of the product; however, configuration settings for the host connections are found in C:\Documents and Settings\\ Application Data\KMSystems\QPortT27_4.0\ CONFIGURATION\QPORT.CFG.

How do I distribute a common configuration?

Question

“I’m trying to put together a simple distribution set-up so that we can begin deploying T27 eXpress IT to our roughly 200 users…. Most of our users program a number of function keys to pull up various user screens. Most everyone uses a few of [the] function keys for the same commands site-wide. What we wanted to do was to build a MACROS.CFG file that had about 90 or so pre-defined macros already in it, but most of them unassigned. Our thinking was that we could install the T27 eXpress IT then copy the MACROS.CFG file to the scripts directory.

Then we could bring up the Macro Manager and simply choose the macros we wanted, then assign them to a key or key sequence….

“I hope you understand what it is I’m trying to do and can shed some light on the situation. We REALLY don’t want to have to sit at each workstation where we install the product and create all of these macros for each installation….

“Is what we’re trying to do possible and if so, are we approaching it incorrectly?”

Answer

No, your approach is perfect.

Under eXpress, Version 4, distributing configurations is not only possible but easy. To conform to the Windows XP standard, all configuration settings are now stored in files rather than in the Windows Registry as you discovered.

Once you have configured all the macros that you want, simply distribute C:\Documents and Settings\ \Application Data\KMSystems\ T27_EXPRESS_IT_4.0\CONFIGURATION\Scripts\MACRO.CFG via a shared file server, or by other means, to each user. The file should be placed in a similar folder on the user’s system.

Editor’s Note: Most configuration files for the emulator are found in the CONFIGURATION folder of the product; however, configuration settings for the host connections are found in C:\Documents and Settings\\ Application Data\KMSystems\QPortT27_4.0\ CONFIGURATION\QPORT.CFG.

Using QPlex in Older Browsers

Question

When my users try to access the QPlex client .asp, all that some of them see is a message that reads, “I am sorry but the QPlex Client requires version 3.01 of Internet Explorer or greater.” Can you please help?

Support Note: This same situation can occur for the web implementation of eQuate, T27 eXpress Net or UTS eXpress Net.

Answer

There is a file on the Web server describing the Web browser to the server. If you are using Microsoft Internet Explorer 6, that file may not be up-to-date resulting in an error stating that you must use Internet Explorer. The file is BROWSCAP.INI. It is hiding in %systemroot%\inetsrv (or sometimes %systremroot%\inetsrv\asp). The Microsoft Global Product Support Site has the Microsoft Knowledge Base Article Q311227, HOW TO: Add Internet Explorer 6 Information to the Browscap.ini File. Please use this link to obtain these instructions.

Increasing the Printer Buffer in I-QU PLUS-1

Question
Is there a way to increase the size of the printer buffer in I-QU? Right now it is only 132 characters and I would like to increase that value.
Answer
The display output is limited to 132 characters before line wrap occurs; however, the internal I-QU PLUS-1 print buffer is the same size as the RDA. Using the plus (+) character on the DISPLAY, EDIT, TRIMDISP and TRIMEDIT commands allows you to stage into the $PBUFF variable. You may then set this in the RDA and WRITE it to a SEQ file and @SYM the output. Here is a simple example:

Limitation to the page size

Question

Last time I used I-QU PLUS-1 to reorganize a DMS area with 262143 pages and page size of 5376 words (3 tracks), I got some kind of error. I had to reduce the page size to 4088 words to successfully reorganize the area using I-QU PLUS-1.

Is there a limitation to the page size when using I-QU PLUS-1?

Answer

The limitation is in the PFIX Utility. Here is a change that you can apply to increase the page size:

*PFIXCOMM
-231,23105
PB-ALL PIC X(21504).
-271,27110
FILLER PIC X(21456).
-273,27310
PB-WORDS OCCURS 5376

I-QU Plus-1: Partial Word Count

I created a file with an I-QU PLUS-1 program [would also apply to Q-LINK] and after sorting the data with @SORT, I discovered that the last word, or partial word, was being truncated. It appears that I-QU PLUS-1 does not write the “partial word count” to the record as in COBOL. Can you supply a fix?

Answer

Unisys made a change to SORT 21R1 that considers a missing “partial word count” to be zero and truncates the data. They have since reconsidered that action (for reasons of backward compatibility) and issued PLE 17791354 and PCR 00201-01540-PCR.

I-QU PLUS-1 “Undefined Item”

Question

I have a quick question. I have good compiles from Schema/Subschema and register went okay but I can’t display any REDEFINE fields in the new schema. Just gives me “undefined item” tried with UCS and ASCII. Any ideas?

Answer

Yep. Sure do. Build a data item index file with QINDEX using the S$PROC directive (see Appendix C-6 in the I-QU PLUS-1 Programmer Reference Manual). Then, when you INVOKE in I-QU PLUS-1, add the NX option (see page 12-1 – 12-2). Finally, use the INDEX directive to get the S$PROC names (see page 8-2 & 8-3). You may download the manual here.

• Live On-line eQuate Web Demo
• eQuate Start-to-Finish Flash Demo

• Generate an I-QU PLUS-1 Reorg
• The I-QU Suite: Quicker Database Reorganizations with Shorter Development Cycles

This is a PowerPoint Presentation. Please save the file to your hard drive before running. Use the space bar or left mouse button to advance the presentation at your own pace. Press ESC to exit at any time.

• Develop a Secure Automatic Sign-on Script
• Configure a Customized Keyboard
• Record a Macro and Assign an Activation Key
• Create and Assign a Screen Color Scheme
• Activate the Supplied Microsoft Office Toolbar
• Create a Customized Toolbar

• Develop a Secure Automatic Sign-on Script
• Activate the Supplied Double-click MARC Action
• Configure a Customized Keyboard
• Record a Script and Assign an Activation Key
• Create and Assign a Screen Color Scheme
• Activate the Supplied Microsoft Office Toolbar
• Create a Customized Toolbar

• Live HGS Client for UTS Emulation
• Live HGS Client for T27 Emulation

• Live Online QPlexView Demo from Our Web Site