GASS Operations

Thanks you very much for using MSI.


                      OPERATION 250 - SET TIME-OUT

     OPERATION 0 (OR 123) WILL WAIT FOR DATA UNTIL A FIELD DELIMITER (CARRIAGE
RETURN) FOREVER UNLESS IT IS MODIFIED BY OPERATION 250 IN SOME PREVIOUS
I-FORMAT FIELD CONTAINING THE NUMBER OF SECONDS TO WAIT BEFORE TIMING-OUT. IF
THE DELIMITER IS NOT RECEIVED BEFORE THE TIME-OUT, INPUT WILL BE TERMINATED
AND OP.251 MAY BE USED TO TEST THE STATUS OF THE TIME-OUT. THIS OPERATION WAS
WRITTEN FOR A SPECIFIC INTERFACING PROBLEM, BUT MAY BE USED FOR SECURITY
PURPOSES, ETC.

     SEE OPERATION 251 FOR AN EXAMPLE OF THE USE OF THESE TWO OPERATIONS.

                                    A-250


                        OPERATION 251 - TEST TIME-OUT

     OPERATION 251 IS USED TO PLACE THE RESULT OF THE LAST INPUT OP.0,
MODIFIED BY OP.250. IF THE OP.0 TIMED-OUT, THE OP.33 FLAG IS SET TO 1, AND IF
IT DIDN'T TIME-OUT, THE FLAG IS SET TO 0, WHEN OP.251 IS PROCESSED. THIS IS
USED TO SEE IF THE DATA RECEIVED BY THE OP.0 FIELD MAY BE VALID. IF THE FIELD
TIMED-OUT, THEN NO OR PARTIAL DATA WAS RECEIVED.


EXAMPLE:

FIELD | FORMAT | COMMENTS                         |\^| OPERATIONS
------|--------|----------------------------------|--|------------------------
   1  | I6     |                                  |  | 40 Y 18(10) Y 250 N
   2  | A78    | ENTER A78 DATA                   |  | 0 Y 103 N
   3  | I6     |                                  |  | 251 Y 143(0,5) N
   4  | A1     | YOU TIMED OUT!                   |  | 55 N
   5  | A78    |                                  |  | 62 Y 104 N

     IN THE EXAMPLE ABOVE, FIELD 1 SETS A TIME-OUT LENGTH OF 10 SECONDS FOR
THE OP.0 IN FIELD 2. FIELD 3 TESTS THE RESULT OF THE TIME-OUT AND SKIPS THE
MESSAGE IN FIELD 4 IF A TIME-OUT DID NOT OCCUR. FIELD 5 THEN VIEWS ANY DATA
OBTAINED AND STORED IN MEMORY BY FIELD 2.

                                    A-251
.PA

           OPERATION 252 - PLACE OUTPUT DEVICE PR # IN THIS I-FIELD

    OPERATION 252 PUTS THE CURRENT OUTPUT DEVICE PR NUMBER FOR THE CURRENT
DEVICE INTO THE CURRENT I-FIELD.  IT MUST BE IN AN I-FIELD AND IF PRECEEDED BY
OPERATION 62 WILL FLASH THE PR NUMBER.


EXAMPLE:

FIELD | FORMAT | COMMENTS                         |\^| OPERATIONS
------|--------|----------------------------------|--|------------------------
   1  | A1     | YOUR CURRENT PR DEVICE IS        |  | 196 Y 55 N
   2  | I4     |                                  | ^| 62 Y 252 N

    THE EXAMPLE REPORT WILL FLASH "YOUR CURRENT PR DEVICE IS    4" (IF IT IS
4) AND PLACE THAT NUMBER AS DATA IN FIELD 2.  THIS IS NOT THE SAME AS
OPERATION 173.


                                 A-252
.PA


              OPERATION 253 - PUT UNIT NUMBER IN THIS I-FIELD

    WHEN USING OPERATION 111, IT IS SOMETIMES USEFUL TO SAVE THE CURRENT UNIT
NUMBER IN ORDER TO RESTORE IT LATER. ALSO TO WRITE CODE THAT RELATIVELY
ADDRESSES UNITS IS SOMETIMES REQUIRED. OPERATION 253 DOES THIS BY BRINGING THE
UNIT INTO THE CURRENT I-FIELD.

EXAMPLE:

FIELD | FORMAT | COMMENTS                         |\^| OPERATIONS
------|--------|----------------------------------|--|------------------------
   1  | I6     |                                  |  | 40 Y 253 N
   2  | I6     |                                  |  | 18(2) Y 111 N
   3  | A72    |                                  |  | 116(1,3) Y 62 Y 102 N
   4  | I6     |                                  |  | 10(1,150) Y 111 Y 103 N
   5  | A1     | YOU ARE IN UNIT                  |  | 196 Y 55 N
   6  | I6     |                                  |  | 62 Y 104 N

     THE EXAMPLE SAVES THE CURRENT UNIT NUMBER IN FIELD 1, THEN CROSSES TO
