PAL CARD CATALOG ENTRY

SHORT DESCRIPTION

Terminal I/O by character, string, and integer


MOVEMENT WITHIN THE PAL CARD CATALOG
Move to top-level taxonomy
Move to keyword list

ASSET PROFILE

UNIT NAME
Immediate_Io_Package
VERSION
1
REVIEW CODE
C1 1.0 B
INET ADDRESS
sun1.disacim.osd.mil (134.152.9.140)
AUTHOR
U.S. Army Information System Engineering Command
Ft. Belvoir, VA 22060-5456
RIGHTS
Approved for Public Release; Distribution Unlimited
COPYRIGHT
None -- Public Domain.
DATE CREATED
February 26, 1990
DATE RELEASED
January 17, 1994
DATE LAST UPDATED
January 17, 1994
LOCATION
DSRS Library
PAL
ENVIRONMENT
DEC VAX/VMS with DEC Ada Compilation System (ACS)
LIMITATIONS
Not documented in PAL database
CERTIFICATION
Ada System Certifier_1 1.0
Date/Time of Processing: Wednesday 25 May       1994 02:20:59Pm
Overall Assessment of System: OK
Classification of System: B
Basis of Classification --
Syntax Errors                               PASS
Completeness                                PASS
Independence from External Libraries        FAIL
Independence from a Specific Ada Compiler   PASS

Explanations for failures --
System withs non-standard library units that are not provided

Number of ...
Files               2
Library Units       4
Lines            1774
Statements        167
Comments         1159

Unidentified Withed Units --
2 unidentified withed units

FILE LISTING

Directory Display


languages/ada/swcomps/dsrs/immedio:
  File Name                 Size
  ---------                 ----
  immedio.zip             22,827

languages/ada/swcomps/dsrs/vmsutil:
  File Name                 Size
  ---------                 ----
  vmsutil.zip             13,718


Totals
  ==============  ==============
    2 Files               36,545

ABSTRACT

                              Immediate_Io_Package
                                   01D001OB.1
                               (Old ID: RIB0001A)
PURPOSE/INTENDED USE:
Immediate_Io_Package is an Ada package that provides low level
subprograms to  perform immediate I/O operations which recognize each
character or digit  immediately as opposed to Text_Io, which requires a
carriage return for a  delimiter.  Currently, Text_Io in the ALS
requires an entire line before it  will process a given I/O operation.

EXAMPLE APPLICATIONS:
Immediate_Io_Package provides reusable subprograms for:
         o  Immediate Character I/O
         o  Immediate String I/O
         o  Immediate Integer I/O
         o  Immediate Output

CERTIFICATION LEVEL:
Immediate_Io_Package is certified at Level 4.  This means that the
Defense  Information Systems Agency/Center for Information Management
Software Reuse  Program (SRP) management office has successfully
compiled the code of this  Reusable Software Asset (RSA) and measured
maintainability, portability,  reliability and reusability.  In
addition, this RSA includes a test suite and a  Reuser's Manual, which
will be provided when the asset is extracted.  Note: The AdaMAT metrics
measurement score for reusability is unusually low  because of the low
proportion of variable declarations in the package body that include
initialization; the low proportion of read-only objects declared in 
library body units that are constants; the low proportion of user
defined types  used for parameters, and used in the package
specification and body; the mixing of input/output and non-input/output
statements in the same code unit; and the high proportion of constants,
types and subtypes that are visible. A check by the SRP staff revealed
the use of acceptable coding practices. 
 
IMPLEMENTATION ISSUES:
Immediate_Io_Package depends on (withs) Vms_Util_Package (01D001OJ).

Immediate_Io_Package is intended as a supplement to Text_Io.  It is not
intended to replace or duplicate the functionality of Text_Io.  It may
invalidate Text_Io's line, column, and page related functions. 

Immediate_Io_Package assigns the I/O default channels with the
Vms_Util_Package's assign subprograms which assign the input channel to
SYS$INPUT and the output channel to SYS$OUTPUT. 

HARDWARE/ENVIRONMENT CONSTRAINTS AND LIMITATIONS:
This package was compiled, linked, and tested on a DEC VAX/VMS machine
using the Ada Compilation System (ACS). 

SUBUNITS:
Vms_Util_Package has the following visible subunits, which are grouped
according to their functionality:

  Immediate Character/String/Integer I/O: 
    Get                 Gets an item immediately. Overloaded for:
                        character, string, integer (base 10, no underscores)
                        Defaults to TTY or a channel may be specified.
    Put                 Puts an item immediately. Overloaded for:
                        character, string, integer (base 10, no underscores)
                        Defaults to TTY or a channel may be specified.
    Put_Line            Same as Put and New_Line.

  Immediate Output:

    New_Line            Outputs a . Defaults to TTY or a 
                        channel may be specified.

DSRS CLASSIFICATION:
availability:  extractable
certification level:  level_4
component type:  implementation
data representation:  character
data representation:  integer
data representation:  string
environment:  mvii/vms/vaxada
function:  edit
function:  get
function:  input_output
function:  put
function:  query
language:  ada
object:  character
object:  number
object:  string
originator:  rapid
unit type:  package

LEGAL RESTRICTIONS:
This RSA contains public domain data with unlimited rights for all
users.   Extraction is permitted to all authorized library users. This
software and its documentation are provided "as is" and without any
expressed or implied warranties whatsoever.  No warranties as to
performance, merchantability, or fitness for a particular purpose exist.

The user is advised to test the software thoroughly before relying on
it.  The user must assume the entire risk and liability of using this
software.  In no event shall any person or organization of people be
held responsible for any direct, indirect, consequential or
inconsequential damages or lost profits. 

MISCELLANEOUS:
The standard for Level 4 certification has recently been upgraded. This
asset is currently undergoing modification to meet the new Level 4
requirements. 


REVISION HISTORY

January 17, 1994 Version 1 Original submission to PAL


RELEASE NOTICE

This prologue must be included in all copies of this software.
Restrictions on use or distribution:  NONE

LEGAL RESTRICTIONS:
This RSA contains public domain data with unlimited rights for all
users.   Extraction is permitted to all authorized library users. This
software and its documentation are provided "as is" and without any
expressed or implied warranties whatsoever.  No warranties as to
performance, merchantability, or fitness for a particular purpose exist.


DISCLAIMER

 This software and its documentation are provided "AS IS" and
without any expressed or implied warranties whatsoever.  No warranties
as to performance, merchantability, or fitness for a particular
purpose exist.
 The user is advised to test the software thoroughly before
relying on it.  The user must assume the entire risk and liability of
using this software.  In no event shall any person or organization of
people be held responsible for any direct, indirect, consequential or
inconsequential damages or lost profits.