View source for LU 6.2 and Horizon equivalences

==Overview==
<p>
In terms of the LU 6.2 architectural standard, Horizon implements LU 6.2 "mapped conversation" support, using the "base subset" of LU 6.2 options. In addition, some optional verb sets are implemented: explicit flush, PIP data, attribute query, and security.</p>
<p>
The tables in the following sections map Horizon programming statements and their parameters and status codes to corresponding terminology used in standard LU 6.2 architectural documents. The SOUL column of the tables is formatted according to the following conventions:</p>
<ul>
<li>Items in full capitals are keyword parameters.</li>

<li>Items in lowercase are positional parameters.</li>

<li>Items in parentheses are parameters on either DEFINE commands or network control commands; the command name is given in initial capitals. </li>
</ul>

==LU 6.2 and Horizon verb and parameter equivalences==
<p>
The following table maps LU 6.2 verbs and parameters to SOUL statements and parameters. </p>
<table>
<caption>LU 6.2 and Horizon equivalences</caption>
<tr class="head">
<th>LU 6.2 verbs and parameters</th>
<th>SOUL statements and parameters</th>
</tr>

<tr>
<td><p>MC_ALLOCATE<br />
&emsp;LU_NAME(other)<br />
<br />
<br />
&emsp; MODE_NAME<br />
&emsp; TPN<br />
&emsp; RETURN_CONTROL<br />
&emsp; &emsp;WHEN_SESSION_ALLOCATED<br />
&emsp; SYNC_LEVEL<br />
&emsp; &emsp;NONE<br />
&emsp; &emsp;CONFIRM<br />
&emsp; SECURITY<br />
&emsp; &emsp;NONE<br />
&emsp; &emsp;SAME<br />
<br />
&emsp; &emsp;PGM(USER_ID)<br />
&emsp; &emsp;PGM(PASSWORD)<br />
&emsp; &emsp;PGM(PROFILE)<br />
&emsp; PIP<br />
&emsp; &emsp;(YES(var1,var2,...))<br />
&emsp; &emsp;(NO)<br />
&emsp; RESOURCE<br />
&emsp; RETURN_CODE</p>
</td>

<td>
<p>OPEN PROCESS<br />
&emsp; (REMOTEID on Processgroup);<br />
&emsp; pointed to optionally by<br />
&emsp; AT on OPEN PROCESS<br />
&emsp; (MODENAME on Process)<br />
&emsp; (PARTNER on Process)<br />
<br />
&emsp; [default]<br />
<br />
&emsp; (NOCONFIRM on Process)<br />
&emsp; CONFIRM on Process)<br />
<br />
&emsp; [default]<br />
&emsp; (UIDSOURCE=CURRENT on Process,<br />
&emsp; LOGIN=TRUST on Processgroup)<br />
&emsp; USERID<br />
&emsp; PASSWORD<br />
&emsp; PROFILE<br />
<br />
<br />
&emsp; INITIAL DATA<br />
&emsp; [default]<br />
&emsp; processname|CID<br />
&emsp; $STATUS and $STATUSD</p>
</td>
</tr>

<tr>
<td><p>MC_CONFIRM<br />
&emsp; RESOURCE<br />
&emsp; RETURN_CODE<br />
&emsp; REQUEST_TO_SEND_RECEIVED</p></td>
<td><p>CONFIRM<br />
&emsp; cid<br />
&emsp; $STATUS and $STATUSD<br />
&emsp; REQSEND</p></td>
</tr>

<tr>
<td>
<p>MC_CONFIRMED<br />
&emsp; RESOURCE</p>
</td>
<td>
<p>
CONFIRMED<br />
&emsp; cid</p>
</td>
</tr>

<tr>
<td>
<p>
MC_DEALLOCATE<br />
&emsp; RESOURCE<br />
&emsp; TYPE<br />
&emsp;&emsp; SYNC_LEVEL<br />
&emsp;&emsp; FLUSH<br />
&emsp;&emsp; CONFIRM<br />
&emsp;&emsp; LOCAL<br />
&emsp;&emsp; ABEND<br />
&emsp; RETURN_CODE</p>
</td>
<td>
<p>CLOSE PROCESS<br />
&emsp; cid<br />
<br />
&emsp; SYNCLEV<br />
&emsp; FLUSH<br />
&emsp; CONFIRM<br />
&emsp; [implicit]<br />
&emsp; ERROR<br />
&emsp; $STATUS and $STATUSD</p>
</td>
</tr>