UNIT 2 (SAME FILE) AND VIEWS WHAT IS IN ROW 3 OF TABLE 1 THERE. IT THEN
RESTORES THE PROGRAM TO THE ORIGINAL UNIT (FIELD 4) AND FLASHES THE UNIT
NUMBER.
                                    A-253
.PA

          OPERATION 254 - MOVE CURRENT FILE NUMBER INTO THIS I-FIELD

    WHEN USING OPERATION 112, IT IS SOMETIMES USEFUL TO SAVE THE CURRENT FILE
NUMBER IN ORDER TO RESTORE IT LATER. ALSO TO WRITE CODE THAT RELATIVELY
ADDRESSES FILES IS SOMETIMES REQUIRED. OPERATION 253 DOES THIS BY BRINGING THE
FILE NUMBER INTO THE CURRENT I-FIELD.

EXAMPLE:

FIELD | FORMAT | COMMENTS                         |\^| OPERATIONS
------|--------|----------------------------------|--|------------------------
   1  | I6     |                                  |  | 40 Y 254 N
   2  | I6     |                                  |  | 18(2) Y 112 N
   3  | A72    |                                  |  | 116(1,3) Y 62 Y 102 N
   4  | I6     |                                  |  | 10(1,150) Y 112 Y 103 N
   5  | A1     | YOU ARE IN FILE                  |  | 196 Y 55 N
   6  | I6     |                                  |  | 62 Y 104 N

     THE EXAMPLE SAVES THE CURRENT FILE NUMBER IN FIELD 1, THEN CROSSES TO
FILE 2 (SAME UNIT) AND VIEWS WHAT IS IN ROW 3 OF TABLE 1 THERE. IT THEN
RESTORES THE PROGRAM TO THE ORIGINAL FILE (FIELD 4) AND FLASHES THE FILE
NUMBER.

                                    A-254
.PA

                         OPERATION 255 - NO OPERATION

    OPERATION 255 MAY BE USED ANYWHERE IN ANY OPERATION FIELD. IT DOES
NOTHING.

                                    A-255
.PA

                   OPERATION 256 - PUT MEMORY IN I/O BUFFER

     OPERATION 256 WAS WRITTEN TO ALLOW SUBROUTINES CALLED WITH OP.35 TO
RETURN DATA FROM A LOWER LEVEL. BEFORE OP.256, ALL RETURNS OF DATA FROM A
LOWER LEVEL REQUIRED THE USE OF SOME GLOBAL SYSTEM RESOURCE, SUCH AS TABLES OR
SYSTEM MEMORY. THIS CREATED A PROBLEM IN WRITING MULTI-USER SYSTEMS, BECAUSE
PROTECTION SCHEMES HAD TO BE DEVISED BY THE PROGRAMMER.

     OPERATION 256 PLACES THE FIRST 134 BYTES OF MEMORY INTO THE I/O BUFFER
FOR THE DEVICE. THIS BUFFER IS NOT MODIFIED ON RETURN FROM A LOWER LEVEL, AND
MAY BE RETREIVED BY THE USE OF OPERATION 257.

EXAMPLE:                                          256

FIELD | FORMAT | COMMENTS                         |\^| OPERATIONS
------|--------|----------------------------------|--|------------------------
   1  |  I6    | GET VALUE FROM ABOVE             |  | 40 Y 104 N
   2  |  I6    | ADD 64 FOR TRANSLATION           |  | 18(64) Y 10(1,2) Y 103
                                                       Y 256 N

     THE ABOVE EXAMPLE RUNS AT THE LOWER LEVEL TO TRANSLATE THE I-VALUES
PASSED TO IT IN MEMORY TO LETTERS OF THE ALPHABET BY ADDING 64. THE RESULTS
ARE PLACED IN THE I/O BUFFER FOR RETURN BY THE LAST OPERATION IN THE REPORT.
SEE THE NEXT PAGE FOR DETAILS OF THE CALLING REPORT.



                                    A-256
.PA

                   OPERATION 257 - PUT I/O BUFFER IN MEMORY

     OPERATION 257 IS THE COMPLEMENT OF OPERATION 256, IN THAT IT GETS THE
DATA FROM THE DEVICE'S I/O BUFFER AND PLACES IT IN THE CURRENT LEVEL'S MEMORY.
THIS EFFECTIVELY DEFEATS THE RESTORATION OF MEMORY ON RETURN, AT LEAST FOR THE
FIRST 134 BYTES.

EXAMPLE:                                          257

FIELD | FORMAT | COMMENTS                         |\^| OPERATIONS
------|--------|----------------------------------|--|------------------------
   1  |  I6    | FOR INCREMENT                    |  | 40 Y 18(1) N
   2  |  I6    | LIMIT                            |  | 18(10) N
   3  |  I6    | COUNT & PASS TO TRANSLATOR       |  | 10(1,3) Y 103 Y 89 Y
                                                       35(6,256) N
   4  |  A1    | VIEW MEMORY AFTER                |  | 257 Y 62 Y 104 N
   5  |  I6    | LOOP TEST                        |  | 12(2,3)Y 33 Y 143(4,3)N


     THE EXAMPLE GIVEN WORKS WITH THE PRECEEDING EXAMPLE TO IMPLEMENT A
