<!doctype HTML public "-//W3C//DTD HTML 4.0 Frameset//EN">

<html>

<!--(==============================================================)-->
<!--(Document created with RoboEditor. )============================-->
<!--(==============================================================)-->

<head>

<title>XLATOR</title>

<!--(Meta)==========================================================-->

<meta name=generator content="RoboHELP by eHelp Corporation - www.ehelp.com">
<meta name=generator-major-version content=0.1>
<meta name=generator-minor-version content=1>
<meta name=filetype content=kadov>
<meta name=filetype-version content=1>
<meta name=page-count content=0>
<meta name=layout-height content=0>
<meta name=layout-width content=0>
<meta name=date content="08 14, 2001 12:10:35 PM">


<!--(Links)=========================================================-->

<link rel="StyleSheet" href="../../css/main_styles.css">



<!--(Style Sheet)===================================================-->

<style type="text/css">
<!--

body {
	background-image: url("../paper.gif");
	background-repeat: repeat;
	background-attachment: scroll;
}

-->
</style>


</head>

<!--(Body)==========================================================-->


<body class="bodydocs" onLoad="top.pageLoader()" bgcolor="#FFFFFF">


<h1 CLASS=ChapName>XLATOR</h1>

<p CLASS=Paragraph><span style="font-weight: bold;">XLATOR</span> is designed 
 to function in conjunction with a specially configured Remex paper tape 
 reader/punch.</p>

<p CLASS=Paragraph>The <span style="font-weight: bold;">XLATOR</span> program 
 performs two basic functions:</p>

<ul>
	
	<li class=kadov-P-CListBullet><p CLASS=ListBullet>It punches Numerical 
 Control tape files generated by and stored in the GPM.</p></li>
	
	<li class=kadov-P-CListBullet><p CLASS=ListBullet>It reads NC tapes 
 from a paper tape reader and stores the information in a punch file.</p></li>
</ul>

<p CLASS=Paragraph>This allows you to edit the stored file. You can then 
 punch the paper tape.</p>

<p CLASS=Paragraph>The baudrate for the paper tape punch is controlled 
 by the environment variable UGII_TAPEBAUD in all operating systems. If 
 this variable is undefined, the system defaults to 1200.</p>

<p>&nbsp;</p>

<h5>Editing the Punch File</h5>

<p CLASS=Paragraph>The GPM punch file is stored as an ASCII text file until 
 sent to the paper tape punch. This file accepts the full set of ASCII 
 characters. The unprintable characters can be used by enclosing the octal 
 value of the unprintable character within angle brackets.</p>

<p CLASS=Paragraph>The punch file can be edited in the same manner as any 
 text file.</p>

<p>&nbsp;</p>

<h5>XLATOR File Formats</h5>

<p CLASS=Paragraph><span style="font-weight: bold;">Intermediate ASCII 
 format file</span> - An intermediate ASCII formatted file is created which 
 represents an EIA, ISO, or 7 BIT MCD tape format. This intermediate file 
 is used as a storage medium for paper tape representations and can be 
 edited as an ASCII file.</p>

<p CLASS=Paragraph>There are several ways this file can be created:</p>

<ul>
	
	<li class=kadov-P-CListBullet><p CLASS=ListBullet>Generated by the 
 GPM</p></li>
	
	<li class=kadov-P-CListBullet><p CLASS=ListBullet>Read in from the 
 paper tape reader through XLATOR</p></li>
</ul>

<p CLASS=Paragraph><span style="font-weight: bold;">EIA Machine Control 
 Data (MCD) format</span> - Through the XLATOR the ASCII file can be translated 
 to EIA format. This data then exists as an NC tape EIA MCD image. EIA 
 MCD image has an odd number of bits. The image can be stored as a binary 
 file or it can be output directly to the paper tape punch. The binary 
 file cannot be edited.</p>

<p CLASS=Paragraph><span style="font-weight: bold;">ISO MCD format</span> 
 - Through the XLATOR the ASCII file can be translated to an NC tape ISO 
 MCD image. ISO MCD image has an even number of bits. The image can be 
 stored as a binary file or output to the paper and tape punch. The binary 
 file cannot be edited.</p>