<tr>
<td>
<p>MC_FLUSH<br />
&emsp; RESOURCE</p>
</td>
<td>
<p>
FLUSH PROCESS<br />
&emsp; cid</p>
</td>
</tr>

<tr>
<td>
<p>MC_POST_ON_RECEIPT</p>
</td>
<td>
<p>
<i>included in INVITE</i>
</p>
</td>
</tr>

<tr>
<td>
<p>MC_PREPARE_TO_RECEIVE<br />
&emsp; RESOURCE<br />
&emsp; TYPE<br />
&emsp;&emsp; SYNC_LEVEL<br />
&emsp;&emsp; FLUSH<br />
&emsp;&emsp; CONFIRM<br />
&emsp; LOCKS<br />
&emsp;&emsp; SHORT<br />
&emsp; RETURN_CODE</p>
</td>
<td>
<p>INVITE<br />
&emsp; cid<br />
<br />
&emsp; SYNCLEVEL<br />
&emsp; FLUSH<br />
&emsp; CONFIRM<br />
<br />
&emsp; [default]<br />
&emsp; $STATUS and $STATUSD</p>
</td>
</tr>

<tr>
<td>
<p>MC_GET_ATTRIBUTES<br />
&emsp; RESOURCE<br />
&emsp; OWN_FULLY_QUALIFIED_LU_NAME<br />
&emsp; PARTNER_LU_NAME<br />
&emsp; PARTNER_FULLY_QUALIFIED_LU_NAME<br />
&emsp; MODE_NAME<br />
&emsp; SYNC_LEVEL</p>
</td>
<td>
<p>QUERY PROCESS<br />
&emsp; cid<br />
&emsp; (LOCAL ID returned by Monitor Link)<br />
&emsp; REMOTEID<br />
&emsp; REMOTEID<br />
&emsp; MODENAME<br />
&emsp; SYNCLEVEL</p>
</td>
</tr>

<tr>
<td>
<p>MC_RECEIVE_AND_WAIT<br />
&emsp; RESOURCE<br />
&emsp; DATA<br />
&emsp; LENGTH<br />
&emsp; RETURN_CODE<br />
&emsp; WHAT_RECEIVED</p>
</td>
<td>
<p>RECEIVE<br />
&emsp; FROM cid<br />
&emsp; %variable|IMAGE imagename<br />
&emsp; [implicit]<br />
&emsp; $STATUS and $STATUSD<br />
&emsp; RESULT</p>
</td>
</tr>

<tr>
<td>
<p>MC_REQUEST_TO_SEND<br />
&emsp; RESOURCE</p>
</td>
<td>
<p>
SIGNAL<br />
&emsp; cid</p>
</td>
</tr>

<tr>
<td>
<p>MC_SEND_DATA<br />
&emsp; RESOURCE<br />
&emsp; DATA<br />
&emsp; LENGTH<br />
&emsp; RETURN_CODE<br />
&emsp; REQUEST_TO_SEND_RECEIVED</p>
</td>
<td>
<p>SEND<br />
&emsp; TO cid<br />
&emsp; %variable|'string'|IMAGE imagename<br />
&emsp; [implicit]<br />
&emsp; $STATUS and $STATUSD<br />
&emsp; REQSEND</p>
</td>
</tr>

<tr>
<td>
<p>MC_SEND_ERROR<br />
&emsp; RESOURCE<br />
&emsp; RETURN_CODE<br />
&emsp; REQUEST_TO_SEND_RECEIVED</p>
</td>
<td>
<p>SEND ERROR<br />
&emsp; TO cid<br />
&emsp; $STATUS and $STATUSD<br />
&emsp; REQSEND</p>
</td>
</tr>

<tr>
<td>
<p>MC_TEST<br />
&emsp; RESOURCE<br />
&emsp; TEST<br />
&emsp;&emsp; POSTED<br />
&emsp; RETURN_CODE</p></td>

<td><p>TEST RECEIPT<br />
&emsp; cid<br />
<br />
&emsp; [default]<br />
&emsp; $STATUS and $STATUSD</p></td>
</tr>