TRIVIAL CHARACTER-TRANSLATION SUBROUTINE. I-VALUES FROM 1 TO 10 ARE GENERATED
BY "257" AND PASSED TO "256", WHICH ADDS 64 TO THE VALUE AND PASSES THE ANSWER
BACK USING THE I/O BUFFER. FIELD 4 OF "257" VIEWS ITS MEMORY AFTER OPERATION
257 IS PROCESSED, TO SHOW THE VALUE RETURNED BY IT.


                                    A-257
.PA

              OPERATION 258 - VIEW D-DATA WITH COMMAS, A AS HEX

     OPERATION 258 WORKS LIKE OPERATION 62 TO VIEW DATA ENTERING A FIELD, BUT
IN ADDITION IT CAUSES COMMAS TO BE INSERTED INTO THE STRING REPRESENTATION OF
THE NUMBER BEFORE IT IS VIEWED. THIS IS USED FOR GEN-SIDE REPORTS WHICH DEAL
WITH NUMERICAL (PRIMARILY DOLLAR) VALUES. THE USER IS CAUTIONED TO USE FORMAT
WIDTHS WHICH ALLOW ROOM FOR THE COMMAS, OR ELSE THE LEADING (MOST SIGNIFICANT)
DIGITS OF THE STRING MAY BE LOST DUE TO TRUNCATION.

    IN AN A-TYPE FIELD, OPERATION 258 VIEWS THE FIELD AS ITS HEXIDECIMAL
EQUIVALENT.

EXAMPLE:                                          258

FIELD | FORMAT | COMMENTS                         |\^| OPERATIONS
------|--------|----------------------------------|--|------------------------
   1  |  D10.2 | GET VALUE FROM TABLE             |  | 40 Y 116(9,2) Y 94 N
   2  |  D12.2 | MULTIPLY BY CONSTANT             |  | 19(50.00) Y 15(1,2) Y
                 AND PUT IN MEMORY                |  | 103 N
   3  |  D16.2 | VIEW DATA WITH COMMAS            |  | 258 Y 104 N

     IN THE EXAMPLE, FIELD 1 GETS A VALUE FROM A TABLE, WHICH IS MULTIPLIED BY
50 IN FIELD 2. THE RESULT IS PLACED IN MEMORY, TO BE VIEWED BACK WITH COMMAS
INSERTED BY FIELD 3.


                                    A-258
.PA

              OPERATION 259 - VIEW MEMORY TO OP 83 DATA POSITION

    OPERATION 258 IS FORMAT INDEPENDENT AND VIEWS WHAT IS IN MEMORY FROM DATA
POINT 1 TO THE DATA POINT CONTAINED BY THE OPERATION 83 REGISTER.

EXAMPLE:

FIELD | FORMAT | COMMENTS                         |\^| OPERATIONS
------|--------|----------------------------------|--|------------------------
   1  |  A78   |  DATA TO MEMORY                  |  | 0 Y 103 N
   2  |  I6    |  NUMBER TO VIEW                  |  | 0 Y 83  Y 259 N

    WHEN THE DATA IS ENTERED INTO FIELD 1, IT IS PLACED IN MEMORY FROM D.P.1
TO D.P.78. FIELD 2 WILL PUT THE # I/P INTO THE 83-REGISTER AND VIEW THAT
NUMBER OF CHARACTERS FROM MEMORY.



                                    A-259
.PA

        OPERATION 260 - PUT THE NUMBER OF BYTES I/P INTO FIXED PT REG

    THERE ARE OCCASIONS WHEN THERE IS A NEED TO KNOW HOW MANY CHARACTERS HAVE
BEEN READ-IN USING OPERATION 0 OR 123.  ON COMPUTER TO COMPUTER LINKS, A FIELD
MAY BE FORMATTED AS AN A134 AND WE MUST KNOW THE NUMBER OF CHARACTERS THAT
HAVE BEEN READ IN PRIOR TO THE CARRIAGE RETURN (OR SOME DELIMITER) IN ORDER TO
PEFORM A PARTICULAR PROCESS. WE USE OPERATION 260 AFTER THE I/P OPERATION TO
RETRIEVE THIS VALUE.

EXAMPLE:

FIELD | FORMAT | COMMENTS                         |\^| OPERATIONS
------|--------|----------------------------------|--|------------------------
   1  | A134   |  ENTER UP TO 134 CHARACTERS      |  | 0 N
   2  | I6     |   CHARCTERS WERE READ            |  | 260 Y 103 Y 196 Y 62 Y
      |        |                                  |  | 104 Y 55 N

    IN THE EXAMPLE, WHEN A STRING IS ENTERED, THE NUMBER OF CHARACTERS THAT IS
INPUT WILL APPEAR FOLLOWED BY "CHARACTERS WERE READ."

    OPERATION 260 WORKS WITH ALL FORMATS.


                                    A-260
