PAL CARD CATALOG ENTRY

SHORT DESCRIPTION

Validate,convert personnel record field


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

ASSET PROFILE

UNIT NAME
Personnel_Validation_Operations_Package
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
March 16, 1988
DATE RELEASED
January 17, 1994
DATE LAST UPDATED
January 17, 1994
LOCATION
DSRS Library
PAL
ENVIRONMENT
DEC VAX/VMS using the 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:23:22Pm
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               3
Library Units       5
Lines            1810
Statements        339
Comments          936

FILE LISTING

Directory Display


languages/ada/swcomps/dsrs/personel:
  File Name                 Size
  ---------                 ----
  personel.zip            22,725

languages/ada/swcomps/dsrs/armydata:
  File Name                 Size
  ---------                 ----
  armydata.zip             7,758

languages/ada/swcomps/dsrs/strutil2:
  File Name                 Size
  ---------                 ----
  strutil2.zip            25,708


Totals
  ==============  ==============
    3 Files               56,191

ABSTRACT

                    Personnel_Validation_Operations_Package
                                   01D001OO.1
                               (Old ID: RIB0008A)
PURPOSE/INTENDED USE:
Personnel_Validation_Operations_Package is an Ada package that provides
subprograms for validating and converting common fields in a personnel
record  to a consistent type defined in the package specification.  Each
of the  subprograms in this package, except Validate_Address, accepts
string inputs, and returns the string converted to the proper type (if
the string input was valid) or to a default invalid value. 
Validate_Address accepts a variable of the required type and validates
the contents.  If any asset of the input address is invalid, default
invalid values are assigned for the entire output address.  A Boolean
flag relating the validity of the string input is also returned from all
subprograms. 

EXAMPLE APPLICATIONS:
Reuse of Personnel_Validation_Operations_Package would be valuable for a
system required to validate personnel file data before storage in a
database, or before writing to a file.

CERTIFICATION LEVEL:
Personnel_Validation_Operations_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. 
 
IMPLEMENTATION ISSUES:
Personnel_Validation_Operations_Package is customized for the United
States Army usage.  If the reuser desires subprograms of the nature
provided by this package for other data, the subprograms in this package
would need new  validation code. For instance, this package assumes that
the zip code is all digits.  If letters were allowed in the zip code,
the code could be modified to allow this. 

Personnel_Validation_Operations_Package depends on (withs)
Us_Army_Data_Types (01D001OP) and String_Utilities_Package (01D001OV).

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:
Personnel_Validation_Operations_Package has the following visible
subunits:

  Validate_Name               Checks that input string is of correct length.
                              The string must contain data.
  Validate_State              Checks that input string is a valid U.S.
                              state abbreviation.
  Validate_Zip_Code           Checks that input string is of correct length.
                              Each character must be a digit.
  Validate_Telephone_Number   Checks that input string is of correct length.
                              Each character must be a digit.
  Validate_Grade              Checks that the input string is a valid 
                              U.S. Army grade.
  Validate_Title              Checks that input string is of correct length,
                              and contains non-blank characters.
  Validate_Rank               Checks that input string is a valid U.S. Army
                              rank.
  Validate_Address            Checks that input address is valid.

DSRS CLASSIFICATION:
availability:  extractable
certification level:  level_4
component type:  implementation
data representation:  array
data representation:  character
data representation:  record
data representation:  string
data representation:  subtype
data representation:  type
environment:  mvii/vms/vaxada
function:  convert
function:  validate
language:  ada
object:  address
object:  field
object:  grade
object:  name
object:  personnel_record
object:  person
object:  rank
object:  record
object:  string
object:  telephone_number
object:  title
object:  us_state
object:  zip_code
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.