<tr>
<td><p>WAIT<br />
<br />
&emsp; RESOURCE_LIST<br />
<br />
&emsp; RESOURCE_POSTED<br />
&emsp; RETURN_CODE</p></td>

<td><p>WAIT FOR RECEIPT<br />
&emsp; receipt cid<br />
&emsp;&emsp; <i>or</i> <br />
&emsp; ANY receipt<br />
&emsp; RETURN<br />
&emsp; $STATUS and $STATUSD</p></td>
</tr>
</table>

==LU 6.2 verb equivalences==
<p>
The following table maps LU 6.2 verbs to Horizon SOUL statements, CICS commands, and AT&amp;T LU 6.2 Facility commands.</p>
<table>
<caption>LU 6.2 Verb Equivalences</caption>
<tr class="head">
<th>LU 6.2 Verbs</th>
<th>Horizon SOUL Statements</th>
<th>CICS Commands</th>
</tr>

<tr>
<td>
<p>
<br />
MC_ALLOCATE<br />
MC_CONFIRM<br />
MC_CONFIRMED<br />
MC_DEALLOCATE<br />
<br />
<br />
MC_FLUSH<br />
MC_GET_ATTRIBUTES<br />
MC_PREPARE_TO_RECEIVE<br />
MC_POST_ON_RECEIPT<br />
MC_RECEIVE_AND_WAIT<br />
MC_REQUEST_TO_SEND<br />
MC_SEND_DATA<br />
MC_SEND_ERROR<br />
MC_TEST<br />
WAIT</p>
</td>
<td>
<p>
<br />
OPEN PROCESS<br />
CONFIRM<br />
CONFIRMED<br />
CLOSE PROCESS<br />
<br />
<br />
FLUSH PROCESS<br />
QUERY PROCESS<br />
INVITE<br />
<br />
RECEIVE<br />
SIGNAL<br />
SEND<br />
SEND ERROR<br />
TEST RECEIPT<br />
WAIT FOR RECEIPT</p>
</td>
<td>
<p>
EXEC CICS ALLOCATE<br />
EXEC CICS CONNECT PROCESS<br />
<br />
<br />
EXEC CICS RETURN<br />
<i>
or</i>
 EXEC CICS SEND LAST<br />
<i>
or</i>
 EXEC CICS ISSUE ABEND<br />
EXEC CICS WAIT<br />
EXEC CICS EXTRACT PROCESS<br />
EXEC CICS ISSUE SIGNAL<br />
<br />
EXEC CICS RECEIVE<br />
<br />
EXEC CICS SEND<br />
EXEC CICS ISSUE ERROR</p>
</td>
</tr>

<tr class="head">
<th>OS/2 APPC</th>
<th>Horizon SOUL Statements</th>
<th>AT&amp;T LU 6.2 Facility</th>
</tr>
<tr>
<td>MC_ALLOCATE<br />
MC_CONFIRM<br />
MC_CONFIRMED<br />
MC_DEALLOCATE<br />
MC_FLUSH<br />
MC_GET_ATTRIBUTES<br />
MC_GET_TYPE<br />
MC_PREPARE_TO_RECEIVE<br />
MC_POST_ON_RECEIPT<br />
MC_RECEIVE_AND_WAIT<br />
MC_RECEIVE_IMMEDIATEM<br />
MC_REQUEST_TO_SEND<br />
MC_SEND_DATA<br />
MC_SEND_ERROR<br />
MC_TEST_RTS</td>
<td>OPEN PROCESS<br />
CONFIRM<br />
CONFIRMED<br />
CLOSE PROCESS<br />
FLUSH PROCESS<br />
QUERY PROCESS<br />
<br />
INVITE<br />
<br />
RECEIVE<br />
<br />
SIGNAL<br />
SEND<br />
SEND ERROR<br />
TEST RECEIPT<br />
WAIT FOR RECEIPT
</td>
<td>malcnv<br />
mcnfrm<br />
mcnfrmed<br />
mdalcnv<br />
mflush<br />
mgetadr<br />
<br />
mprprev<br />
mpstrct<br />
mrcvwt<br />
mrcvim<br />
mrqssnd<br />
msnddta<br />
msnderr<br />
mtestev
</td>
</tr>
</table>

[[Category: Horizon]]