.PA

                 OPERATION 261 - DISABLE TABLE ERROR MESSAGES

    UNDER NORMAL CIRCUMSTANCES, THE SYSTEM WILL GIVE A WARNING MESSAGE IF IT
IS UNABLE TO ACCESS A TABLE DURING PROCESSING. THIS HAS CAUSED PROBLEMS TO
SOME OLDER APPLICATIONS, SO OPERATION 261 HAS BEEN ADDED TO DISABLE THESE
ERROR MESSAGES SHOULD THAT BE REQUIRED. IT MAY BE PLACED IN ANY FIELD.





OPSRT - 10/16/89

                                    A-261
.PA

                OPERATION 262 - RE-ENABLE TABLE ERROR MESSAGES

    IF TABLE ERROR MESSAGES HAVE BEEN DISABLED BY THE USE OF O.261, THEY MAY
BE RE-ENABLED BY OPERATION 262, WHICH MAY BE PLACED IN ANY FIELD.




OPSRT - 10/16/89

                                    A-262
.PA

          OPERATION 263 - VIEW DATA IN THIS FIELD WITH FORMS CONTROL

    OPERATION 263 CAUSES THE DATA IN THE FIELD TO BE VIEWED AT GEN-TIME,
ACCORDING TO THE FORMAT OF THE FIELD AND THE ^ OR \ FORMS CONTROL CHARACTER.
THIS MAY BE USED IN ANY FORMAT FIELD, AND IN NUMBER FIELDS WILL VIEW THE
CONTENTS OF THE FIELD'S FIXED OR FLOATING-POINT REGISTER, AS APPROPRIATE.


EXAMPLE:                                          263

FIELD | FORMAT | COMMENTS                         |\^| OPERATIONS
------|--------|----------------------------------|--|------------------------
   1  | A134   |  ENTER UP TO 134 CHARACTERS      |  | 0 N
   2  | I6     |   CHARCTERS WERE READ            |  | 260 Y 263 Y 55 N


    THE ABOVE EXAMPLE IS A MODIFICATION OF THE EXAMPLE FOR OPERATION 260,
WHICH MAY BE REFERRED TO FOR COMPARISON. THE TWO EXAMPLES DO EXACTLY THE SAME
THING WHEN PROCESSED. NOTE THAT FOUR OPERATIONS HAVE BEEN REPLACED WITH ONE.
THIS SPEEDS PROCESSING, AND MAKES THE PROGRAMMER'S JOB EASIER.


OP183 - 10/16/89

                                    A-263
.PA

        OPERATION 264 - REPLACE SPACES IN THIS FIELD WITH LAST I-VALUE

        OPERATION 264 MUST BE IN AN A-FIELD AND SEARCHES THE FIELD FOR SPACES
AND RPLACES THEM WITH THE INTEGER PROCESSED IN THE LAST I-FIELD.

EXAMPLE:                                          264

FIELD | FORMAT | COMMENTS                         |\^| OPERATIONS
------|--------|----------------------------------|--|------------------------
   1  | I6     |  ENTER THE REPACEMENT CHAR       | ^| 196 Y 0 N
   2  | A78    |  ENTER UP TO 134 CHARACTERS      | ^| 0 Y 264 Y 103 N
   3  | A78    |                                  | ^| 62 Y 104 N

        THE EXAMPLE REQUIRES AN INTEGER TO BE ENTERED INTO FIELD 1 AND AN
ASCII STRING TO BE INPUT INTO FIELD 2 WHERE THAT STRING HAS ALL SPACES CHANGED
TO THE CHARACTER REPRESENTED BY THE DECIMAL VALUE INTERED INTO FIELD 1. FIELD
3 BRINGS THE EDITED STRING IN FROM MEMORY AND FLASHED IT.

OP183, DOSSB - 05-09-90

                                    A-264
.PA

        OPERATION 265 - UPDATE GASS DATE/TIME FROM MEMORY

        OPERATION 265 WILL TAKE THE FIRST 14 DATA POSITIONS OF MEMORY TO UPDATE
THE GASS DATE/TIME. MEMORY MUST BE SET UP AS FOLLOWS:
         11111   (DATA
12345678901234    POSITIONS)
MM-DD-YY HH:MM              (IMPORTANT NOTE: HH MUST BE 24 HOUR TIME)

        THIS CONFORMS TO MEMORY SET UP BY OPERATION 226 WHEN MEMORY WILL
CONTAIN THE DOS DATE/TIME.


EXAMPLE:                                              265

FIELD | FORMAT | COMMENTS                         |\^| OPERATIONS
------|--------|----------------------------------|--|------------------------
   1  |  A1    |                                  |  |  40 Y 226 Y 265 N

        THE EXAMPLE SETS THE GASS DATE/TIME FROM THE DOS DATE/TIME

OP183, 6-26-90

                                    A-265
.PA

        OPERATION 266 - TAKE VALUE IN THIS I-FIELD TO CHANGE SPACE TO CR

        OPERATION 266 USES THE VALUE IN THE CURRENT I-FIELD AS THE UPPER LIMIT