<p CLASS=Paragraph><span style="font-weight: bold;">7-BIT MCD format </span>- 
 Through the XLATOR the ASCII file can be translated to a 7-Bit ASCII MCD 
 image and stored in a binary file or it can be sent directly to the punch 
 or some DNC file.</p>

<p>&nbsp;</p>

<h5>XLATOR Punch and Render Structure for VS</h5>

<p CLASS=Paragraph>Since every system can have their punch and reader connected 
 in different ways the translator uses specific queues to the devices. 
 The punch queue is 'PTP' and the user must have created this as a link 
 to the actual punch. For the reader the queue is 'TAPEIN' and this must 
 be linked to the reader. These links are created during installation. 
 To punch, the queue must be started with the following commands.</p>

<p CLASS=ListBulletTxt>CONTROL @EXEC START PTP @CONXX</p>

<p CLASS=ListBulletTxt>CONTROL @EXEC PRI/PRE @CONXX 1</p>

<p CLASS=ListBulletTxt>CONTROL @EXEC CONTINUE @CONXX</p>

<p CLASS=Paragraph>The TERM and PUNCH buttons on the REMEX paper tape controller 
 should be depressed for punching. The user can now punch but cannot read. 
 To read, the punch queue must be stopped.</p>

<p CLASS=ListBulletTxt>CONTROL @EXEC STOP @CONXX</p>

<p CLASS=Paragraph>On the REMEX the TERM, REMOTE and READ buttons must 
 be depressed. If the tape does not start to read when the XLATOR read 
 command is given then momentarily take the remote button off and then 
 depress again. The tape should start to read. To punch after reading start 
 the punch queue again.</p>

<p>&nbsp;</p>

<h5>XLATOR Punch and Render Structure for VMS</h5>

<p CLASS=Paragraph>To punch a tape, the PUNCH and TERM buttons on the REMEX 
 should be depressed. To read, the tape must be loaded before the XLATOR 
 is executed. The TERM, REMOTE and READER buttons on the REMEX should be 
 depressed. The logical, 'UGPTR', must be linked to the system paper tape 
 punch and reader. If the reader/punch is connected as a modem, MODEM should 
 be depressed instead of TERM. For more information on the paper tape on 
 VMS refer to the VMS Installation and System Management manual.</p>

<p>&nbsp;</p>

<h5>XLATOR Punch and Render Structure for UNIX</h5>

<p CLASS=Paragraph>To punch, the PUNCH and TERM buttons on the REMEX must 
 be depressed. To read, the tape must be loaded before the XLATOR is executed. 
 The TERM, REMOTE, and READER buttons on the REMEX should be depressed. 
 The file, &quot;ptp&quot;, must be linked to the system paper tape punch 
 and reader. The link is a file with the equivalent address of the line 
 which the user wishes to use for the paper tape punch connection. This 
 file must be in the default UGII directory, which is identified with the 
 &quot;UGII_ROOT_DIR&quot; environment variable. Refer to the Installation 
 and System Management guides for additional information.</p>

<p>&nbsp;</p>

<h5>XLATOR Punch and Render Structure for Windows NT</h5>

<p CLASS=Paragraph>To punch, the PUNCH and TERM buttons on the REMEX must 
 be depressed. To read, the tape must be loaded before the XLATOR is executed. 
 The TERM, REMOTE, and READER buttons on the REMEX should be depressed. 
 The communications resource to which the paper tape punch and reader is 
 attached and must be defined. The mechanism to do this is the environment 
 variable UGII_PTPCOM. If this variable is undefined, the system defaults 
 to COM1.</p>

<p>&nbsp;</p>

<h5>XLATOR Execution</h5>

<p CLASS=Paragraph><span style="font-weight: bold;">VAX/VMS - </span>There 
 are three ways in which XLATOR can be called in the VAX operating system. 
 An operating system command line utilizing an assigned logical name can 
 be called. A macro can be created with its own logical assignments. Finally, 
 the filename can be substituted in place of the GPM name in the NX 
 postprocessor menu.</p>

<p CLASS=Paragraph>Define symbols in the LOGIN macro</p>

