File	Date	Author	Commit
reference	2013-10-21	PEDERSEN	[c95cb3] Readme and reference added
vms_source	2013-10-22	PEDERSEN	[c00b47] Update for removed files...
README	2013-10-22	PEDERSEN	[ae422c] Fixed formatting in README

Read Me

This is the S3270 subset of the X3270 emulator project.

This effort - porting to OpenVMS - was undertaken as the "author" had a project
where he needed a programmatic interface similar to the DEC/Compaq/HP SNA 3270
Data Stream Programming Interface. 

This repository was also created so as to define the process for creating and
accessing open source Mercurial repositories on SourceForge (SF) from OpenVMS,
using Python and Hg as ported by Jean-Francois Pieronne. 

				NOTE

	The suggested use of SSH for interaction with the SF repository
	does not work properly on OpenVMS for Mercurial.  The following
	uses "https" instead.

The basic process initially create the SF Repository and populate it is:

	Create this SF repository via the Admin>Tools function.

	Create a directory structure like on your OpenVMS host system:

		S3270
			vms_source
				s3270-3.3

	Copy your files and directory structure to the lowest level directory.

	Now we get ready to create a local repository

	SET DEF [S3270]		!or where ever you have it...
	hg init                 !create the repository
	hg add			!add all the files below this to the repository
	hg commit		!start commit process
	...			! you will be asked for a comment to the 
				! commit...
	hg push https://username@hg.code.sf.net/p/vms-ports/s3270
				! the above will then move the data to the 
				! SF repository
or...
	hg push			! if your .hgrc file in SYS$LOGIN has a 
				! default like:

		[paths]
		default = https://billpedersen@hg.code.sf.net/p/vms-ports/s3270

Now, if you are cloning the repository from SF to your OpenVMS 
environment then the command:

	hg clone http://hg.code.sf.net/p/vms-ports/s3270

works just fine!!

				NOTE

	In this configuration the "hg push..." will always ask for the user's
	SF password.  The .hgrc file entry can be changed to have the password
	as well - with the associated risk of exposure.

[paths]
default = https://billpedersen:secret_password@hg.code.sf.net/p/vms-ports/s3270

!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
A final note!!!  ALL files in the repository should be STREAM_LF format.  This
this end a command procedure is located in the top directory of the VMS_SOURCE
path: TO_STREAM_LF.COM.  This will convert VARIABLE record format files to
STREAM_LF.  It depends upon a .FDL file in the OpenVMS Mercurial distribution. 
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!

21 Oct 2013