OF THE NUMBER OF CHARACTERS TO ALLOW TO BE INPUT BEFORE A SPACE IS CHANGED TO
A CARRIAGE RETURN.  THIS ALLOWS FOR A POSSIBLE WORD WRAP CAPIBILTY USING
OPERATION 0.

        IF A NEGATIVE VALUE IS PARAMETRIC TO OPERATION 266, THEN ON
INPUT INTO SUBSEQUENT FIELDS,THE DATA WILL BE RETURNED WHEN THE SPECIFIED
ABSOLUTE NUMBER OF CHARACTERS HAVE BEEN ENTERED.




EXAMPLE:                                              266

FIELD | FORMAT | COMMENTS                         |\^| OPERATIONS
------|--------|----------------------------------|--|------------------------
   1  |  I2    |                                  |^ |  18(60) Y 266 N
   2  |  A78   | ENTER 78 CHARACTERS OF DATA      |^ |  0 Y 267 N
   3  |  I2    |                                  |^ |  18(-1) Y 266 N
   4  |  I1    | ENTER 1 INTEGER; NO ENTER KEY!   |^ |  0 Y 267 N

        THIS EXAMPLE WILL ALLOW NORMAL INPUT INTO FIELD 2 EXCEPT AFTER 60
CHARCTERS HAVE BEEN INPUT, A SPACE OR CR WILL BE TAKEN AS A CR.

        IN FIELD 3, THE NEGATIVE VALUE OF 266 WILL CAUSE ONLY 1 CHARACTER
TO BE INPUT INTO FIELD 4 WHEREUPON DATA WILL BE RETURNED AUTOMATICALLY.

11-2-90 (MODIFIED 2-1-91 FOR NEGATIVE VALUE AS A SPECIAL PARAMETER)

                                    A-266
.PA

        OPERATION 267 - DISABLE OPERATION 266

        OPERATION 267 CLEARS THE VALUE/FLAG OP266 BYTE IN THE I/O TABLE FOR
THE CURRENT DEVICE. SEE EXAMPLE 266.

11-2-90
                                    A-267
.PA

       OPERATION 268 - ALLOW DEVICE MEMORY TO BE NON DESTRUCTIVE ON CALLS

       OPERATIONS SUCH AS 35, WHICH IS A SUBROUTINE CALL, RECEIVES DEVICE
MEMORY (THAT WAS SET UP BY SOME OPERATION SUCH AS 103 OR 105) AS IT WAS IN THE
CALLING REPORT. HOWEVER WHEN THE RETURN TO THE CALLING REPORT IS MADE, MEMORY
IS STILL THE SAME AS BEFORE THE CALL. OPERATION 268 REVERSES THIS SITUATION AND
ALLOWS DEVICE MEMORY TO BE GLOBAL TO THE DEVICE ON RETURNS FROM CALLS SUCH  AS
OPERATIONS 35, 37,52,120 AND 121.
EXAMPLE:                                              268

FIELD | FORMAT | COMMENTS                         |\^| OPERATIONS
------|--------|----------------------------------|--|------------------------
   1  |  I6    |                                  |^ |  40 Y 18(60) Y 103 N
   2  |  A78   | ENTER 78 CHARACTERS OF DATA      |^ |  0 Y 105(3,78)
   3  |  A6    |                                  |^ |  268 Y 35(6,268A)N
   4  |  A84   |                                  |^ |  62 Y 104 Y 269 N

                                                       268A

FIELD | FORMAT | COMMENTS                         |\^| OPERATIONS
------|--------|----------------------------------|--|------------------------
   1  |  I2    |                                  |^ |  40 Y 18(25) Y 103 N
   2  |  A78   | ENTER 78 CHARACTERS OF DATA      |^ |  0 Y 105(3,78)

     IN THE EXAMPLE, DATA ENTER IN 268A WILL FLASH IN 268, FIELD 4.


05-21-91

                                     A-268

          OPERATION 269 - DISABLE OPERATION 268

       OPERATION 268 WILL REMAIN IN EFFECT FOREVER UNLESS SOME REPORT ISSUES
OPERATION 269.  (SEE OPERATION 268 FOR AN EXAMPLE).

5-21-91

                                     A-269

          OPERATION 270 - COPY A REPORT FORMAT

        OPERATION 270 USES THE UNIT CALLED OUT BY THE LAST OPERATION 111
AND FILE SPECIFIED BY THE LAST OPERATION AS A SOURCE FILE TO COPY A REPORT
SPECIFIED BY THE LAST OPERATION 72 INTO THE CURRENT FILE.  NOTE: REMOVE THE
REPORT BEFORE DOING THE COPY OR THE REPORT MAY APPEAR TWO TIMES IN THE
FILE.



EXAMPLE:

FIELD | FORMAT | COMMENTS                         |\^| OPERATIONS
------|--------|----------------------------------|--|------------------------
   1  |  I6    | UNIT #                           |  |  18(0) Y 111 N
   2  |  I6    | FILE #                           |  |  18(1) Y 112 N
   3  |  A6    | MENU                             |  |  92(MENU) Y 65 Y
      |        |                                  |  |  72 Y 270 N

        IN THE EXAMPLE, FIELDS 1 AND 2 CALL OUT UNIT 0, FILE 1 AS THE
