--|
--|Item: Ada PCTE Binding
--|$Revision: 0.2 $
--|$State: Prototype $
--|
--|The Version Description Document (VDD) included with this release provides
--|detailed information regarding the condition of the software.  The "User 
--|Feedback" section of the VDD describes how to obtain additional information.
--|
--|Distribution Statement "A", per DoD Directive 5230.24
--|Authorized for public release; distribution is unlimited.
--|
--|Copyright (c) 1992, Paramax Systems Corporation, Reston, Virginia 
--|Copyright is assigned to the U.S. Government, upon delivery thereto, 
--|in accordance with the DFAR Special Works Clause.
--|
--|Developed by:  Paramax Systems Corporation,
--|
--|This software, developed under the Software Technology for Adaptable,
--|Reliable Systems (STARS) program, is approved for release under 
--|Distribution "A" of the Scientific and Technical Information Program 
--|Classification Scheme (DoD Directive 5230.24) unless otherwise indicated.  
--|Sponsored by the U.S. Defense Advanced Research Projects Agency (DARPA) 
--|under contract F19628-88-D-0031, the STARS program is supported by the 
--|military services, SEI, and MITRE, with the U.S. Air Force as the executive 
--|contracting agent.
--|
--|Permission to use, copy, modify, and comment on this software and its
--|documentation for purposes stated under Distribution "A" and without fee
--|is hereby granted, provided that this notice appears in each whole or
--|partial copy.  This software retains Contractor indemnification to
--|the Government regarding copyrights pursuant to the above referenced
--|STARS contract.  The Government disclaims all responsibility against
--|liability, including costs and expenses for violation of proprietary
--|rights, or copyrights arising out of the creation or use of this
--|software.
--|
--|In addition, the Government, Paramax, and its subcontractors disclaim all 
--|warranties with regard to this software, including all implied warranties 
--|of merchantability and fitness, and in no event shall the Government, 
--|Paramax, or its subcontractor(s) be liable for any special, indirect or 
--|consequential damages or any damages whatsoever resulting from the loss of 
--|use, data, or profits, whether in action of contract, negligence or other 
--|tortious action, arising in connection with the use or performance of this 
--|software.
--|
--|$Log $
--|
--                         Version Information
--                         ^^^^^^^^^^^^^^^^^^^
--
-- PCTE - Ada Language Interface.
-- Version: 0.2.
-- Release Date: November 30, 1992.
-- Compiled under SUN OS 4.1.2 using SunAda 1.0
--
--
--                         General Information
--                         ^^^^^^^^^^^^^^^^^^^
--
-- This is an alpha release of the Paramax STARS Ada binding to Emeraude's
-- PCTE 1.5 using the ECMA PCTE Ada binding specifications.  The binding
-- is incomplete in this release.  See the Version Description Document
-- provided with this alpha release for information on which interfaces
-- have been implemented.  It is expected that future releases will
-- expand the number of interfaces implemented.  The interfaces defined
-- herein are subject to change.
--
-- For further information, contact the authors:
--
--
--                   Robert Smith
--                   Paramax Systems Corp.
--                   Valley Forge Labs
--                   70 E. Swedesford Road
--                   Paoli, PA. 19301
--                   smith@prc.unisys.com (current)
--                   smith@vfl.paramax.com (future)
--                   +1 215 648-2402
--
--                   Michael Horton
--                   Paramax Systems Corp.
--                   Valley Forge Labs
--                   70 E. Swedesford Road
--                   Paoli, PA. 19301
--                   horton@prc.unisys.com (current)
--                   horton@vfl.paramax.com (future)
--                   +1 215 648-2527
--
--
--% NOTE: This package will not be supported by Ada binding to PCTE 1.5

 with  Pcte, Pcte_error, Pcte_discretionary;

 package  Pcte_workstation  is 
 

 use  Pcte, Pcte_error, Pcte.reference;
 

 
 
 type  connection_status  is  (LOCAL, CLIENT, AVAILABLE, CONNECTED);