<p CLASS=ListBulletTxt>$ XL*ATOR :== &quot;UGII_ROOT_$DIR:XLATOR&quot;</p>

<p CLASS=ListBulletTxt>XLATORU</p>

<p CLASS=ListBulletTxt>Will call in XLATOR.</p>

<p CLASS=ListBulletTxt>XL/</p>

<p CLASS=ListBulletTxt>Will call in XLATOR with interactive login prompts. 
 This is equivalent to 'R XLATOR' for XLATOR.EXE(V4.1)</p>

<p CLASS=ListBulletTxt>$POST:==UGII$DIR:XLATOR</p>

<p CLASS=ListBulletTxt>$EXIT</p>

<p CLASS=Paragraph><span style="font-weight: bold;">UNIX</span> - There 
 are three ways in which XLATOR can be called in the UNIX operating system. 
 The file name can be typed to call XLATOR with interactive logon. The 
 second method is to create a macro with these switches which can include 
 input from a file. Finally, the file name can be substituted in place 
 of the GPM name in the NX postprocessor menu.</p>

<!--(Table)=========================================================-->
<table x-use-null-cells
		wrapperparagraphselector=P.ListBulletTxt
		style="border-spacing: 0px;"
		cellspacing=0>

<tr>
<td COLSPAN=2
	style="x-cell-content-align: TOP;
			padding-left: 2px;
			padding-top: 2px;
			padding-right: 2px;
			padding-bottom: 2px;"
	valign=top>
<p CLASS=CellDescrip
	style="text-align: left; margin-bottom: 0;"
	align=left>Macros - Create input file name: punch.txt</td>
<td_null></tr>

<tr>
<td style="x-cell-content-align: TOP;
			padding-left: 2px;
			padding-top: 2px;
			padding-right: 2px;
			padding-bottom: 2px;"
	valign=top>
<p CLASS=CellDescrip
	style="text-align: left; margin-bottom: 0;"
	align=left>1</td>
<td style="x-cell-content-align: TOP;
			padding-left: 2px;
			padding-top: 2px;
			padding-right: 2px;
			padding-bottom: 2px;"
	valign=top>
<p CLASS=CellDescrip
	style="text-align: left; margin-bottom: 0;"
	align=left>&nbsp;;comment Option 1 - Punch a tape</td></tr>

<tr>
<td style="x-cell-content-align: TOP;
			padding-left: 2px;
			padding-top: 2px;
			padding-right: 2px;
			padding-bottom: 2px;"
	valign=top>
<p CLASS=CellDescrip
	style="text-align: left; margin-bottom: 0;"
	align=left>name.ptp</td>
<td style="x-cell-content-align: TOP;
			padding-left: 2px;
			padding-top: 2px;
			padding-right: 2px;
			padding-bottom: 2px;"
	valign=top>
<p CLASS=CellDescrip
	style="text-align: left;"
	align=left>&nbsp;;comment filename</p>
<p CLASS=CellDescrip
	style="text-align: left; margin-bottom: 0;"
	align=left>;comment In case file doesn't exist</td></tr>

<tr>
<td style="x-cell-content-align: TOP;
			padding-left: 2px;
			padding-top: 2px;
			padding-right: 2px;
			padding-bottom: 2px;"
	valign=top>
<p CLASS=CellDescrip
	style="text-align: left; margin-bottom: 0;"
	align=left>8</td>
<td style="x-cell-content-align: TOP;
			padding-left: 2px;
			padding-top: 2px;
			padding-right: 2px;
			padding-bottom: 2px;"
	valign=top>
<p CLASS=CellDescrip
	style="text-align: left; margin-bottom: 0;"
	align=left>&nbsp;;comment Option 8 - Exit XLATOR</td></tr>
</table>

<p CLASS=Paragraph>Create file to run xlator using punch.txt for input 
 tape :</p>

<p CLASS=ListBulletTxt>xlator - &lt;punch.txt</p>

<p CLASS=Paragraph><span style="font-weight: bold;">Windows NT</span> - 
 There are two ways in which XLATOR can be called in the Windows NT operating 
 system. The file named xlator.exe can be typed to call XLATOR with interactive 
 logon. Also, the file name can be substituted in the NX postprocessor 
 menu.</p>