SOURCE FILE FROM WHICH TO COPY A REPORT CALLED MENU. FIELD 3 REMOVES THE
REPORT IN CASE IT ALREADY EXISTS IN THE CURRENT FILE AND COPIES THE REPORT
FORMAT INTO THE CURRENT FILE.

6-5-92

                                   A-270

        OPERATION 271 - MAP TABLES TO ANOTHER FILE

        OPERATION 271 MAPS SETS OF TABLES FROM ONE FILE TO ANOTHER FILE.
AFTER A MAPPING HAS BEEN ESTABLISHED, A REFERENCE TO ANY TABLE WITHIN A SET
WILL REFERENCE THE SAME TABLE IN THE TARGET UNIT AND FILE; TABLES WITHIN
THE SOURCE FILE WILL BE LOST.  THE MAPPING WILL BE LOST WHEN THE SYSTEM IS
LOADED AND THE TABLES IN THE SOURCE FILE WILL BE REBORN.  OPERATION 271
USES THE FOLLOWING REGISTERS:

        OPERATION 38 REGISTER - TARGET UNIT
        OPERATION 51 REGISTER - TARGET FILE
        OPERATION 81 REGISTER - BEGINNING TABLE NUMBER
        OPERATION 83 REGISTER - ENDING TABLE NUMBER
        * THE CURRENT UNIT AND FILE WILL BE THE SOURCE FILE *
        * THERE MAY BE 32 SETS OF MAPPINGS PER SYSTEM LOAD  *


EXAMPLE:

FIELD | FORMAT | COMMENTS                         |\^| OPERATIONS
------|--------|----------------------------------|--|------------------------
   1  | I6     | TARGET UNIT                      |  | 40 Y 18(0) Y 38 N
   2  | I6     | TARGET FILE                      |  | 18(1) Y 51 N
   3  | I6     | BEGINNING TABLE #                |  | 18(100) Y 81 N
   4  | I6     | ENDINING TABLE #                 |  | 18(200) Y 83 Y 271 N

        THE EXAMPLE REPORT WILL MAP TABLES 100 TO 200 IN THE CURRENT FILE
TO THE SAME TABLES IN UNIT 0 FILE 1.

6-18-92

                                   A-271

        OPERATION 272 - DISABLE CONSOLE TELEVIDEO MODE (VGA OR ANSI MODE)

GASS MAKES THE PC CONSOLE CONFORM TO THE TELEVIDEO 912 SPECIFICATIONS UNTIL
OPERATION 272 IS ENCOUNTERED IN SOME REPORT.  WHEN THIS HAPPENS THE DATA IS
TRANSMITTED TO THE CONSOLE VIEO VIA INTERRUPT 10 (HEX) SO IF THE DEVICE
DRIVER FOR ANSI (ANSI.SYS CALLED AS A DEVICE DRIVER IN THE CONFIG.SYS FILE)
THE ESC SEQUENCES FOR ANSI VGA WILL BE AVAILABLE.  THIS WILL ALLOW FOR
SCREEN FORMATTING VGA MONITORS UNDER THE SPECIFICATIONS OF ANSI.


FIELD | FORMAT | COMMENTS                         |\^| OPERATIONS
------|--------|----------------------------------|--|------------------------
   1  |  A1    |                                  |  |  272  N

        THE EXAMPLE REPORT CAN BE EXECUTED FROM ANY DEVICE IN THE SYSTEM.

6-29-92

                                   A-272

        OPERATION 273 - DISABLE OPERATION 272

TO TAKE THE CONSOLE BACK TO TELEVIDEO MODE, EXECUTE ANY REPORT CONTAINING
OPERATION 273.

FIELD | FORMAT | COMMENTS                         |\^| OPERATIONS
------|--------|----------------------------------|--|------------------------
   1  |  A1    |                                  |  |  273 N

                                   A-273
.PA
       OPERATION 274 - REBOOT THE PC

ARE YOU CONFUSED? TIRED OF GASS? RUN OP.274 AND SEE WHAT HAPPENS....

                                  A-274
.PA
        OPERATION 275 - CLOSE THE CURRENT FILE IF IT IS DOS

ALL FILES LOCATED ON DRIVES CALLED OUT AS NEGATIVE FALL INTO \GASS SUB
DIRECTORIES ON DRIVES A: THROUGH F:, WHERE:

A: = UNIT -1
B: =  "   -2
C: =  "   -3
D: =  "   -4
E: =  "   -5
F: =  "   -6

