TESTCRT

  

The TESTCRT program generates, tests, and modifies a screen definition file for the system in use. The format of the command line is:

  

  

TESTCRT

  

TESTCRT, having been written in PL/B, searches the current subdirectory and then the root (\) subdirectory for the file SUNSCRN.DEF. If unable to locate the file, TESTCRT then creates it in the root (\) subdirectory. Otherwise, it is opened. The following menu then appears:

 

  

SUNBELT MS-DOS SETUP SCREEN FILE COMMAND Version x.x.x dd mmm yy

Copyright 1984-19xx Sunbelt Computer Systems, Inc.

  

                     SCREEN FUNCTION TEST

  

 1. TEST SCREEN FUNCTIONS

 2. TEST USER DEFINED FUNCTIONS

 3. TEST FUNCTION KEYS

 4. DEFINE SCREEN DEFINITION FILE

 5. MODIFY SCREEN DEFINITION FILE

 6. WRITE SCREEN DEFINITION FILE

 7. PRINT SCREEN DEFINITION FILE

 8. DEFINE/WRITE/EXIT SCREEN DEFINITION FILE

  

Enter selection or '99' to return

  

 

The options, their usage and menus (if applicable), are as follows:

 

  1. Test Screen Functions for testing the current screen definitions.

    2.  

     1. '*R' - ROLLUP SCREEN 1 LINE 16. '*CON' - CURSOR ON

     2. '*RD' - ROLLDOWN SCREEN 1 LINE 17. '*COFF' - CURSOR OFF

     3. '*Pn:m' - POSITION CURSOR 18. '*BLINK' - BLINK ON

     4. '*ES' - ERASE SCREEN 19. '*BLINKOFF' - BLINK OFF

     5. '*EL' - ERASE LINE 20. '*ULON' - UNDERLINE ON

     6. '*EF' - ERASE FRAME 21. '*ULOFF' - UNDERLINE OFF

     7. '*INSLIN' - INSERT LINE 22. '*T10' - TIMEOUT FUNCTION

     8. '*DELLIN' - DELETE LINE 23. '*BLACK' - BLACK COLOR

     9. '*INSCHR' - INSERT CHARACTER 24. '*RED' - RED COLOR

    10. '*DELCHR' - DELETE CHARACTER 25. '*GREEN' - GREEN COLOR

    11. '*HON' - REVERSE VIDEO ON 26. '*YELLOW' - YELLOW COLOR

    12. '*HOFF' - REVERSE VIDEO OFF 27. '*BLUE' - BLUE COLOR

    13. '*GON' - GRAPHICS TEST 28. '*MAGENTA' - MAGENTA COLOR

    14. '*DION' - DUAL INTENSITY ON 29. '*CYAN' - CYAN COLOR

    15. '*DIOFF' - DUAL INTENSITY OFF 30. '*WHITE' - WHITE COLOR

     

    Enter selection or `99' to return

     

    The sequence defined for each screen list control can be tested to verify its functionality. If any are incorrect, the correct sequence should be ascertained from the Programmer's Technical Reference for the system in use and the entered through option 5.

     

  2.  Test User Defined Functions for testing the *S0 - *S9 user defined controls.

    3.  

    0. USER DEFINED FUNCTION 0 - '*S0'

    1. '' ' ' ' ' 1 - '*S1'

    2. '' ' ' ' ' 2 - '*S2'

    3. '' ' ' ' ' 3 - '*S3'

    4. '' ' ' ' ' 4 - '*S4'

    5. '' ' ' ' ' 5 - '*S5'

    6. '' ' ' ' ' 6 - '*S6'

    7. '' ' ' ' ' 7 - '*S7'

    8. '' ' ' ' ' 8 - '*S8'

    9. '' ' ' ' ' 9 - '*S9'

     

    Enter selection or '99' to return

     

    These DISPLAY/KEYIN/PRINT list controls can be entered/modified through option 5 to provide special characteristics not already provided through the standard list controls. Specific rules concerning their usage are outlined in the PRINTER OUTPUT and INTERACTIVE INPUT/OUTPUT chapters of the manual.

     

  3. Test Function Keys for testing the Function and special/cursor key definitions.

    4.  

    FUNCTION KEY n - 'Fn'

    CURSOR UP KEY - 'UP'

    CURSOR DOWN KEY - 'DOWN'

    CURSOR LEFT KEY - 'LEFT'

    CURSOR RIGHT KEY- 'RIGHT'

    HOME KEY - 'HOME'

    END KEY - 'END'

    PAGE UP KEY - 'PGUP'

    PAGE DOWN KEY - 'PGDN'

    INSERT KEY - 'INS'

    DELETE KEY - 'DEL'

    ESCAPE KEY - 'ESCAPE'

     

    Enter selection or '99' to return

     

    The various Function keys and/or special/cursor keys on the terminal can be tested to insure the correct sequences have been defined for them. If an unrecognizable sequence is sent, the system sends an audible beep then waits for another key. Otherwise, a message is displayed indicating the corresponding key to which the screen definition file translated the received sequence. These sequences can be ascertained from the Programmer's Reference manual for the system in use and changed through option 5.

     

  4. Define Screen Definition File for creating a screen definition file.

    5.  

    1. PC (ANSI)

    2. PC Color (Snow)

    3. PC Mono. (Snow)

    4. PC Color (No Snow)

    5. PC Mono. (No Snow)

     

    Enter selection or '99' to return

     

    These basic screen definitions can be used as a foundation to customize a screen definition file. Attention should be taken to special characteristics of the system in use to insure compatibility with the definition selected. Once a selection is chosen, it can then be customized using option.

     

  5. Modify Screen Definition File modifies the currently defined screen list control sequences. Once all changes have been made, it verifies that everything is as desired before it returns to the main menu. The following informational menu appears followed by each list control's current definition that can then be accepted through a null entry or overwritten:

    6.  

    Enter '<' -- backup to previous definition

          '>' -- end the modification process

          '*' -- delete the entire entry

          "aa" -- ASCII values

          Hnn -- HEX value (nn must be 2 chars)

          Onnn -- OCTAL value (nnn must be 3 digits)

          nnn -- DECIMAL value (nnn must be 1 to 3 numeric digits)

          ^n -- a Control value (n must be 1 char)

          ESC -- the 'Escape' code

          Space or Comma to separate values

     

    In addition to the previously documented screen list controls, three other definitions appear. One is for the Interrupt Number (see section on Interrupt Number). The other two are for the SETUP and TERMINATE sequences. These definitions establish default screen characteristics upon entry (SETUP) into a PL/B program and upon exit (TERMINATE) from a PL/B program. The only limitations on these sequences are the terminal's ability to support the sequence and its compatibility with the screen definition file in use.

     

  6. Write Screen Definition File updates the screen definition file being modified/created with any changes that have been made. Upon selection of this option, the following prompts appear:

    7.   

    WRITE SCREEN DEFINITION FILE

      

    Enter name of Definition file: \SUNSCRN.DEF

    Are you sure you want to write the screen file? Y

      

    Screen definition file written!

      

    It first prompts for the name of the screen definition file. It is assumed that the name used is 'SUNSCRN.DEF' and that it is to be written to the root (\) directory. A null entry accepts these defaults. Otherwise, the correct name and destination can be entered.

      

    The next prompt insures the desire to write the new screen definition file and, if 'Y' is entered, then displays a message once it has been successfully written. At this point, it returns to the main menu.

     

  7. Print Screen Definition File outputs a listing of the currently defined list controls and sequences to the default system print device.

  8. Define/Write/Exit Screen Definition File defines/creates a SUNSCRN.DEF for a target system that is different than the system where TESTCRT is being executed. For example, creating a SUNSCRN.DEF for a target system with a color monitor using a system with a monochrome monitor. Upon selection of this option, the following prompts appear:

    9.  

    DEFINE/WRITE SCREEN DEFINITION FILE

     

    Enter name of definition file: \SUNSCRN.DEF

    Are you sure you want to write the screen file? Y

     

    It first prompts for the name of the screen definition file. It is assumed that the name is 'SUNSCRN.DEF' and that it is in the root (\) directory. A null entry accepts these defaults. Otherwise, the correct name and destination can be entered.

     

    The next prompt insures the desire to write the new screen definition file and, if 'Y' is entered, then displays a message once it has been successfully written. At this point, it exits TESTCRT and return to the MS-DOS prompt.

  

  

See Also: Utilities

  


System Utilities SUNSORT TXTMATCH