A
  
                             - Page 1 -
  
  
  
   -------------------------------------------------------------------
   | README file for ADAM V12.0A                                     |
   |                                        Edition: 01.07.1996      |
   -------------------------------------------------------------------
  
  
  
  
     This README file describes the amendments and extensions valid
     for ADAM Version 12.0.
  
     These amendments and extensions refer to the manual
  
     ADAM V11.2A
     Edition July 1995
     Order number: U3563-J-Z125-5-7600
  
     References to chapters and sections in this README file refer to
     the README file itself. References to the above manual are
     explicitly marked as such.
  
  
  
     Contents
     -------- 
  
  
     1 FDEFIO macro .......................................... Page 2
     1.1 New operand: ATTR ................................... Page 2
     1.2 Device job of the type Search-TIC ................... Page 3
  
     2 SERSLOG entries for system errors ..................... Page 3
  
     3 Compatibility ......................................... Page 3
  
A
  
                             - Page 2 -
  
     1 FDEFIO macro
  
  
     1.1 New operand: ATTR
  
         The ATTR operand serves to describe instruction attributes.
         A detailed description of the FDEFIO macro can be found on 
         page 38ff of the "ADAM V11.2A" manual. Only the new ATTR
         operand is described in this README file.
  
  
  
        +------------+-------------------------------------------------+
        | Operation  | Operands                                        |
        +------------+-------------------------------------------------+
        | FDEFIO     | MF = C / D / L / M                              |
        |            |                                                 |
        |            | ,CMD = <integer 1..255> / <var: int:1> /        |
        |            |        (<reg: int:1>)                           |
        |            |                                                 |
        |            | ,DATA = <var: pointer> / (<reg: pointer>)       |
        |            |                                                 |
        |            | ,LENGTH = <integer 0..65535> / <var: int:2> /   |
        |            |           (<reg: int:2>)                        |
        |            |                                                 |
        |            | ,FLAG = list-poss(3): *SLI / *SKIP / *DC        |
        |            |                                                 |
        |            | ,CHAIN = *NO / <var: pointer> / (<reg: pointer>)|
        |            |          ___                                    |
        |            |                                                 |
        |            | ,ATTR = *NO / *RESERVE / *RELEASE               |
        |            |         ___                                     |
        |            |                                                 |
        +------------+-------------------------------------------------+
  
  
         Description of the new operand
  
         ATTR=
         This operand enables the user to specify a specific instruction
         attribute of the ADAM instruction code. In the device module 
         there is a permission bit for each instruction attribute. If 
         this bit is not set, the device job is rejected with the
         appropriate return code. This operand may only be specified
         for particular devices.
           
         *NO
         The ADAM instruction code is specified without an instruction
         attribute. 
  
         *RESERVE
         The input/output operation specified by the ADAM instruction
         code is a DEVICE-RESERVE operation.
  
         *RELEASE
         The input/output operation specified by the ADAM instruction
         code is a DEVICE-RELEASE operation.
  
A
  
                             - Page 3 -
  
     1.2    Device job of the type Search-TIC
  
            If the Search-TIC permission bit is set in the device
            module, it is possible to specify a TIC device job with
            the aid of the FDEFIO macro.
            Prior to V12.0 any attempt to do this was rejected with
            the appropriate return code.
            This TIC device job is defined not only by the TIC instruction
            code but also by the fact that DATA contains the address of
            the previous device job.
  
  
  
     2 SERSLOG entries for system errors
  
         If calling a system interface from ADAM leads to an error
         and the return code indicates that the subordinate function 
         has not already written a SERSLOG entry, ADAM causes a
         SERSLOG entry to be generated. This makes it easier to
         diagnose system errors. 
  
  
  
     3 Compatibility
  
         To ensure the source code compatibility of existing
         programs so that their assembly is still possible, the 
         old Assembler interfaces remain available under their
         old names and with their old functionality. However, they
         will not be further developed.
           
         The old ADAM Assembler interfaces remain object-compatible
         in order to ensure that application software that has
         already been assembled can still be run without any loss
         in functionality.