--	Pcte_workstation.connection_status corresponds
--	to the PCTE datatype Connection_status.

 type  work_status_item  is  (	ACTIVITY_REMOTE_LOCKS,
	ACTIVITY_LOCAL_LOCKS,
	TRANSACTION_REMOTE_LOCKS,
	TRANSACTION_LOCAL_LOCKS,
	QUEUE_REMOTE, QUEUE_LOCAL,
	RECEIVE_REMOTE, RECEIVE_LOCAL,
	CHILD_REMOTE, CHILD_LOCAL);

--	Pcte_workstation.work_status_item corresponds
--	to the PCTE datatype Work_status_item.

 type  work_status  is   array  (work_status_item)  of  Pcte.boolean;

--	Pcte_workstation.work_status corresponds to the PCTE datatype Work_status.
 

 

-- 18.2.1 WORKSTATION_CHANGE_CONNECTION


 procedure  change_connection (
	pcte_status	 : in 	Pcte_workstation.connection_status;
	force	 : in 	Pcte.boolean;
	station	 : in 	Pcte.object_reference  :=  LOCAL_WORKSTATION;
	status	 : in 	Pcte_error.handle  :=  EXCEPTION_ONLY);


--	The effect of not providing the optional parameter  station  is obtained by
--	specifying station as the default value LOCAL_WORKSTATION.
--	The parameter force is a boolean of value TRUE for FORCE
--	and FALSE for GENTLE.


-- 18.2.2 WORKSTATION_CONNECT

 procedure  connect (
	pcte_status	 : in 	Pcte_workstation.connection_status;
	status	 : in 	Pcte_error.handle  :=  EXCEPTION_ONLY);



-- 18.2.3 WORKSTATION_CREATE

--	The effect of providing the optional parameter 
--	 existing_administration_volume  is obtained by the first 
--	overloaded procedure; in that case the optional parameters  foreign_device , 
--	 new_administration_volume , and  new_device  are not needed.  
--	The effect of not providing  existing_administration_volume  is 
--	obtained by the second overloaded procedure.



 procedure  create (
	execution_site_identifier	 : in 	Pcte.natural;
	existing_administration_volume	 : in 	Pcte.object_reference;
	access_mask	 : in 	Pcte_discretionary.object.access_rights;
	other_parameter	 : in 	Pcte.string;
	status	 : in 	Pcte_error.handle  :=  EXCEPTION_ONLY);



 procedure  create (
	execution_site_identifier	 : in 	Pcte.natural;
	access_mask	 : in 	Pcte_discretionary.object.access_rights;
	foreign_device	 : in 	Pcte.string;
	new_administration_volume	 : in 	Pcte.natural;
	new_device	 : in 	Pcte.natural;
	other_parameter	 : in 	Pcte.string;
	status	 : in 	Pcte_error.handle  :=  EXCEPTION_ONLY);



-- 18.2.4 WORKSTATION_DELETE

 procedure  delete (
	station	 : in 	Pcte.object_reference;
	status	 : in 	Pcte_error.handle  :=  EXCEPTION_ONLY);



-- 18.2.5 WORKSTATION_DISCONNECT

 procedure  disconnect (
	status	 : in 	Pcte_error.handle  :=  EXCEPTION_ONLY);



-- 18.2.6 WORKSTATION_STATUS

 procedure  status (
	connection	:  out 	Pcte_workstation.connection_status;
	work	:  out 	Pcte_workstation.work_status;
	station	 : in 	Pcte.object_reference  :=  LOCAL_WORKSTATION;
	status	 : in 	Pcte_error.handle  :=  EXCEPTION_ONLY);


--	The effect of not providing the optional parameter station
--	is obtained by specifying station as the default value LOCAL_WORKSTATION.
 

 end  Pcte_workstation;
 

 
-- 18.3.1 CONTENTS_COPY_FROM_FOREIGN_SYSTEM

--	See 12.2.

-- 18.3.2 CONTENTS_COPY_TO_FOREIGN_SYSTEM

--	See 12.2.