<p>&nbsp;</p>

<h5>XLATOR Menus</h5>

<p CLASS=Paragraph>The user is presented with a series of questions outlining 
 each function of the translator. At this point you can also exit. Below 
 is an example of the XLATOR menu questions:</p>

<p CLASS=ListBulletTxt><span style="font-weight: bold;">PUNCH a EIA or 
 ISO MCD* text file</span><span style="font-weight: bold;"><br>
CONVERT a EIA or ISO MCD* text file to a mcd* binary file</span><span style="font-weight: bold;"><br>
PUNCH A 7-BIT MCD* text file</span><span style="font-weight: bold;"><br>
CONVERT A 7-BIT MCD* text file to a binary file</span><span style="font-weight: bold;"><br>
READ IN A EIA, ISO, or 7-BIT MCD* tape to a text file</span><span style="font-weight: bold;"><br>
CONVERT A EIA, ISO, or 7-BIT MCD* binary file to a text file.</span><span 
 style="font-weight: bold;"><br>
VERIFY A EIA, ISO, or 7-BIT MCD* tape against a text file.</span><span 
 style="font-weight: bold;"><br>
EXIT from XLATOR</span></p>

<p CLASS=ListBulletTxt>&nbsp;</p>

<p CLASS=ListBulletTxt>MCD* = Machine Control Data (EIA, ISO, or 7-BIT 
 FORMAT)</p>

<p CLASS=ListBulletTxt>&quot;binary refers to the punched tape image&quot;</p>

<p CLASS=ListBulletTxt>MCD* = Machine Control Data</p>

<p CLASS=ListBulletTxt
	style="margin-left: 40px;">&quot;binary&quot; refers to the punched 
 tape image</p>

<p CLASS=Paragraph>For selections <span style="font-weight: bold;">Punch 
 A EIA Or ISO MCD* Text File</span> or <span style="font-weight: bold;">Punch 
 A 7-bit MCD* Text File, </span>you are asked for the name of the input 
 text file.</p>

<p CLASS=Paragraph>For selections <span style="font-weight: bold;">Convert 
 A EIA Or ISO MCD* Text File To A MCD* Binary File</span> or <span style="font-weight: bold;">Convert 
 A 7-bit MCD* Text File To A Binary File,</span> you are asked for the 
 names of the input text and the MCD output file.</p>

<p CLASS=Paragraph>For selection <span style="font-weight: bold;">Read 
 In A EIA, ISO, Or 7-bit MCD* Tape To A Text File,</span> you are asked 
 for the type of MCD input format and the name of the output text file.</p>

<p CLASS=Paragraph>For selection <span style="font-weight: bold;">Convert 
 A EIA, ISO, Or 7-bit MCD* Binary File To A Text File,</span> you are asked 
 the MCD input file name, the type of MCD input format, and output text 
 file name.</p>

<p CLASS=Paragraph>The XLATOR identifies the type of MCD code when it reads 
 the TEXT file. When reading from the paper or tape reader or converting 
 a MCD file you have to specify the type of MCD code.</p>

<p CLASS=Paragraph>For selection <span style="font-weight: bold;">Verify 
 A EIA, ISO, Or 7-bit MCD* Tape Against A Text File,</span> you are asked 
 for the type of MCD input format and the name of the input text file to 
 compare against.</p>

<p CLASS=Paragraph>The MCD input format for the tape parity and END OF 
 BLOCK code is chosen by the use of the following three menus. The first 
 menu appears for selections 5, 6, and 7 of the XLATOR main menu. It also 
 appears for punching if XLATOR cannot find the standard END OF BLOCK codes 
 to determine parity.</p>

<p CLASS=ListBulletTxt><span style="font-weight: bold;">PUNCH OUTPUT CODE 
 PARITY FORMAT</span><span style="font-weight: bold;"><br>
EIA (ODD PARITY PUNCHES)</span><span style="font-weight: bold;"><br>
ISO (EVEN PARITY PUNCHES)</span><span style="font-weight: bold;"><br>
7-BIT ASCII MCD</span></p>