AND CAN BE CODED USING OPERATION 111. THE FILES IN THESE UNITS ARE NUMBERED
FROM 1 TO 4, AND ARE OPENED AS HANDLES, BUT MUST BE CLEARED AT EDITOR
SYSTEM IDLE (52) USING COMMAND CODE 2 AND $# AS THE SECRET CODE. ANYTIME
DATA IS WRITTEN INTO A FILE IT MAY NOT BE STORED UNTIL THE FILE IS CLOSED
SO OPERATION 275 SHOULD BE CODED AT INTERVALS SO THAT DATA MAY NOT BE LOST
IN CASE THE SYSTEM GOES DOWN.A FILE MAY ALSO BE CLOSED AT FILE IDLE (52) BY
ISSUING COMMAND CODE 9.  ALL FILES ARE CLOSED AT SYSTEM IDLE (52) BY
ISSUING COMMAND CODE 8.

FIELD | FORMAT | COMMENTS                         |\^| OPERATIONS
------|--------|----------------------------------|--|------------------------
   1  |  A1    |                                  |  |  275 N


        OPERATION 276 - CLOSE ALL DOS FILES

OPERATION 276 NOT ONLY CLOSES THE CURRENT FILE BUT ALSO CLOSES ALL FILES.
HOWEVER IT SHOULD BE NOTED THAT ANY ENTRANCE TO A FILE BY SOME PROCESS OR
ANY ACTIVITY BY A PROCESS THAT IS ALREADY IN A FILE WILL OPEN THE FILE FOR
BOTH A READ AND A WRITE.

FIELD | FORMAT | COMMENTS                         |\^| OPERATIONS
------|--------|----------------------------------|--|------------------------
   1  |  A1    |                                  |  |  276 N


        OPERATION 277 - CLOSE ALL FILES AND EXIT TO DOS

        THIS OPERATION EXITS TO DOS AND ALL PROCESSES ARE TERMINATED.  THIS
OPERATION MAY CAUSE A LOT OF PROBLEMS IF SOME PROCESS IS NOT READY TO
TERMINATE. PROGRAMMERS BEWARE!!

FIELD | FORMAT | COMMENTS                         |\^| OPERATIONS
------|--------|----------------------------------|--|------------------------
   1  |  A1    |                                  |  |  277 N

 NOTE: COMMAND CODE -99 AT SYSTEM IDLE (52) CLOSES ALL FILES AND EXITS TO
DOS.

        OPERATION 278 - RESERVED

        OPERATION 279 - VIEW n SPACES WHERE n = THIS FIELD'S FIXED POINT
                        VALUE.

FIELD | FORMAT | COMMENTS                         |\^| OPERATIONS
------|--------|----------------------------------|--|------------------------
   1  |  I6    |                                  |  |  40 Y 18(10) Y 279 N

THE ABOVE REPORT VIEWS 10 SPACES. OPERATION 279 CAN BE USED TO POSITION THE
CURSOR AS WELL AS THE PRINT HEAD.

        OPERATION 280 - VIEW n CHAR'S FROM MEMORY STARTING AT D.P. 1
                        WHERE n = THIS FIELD'S FIXED POINT VALUE.


        THIS OPERATION IS HELPFUL (ALONG WITH OP 279, 281 AND OTHERS) IN
FILLING OUT FORMS, SCREEN FORMATTING, ETC.

FIELD | FORMAT | COMMENTS                         |\^| OPERATIONS
------|--------|----------------------------------|--|------------------------
   1  |  A20   |                                  |  |  40 Y 116(50,1) Y
      |        |                                  |  |  102 Y 103 N
   2  |  I6    |                                  |  |  18(10) Y 279 N

THIS REPORT VIEWS THE FIRST 10 CHARACTERS OF TABLE 50, ROW 1.

        OPERATION 281 - VIEW MEMORY FROM D.P. 1 UNTIL A SPACE IS
                        ENCOUNTERED.

FIELD | FORMAT | COMMENTS                         |\^| OPERATIONS
------|--------|----------------------------------|--|------------------------
   1  |  A20   |                                  |  |  40 Y 281

THE ABOVE REPORT VIEWS ALL CHARACTERS IN MEMORY STARTING AT D.P. 1 AND
GOING UNTIL A SPACE IS ENCOUNTERED OR 80 CHARACTERS HAVE BEEN VIEWED.

        OPERATION 282 - LOAD THIS FIELD'S FIXED POINT REGISTER INTO THIS
PR'S XPOS REGISTER.

  THE XPOS REGISTERS AND THE YPOS REGISTERS ARE PARAMETRIC TO OPERATION
284.  WHEN OPERATION 282 IS ENCOUNTERED BY THE SYSTEM, THE VALUE IN THIS
FIELD'S FIXED POINT REGISTER IS LOADED INTO THIS PR'S XPOS REGISTER.

FIELD | FORMAT | COMMENTS                         |\^| OPERATIONS
------|--------|----------------------------------|--|------------------------
   1  |  I6    | X COORDINATE                     |  | 40 Y 196 Y 0 Y 282 N

THIS REPORT LOADS THE VALUE ENTERED BY THE OPERATOR INTO THE XPOS REG.

       OPERATION 283 - LOAD THIS FIELD'S FIXED POINT REGISTER INTO THIS
PR'S YPOS REGISTER.

  THE XPOS REGISTERS AND THE YPOS REGISTERS ARE PARAMETRIC TO OPERATION
