PAL CARD CATALOG ENTRY

SHORT DESCRIPTION

Manipulate EBCDIC; conversion to ASCII


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

ASSET PROFILE

UNIT NAME
Ebcdic
VERSION
1
REVIEW CODE
C1 1.0 A
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
June 5, 1990
DATE RELEASED
January 17, 1994
DATE LAST UPDATED
January 17, 1994
LOCATION
DSRS Library
PAL
ENVIRONMENT
DEC VAX/VMS Ada Version 2.0
Zenith Z248 PC (MS-DOS/ALSYS)
LIMITATIONS
Not documented in PAL database
CERTIFICATION
Ada System Certifier_1 1.0
Date/Time of Processing: Wednesday 25 May       1994 02:12:31Pm
Overall Assessment of System: OK
Classification of System: A
Basis of Classification --
Syntax Errors                               PASS
Completeness                                PASS
Independence from External Libraries        PASS
Independence from a Specific Ada Compiler   PASS

Number of ...
Files               1
Library Units       2
Lines             941
Statements        231
Comments          481

FILE LISTING

Directory Display


languages/ada/swcomps/dsrs/ebcdic:
  File Name                 Size
  ---------                 ----
  ebcdic.zip              24,036


Totals
  ==============  ==============
    1 Files               24,036

ABSTRACT

                                     Ebcdic
                                   01D001OW.1
                               (Old ID: RIA0013A)
PURPOSE/INTENDED USE:
Ebcdic is an Ada package that provides subprograms used for manipulating
Extended Binary Coded Decimal Interchange Code (EBCDIC) characters, such
as: 
    o  Comparing EBCDIC strings. 
    o  Concatenating EBCDIC characters and/or strings.
    o  Changing characters case for EBCDIC characters or strings.
    o  Converting EBCDIC characters or strings to ASCII.
    o  Converting ASCII characters or strings to EBCDIC.

EXAMPLE APPLICATIONS:
Ebcdic is valuable in a system required to perform EBCDIC type functions.

CERTIFICATION LEVEL:
Ebcdic 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. 
 
IMPLEMENTATION ISSUES:
Ebcdic has no dependencies (withs).

The exceptions Ascii_Value_Does_Not_Exist and
Ebcdic_Value_Does_Not_Exist are defined in the Ebcdic package. The
exception Ascii_Value_Does_Not_Exist is raised when an ASCII value
equivalent to the input EBCDIC does not exist in Ebcdic_To_Ascii.
Ebcdic_Value_Does_Not_Exist is raised when an EBCDIC value equivalent to
the input ASCII does not exist in Ascii_To_Ebcdic. 

The generic function Image has the generic formal parameter
Element_Type, which  provides a discrete type to be converted to an
EBCDIC string.

The generic function Value has the generic formal parameter
Element_Type, which  provides a discrete type to be converted from an
EBCDIC string.

The Ebcdic package only works with the EBCDIC character set. Modification 
is required if any other character set is desired.
                                                    
HARDWARE/ENVIRONMENT CONSTRAINTS AND LIMITATIONS:
Ebcdic was compiled, run and tested on the VAX/VMS Ada Version 2.0 and
the Zenith Z248 PC (MS-DOS/ALSYS). 

SUBUNITS:
Ebcdic has the following visible subunits:
   "<"    Determines if one EBCDIC string is less than another EBCDIC
          string.
   "<="   Determines if one EBCDIC string is less than or equal to another
          EBCDIC string.
   ">"    Determines if one EBCDIC string is greater than another EBCDIC
          string.
   ">="   Determines if one EBCDIC string is greater than or equal to
          another EBCDIC string.
   "&"    (overloaded) Concatenates two EBCDIC strings or an EBCDIC
          character with an EBCDIC string or an EBCDIC string with an
          EBCDIC character or two EBCDIC characters.
   Upper  (overloaded) Change an EBCDIC string or character to upper case.
   Lower  (overloaded) Change an EBCDIC string or character to lower case.
   Ascii_To_Ebcdic
          (overloaded) Converts an ASCII character to an EBCDIC character
          or an ASCII string to an EBCDIC string.
   Ebcdic_To_Ascii       
          (overloaded) Converts an EBCDIC character to an ASCII character or
          an EBCDIC string to an ASCII string.
   Image  (generic function) Converts a discrete type to EBCDIC.
   Value  (generic function) Converts an EBCDIC string to a discrete type.

DSRS CLASSIFICATION:
availability:  extractable
certification level:  level_4
component type:  implementation
data representation:  character
data representation:  enumeration
data representation:  string
environment:  mvii/vms/vaxada
function:  change_case
function:  compare
function:  concatenate
function:  convert
language:  ada
object:  character
object:  ebcdic
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.