<p CLASS=Paragraph>The second menu appears <span style="font-weight: bold;">ISO</span> 
 is selected above.</p>

<p CLASS=ListBulletTxt><span style="font-weight: bold;">PUNCH END-OF-BLOCK 
 CODE FORMAT</span><span style="font-weight: bold;"><br>
ISO, CR ONLY</span><span style="font-weight: bold;"><br>
ISO, LF ONLY</span><span style="font-weight: bold;"><br>
ISO, CR,LF</span><span style="font-weight: bold;"><br>
ISO, LF,CR,CR</span><span style="font-weight: bold;"><br>
ISO, $</span><span style="font-weight: bold;"><br>
ISO, *</span><span style="font-weight: bold;"><br>
ISO, USER DEFINED</span></p>

<p CLASS=Paragraph>The third menu appears if <span style="font-weight: bold;">EIA</span> 
 of the first menu is selected.</p>

<p CLASS=ListBulletTxt><span style="font-weight: bold;">PUNCH END-OF-BLOCK 
 CODE FORMAT</span><span style="font-weight: bold;"><br>
EIA, &lt;EOB&gt;</span><span style="font-weight: bold;"><br>
EIA, $</span><span style="font-weight: bold;"><br>
EIA, *</span><span style="font-weight: bold;"><br>
EIA, USER DEFINED</span></p>

<p CLASS=Paragraph>If a <span style="font-weight: bold;">User Defined</span> 
 end of block code is selected, these menus come up. The desired code is 
 typed in for entry 1. Non-printable characters are represented by octal 
 numbers in angle brackets: &lt;000&gt; is a null code, &lt;128&gt; is 
 the &lt;EOB&gt;. The length of the character string that represents the 
 END OF BLOCK code is typed for <span style="font-weight: bold;">EIA, $</span>. 
 Any string of characters within brackets is translated to a single punch 
 code on a punched tape.</p>

<p CLASS=ListBulletTxt><span style="font-weight: bold;">USER DEFINED END-OF-BLOCK</span><span 
 style="font-weight: bold;"><br>
USER DEFINED END-OF-BLOCK CHARACTER STRING</span><span style="font-weight: bold;"><br>
LENGTH OF USR END-OF-BLOCK CHARACTER-STRING</span><span style="font-weight: bold;"><br>
ENTRY COMPLETE</span></p>

<p CLASS=ListBulletTxt><span style="font-weight: bold;">DEFINE THE CHARACTER 
 STRING FOR USER DEFINED END-OF-BLOCK CODE. SPECIFY UNPRINTABLE CHARACTERS 
 BY ENCLOSING THEIR 3-DIGIT OCTAL VALUE IN ANGLE BRACKETS (EXAMPLE: ESCAPE 
 = &lt;033&gt;).</span></p>

<p CLASS=ListBulletTxt><span style="font-weight: bold;">ENTER CHARACTER 
 VALUE:</span></p>

<p CLASS=Figure>If selection 2 was made above, this menu appears:</p>

<p CLASS=ListBulletTxt><span style="font-weight: bold;">SPECIFY THE LENGTH 
 OF THE USR END-OF-BLOCK CHARACTER STRING (LENGTH = NUMBER OF CHARACTERS. 
 EXAMPLE: LENGTH OF &lt;033&gt; = 5).</span></p>

<p CLASS=ListBulletTxt><span style="font-weight: bold;">ENTER NUMERIC VALUE</span>:</p>

<p CLASS=Paragraph
	style="margin-bottom: 0;">When the verify function is executed, the 
 tape is read into a temporary file and compared with the designated TEXT 
 file. The program returns the message &quot;tape verifies&quot; if there 
 are no discrepancies in the MCD blocks that are compared. It also outputs 
 the number of blocks that are compared. LEADER and PARTNO characters before 
 the first MCD block are ignored. If XLATOR finds discrepancies in the 
 comparison, the program outputs the number of blocks that have been processed 
 before the difference is encountered and the contents of the blocks for 
 both files. After five error blocks are processed, the program returns 
 to the XLATOR menu. </p>

</body>

</html>