284.  WHEN OPERATION 283 IS ENCOUNTERED BY THE SYSTEM, THE VALUE IN THIS
FIELD'S FIXED POINT REGISTER IS LOADED INTO THIS PR'S YPOS REGISTER.

FIELD | FORMAT | COMMENTS                         |\^| OPERATIONS
------|--------|----------------------------------|--|------------------------
   1  |  I6    | Y COORDINATE                     |  | 40 Y 196 Y 0 Y 283 N

THIS REPORT LOADS THE VALUE ENTERED BY THE OPERATOR INTO THE YPOS REG.

       OPERATION 284 - POSITION THE CURSOR ON THIS DEVICE'S SCREEN AT THE X
COORDINATE SPECIFIED BY THE VALUE IN THE XPOS REG AND THE Y COORDINATE
SPECIFIED BY THE YPOS REG. IF EITHER OF THE VALUES ARE LESS THAN OR EQUAL
TO ZERO, OR IF THE XPOS REG IS GREATER THAN 80, OR THE YPOS REG IS GREATER
THAN 25, OPERATION 284 ACTS AS A NOP.


FIELD | FORMAT | COMMENTS                         |\^| OPERATIONS
------|--------|----------------------------------|--|------------------------
   1  |  I6    | Y COORDINATE                     |  | 40 Y 196 Y 0 Y 283 N
   2  |  I6    | X COORDINATE                     |  | 196 Y 0 Y 282 Y 284

THIS REPORT LOADS VALUES ENTERED BY THE OPERATOR INTO THE YPOS REG AND
THE XPOS REG AND POSITIONS THE CURSOR THERE.

        OPERATION 285 - LOAD THE XPOS REGISTER INTO THIS FIELD'S FIXED
POINT REGISTER.

FIELD | FORMAT | COMMENTS                         |\^| OPERATIONS
------|--------|----------------------------------|--|------------------------
   1  |  I6    | X-COORDINATE =                   |  | 40 Y 196 Y 55 Y 285
      |        |                                  |  | Y 263 N

THIS REPORT WILL VIEW THE XPOS VALUE.

        OPERATION 286 - LOAD THE YPOS REGISTER INTO THIS FIELD'S FIXED
POINT REGISTER.

FIELD | FORMAT | COMMENTS                         |\^| OPERATIONS
------|--------|----------------------------------|--|------------------------
   1  |  I6    | Y-COORDINATE =                   |  | 40 Y 196 Y 55 Y 286
      |        |                                  |  | Y 263 N

THIS REPORT WILL VIEW THE YPOS VALUE.

        OPERATION 287 - CLEAR FROM THE CURRENT CURSOR POSITION TO THE END
OF THE CURRENT LINE.

OPERATION 287 TRANSMITS AN ESCAPE CHARACTER FOLLOWED BY T, WHICH CAUSES THE
THE LINE TO BE CLEARED FROM ITS CURRENT POSITION TO THE END OF THE LINE.

FIELD | FORMAT | COMMENTS                         |\^| OPERATIONS
------|--------|----------------------------------|--|------------------------
   1  |  I6    | ^Z123456789012345678921234567893 |  | 40 Y 196 Y 55 Y
      |        |  1234567894123456789512345678961 |  | 18(1) Y 283 Y 10(
      |        |  23456789712345678               |  | -1,30) Y 282 Y 284 Y
      |        |                                  |  | 287 N

THIS REPORT CLEARS THE SCREEN, VIEWS THE COMMENT AND THEN CLEARS THE LINE
FROM XPOS 31, YPOS 1 TO THE END OF THE LINE.

        OPERATION 288 - CLEAR FROM THE CURRENT CURSOR POSITION TO THE END
OF THE PAGE.

OPERATION 288 TRANSMITS AN ESCAPE CHARACTER FOLLOWED BY Y, WHICH CAUSES THE
THE SCREEN TO BE CLEARED FROM ITS CURRENT POSITION TO THE END OF THE
SCREEN.

FIELD | FORMAT | COMMENTS                         |\^| OPERATIONS
------|--------|----------------------------------|--|------------------------
   1  |  I6    |   123456789012345678921234567893 |  | 40 Y 55 Y
      |        |  1234567894123456789512345678961 |  | 18(25) N
      |        |  23456789712345678               |  |
   2  |  I6    |                                  |  | 10(-1,1) N
   3  |  I6    |                                  |  | 12(1,2) Y 33 Y
      |        |                                  |  | 143(4,1) N
   4  |  I6    | X COORDINATE                     |  | 196 Y 0 Y 182 N
   5  |  I6    | Y COORDINATE                     |  | 196 Y 0 Y 283 Y 284
      |        |                                  |  | Y 288 N
THIS REPORT PAINTS THE SCREEN, POSITIONS THE CURSOR AT THE COORDINATES
SPECIFIED BY THE OPERATOR AND CLEARS FROM THAT POSITION TO THE END OF HTE
SCREEN.
ROM XPOS 31, YPOS 1 TO THE END OF THE LINE.
Gass Index
Hosted by www.Geocities.ws

 1