LU 6.2 and Horizon equivalences: Difference between revisions

From m204wiki
Jump to navigation Jump to search
(Created page with "==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...")
 
m (typo)
 
(One intermediate revision by the same user not shown)
Line 5: Line 5:
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>
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>
<ul>
<li>
<li>Items in full capitals are keyword parameters.</li>
Items in full capitals are keyword parameters.</li>
 
<li>
<li>Items in lowercase are positional parameters.</li>
Items in lowercase are positional parameters.</li>
 
<li>
<li>Items in parentheses are parameters on either DEFINE commands or network control commands; the command name is given in initial capitals. </li>
Items in parentheses are parameters on either DEFINE commands or network control commands; the command name is given in initial capitals. </li>
</ul>
</ul>


Line 22: Line 21:
<th>SOUL statements and parameters</th>
<th>SOUL statements and parameters</th>
</tr>
</tr>
<tr>
<tr>
<td>
<td><p>MC_ALLOCATE<br />
<p>
MC_ALLOCATE<br />
&emsp;LU_NAME(other)<br />
&emsp;LU_NAME(other)<br />
<br />
<br />
Line 39: Line 37:
&emsp; &emsp;NONE<br />
&emsp; &emsp;NONE<br />
&emsp; &emsp;SAME<br />
&emsp; &emsp;SAME<br />
  <br />
<br />
&emsp; &emsp;PGM(USER_ID)<br />
&emsp; &emsp;PGM(USER_ID)<br />
&emsp; &emsp;PGM(PASSWORD)<br />
&emsp; &emsp;PGM(PASSWORD)<br />
Line 49: Line 47:
&emsp; RETURN_CODE</p>
&emsp; RETURN_CODE</p>
</td>
</td>
<td>
<td>
<p>
<p>OPEN PROCESS<br />
OPEN PROCESS<br />
&emsp; (REMOTEID on Processgroup);<br />
&emsp; (REMOTEID on Processgroup);<br />
&emsp; pointed to optionally by<br />
&emsp; pointed to optionally by<br />
Line 63: Line 61:
&emsp; CONFIRM on Process)<br />
&emsp; CONFIRM on Process)<br />
<br />
<br />
&emsp; [default}<br />
&emsp; [default]<br />
&emsp; (UIDSOURCE=CURRENT on Process,<br />
&emsp; (UIDSOURCE=CURRENT on Process,<br />
&emsp; LOGIN=TRUST on Processgroup)<br />
&emsp; LOGIN=TRUST on Processgroup)<br />
Line 77: Line 75:
</td>
</td>
</tr>
</tr>
<tr>
<tr>
<td>
<td><p>MC_CONFIRM<br />
<p>
MC_CONFIRM<br />
&emsp; RESOURCE<br />
&emsp; RESOURCE<br />
&emsp; RETURN_CODE<br />
&emsp; RETURN_CODE<br />
&emsp; REQUEST_TO_SEND_RECEIVED</p>
&emsp; REQUEST_TO_SEND_RECEIVED</p></td>
</td>
<td><p>CONFIRM<br />
<td>
<p>
CONFIRM<br />
&emsp; cid<br />
&emsp; cid<br />
&emsp; $STATUS and $STATUSD<br />
&emsp; $STATUS and $STATUSD<br />
&emsp; REQSEND</p>
&emsp; REQSEND</p></td>
</td>
</tr>
</tr>
<tr>
<tr>
<td>
<td>
<p>
<p>MC_CONFIRMED<br />
MC_CONFIRMED<br />
&emsp; RESOURCE</p>
&emsp; RESOURCE</p>
</td>
</td>
Line 105: Line 98:
</td>
</td>
</tr>
</tr>
<tr>
<tr>
<td>
<td>
Line 119: Line 113:
</td>
</td>
<td>
<td>
<p>
<p>CLOSE PROCESS<br />
CLOSE PROCESS<br />
&emsp; cid<br />
&emsp; cid<br />
<br />
<br />
Line 131: Line 124:
</td>
</td>
</tr>
</tr>
<tr>
<tr>
<td>
<td>
<p>
<p>MC_FLUSH<br />
MC_FLUSH<br />
&emsp; RESOURCE</p>
&emsp; RESOURCE</p>
</td>
</td>
Line 143: Line 136:
</td>
</td>
</tr>
</tr>
<tr>
<tr>
<td>
<td>
<p>
<p>MC_POST_ON_RECEIPT</p>
MC_POST_ON_RECEIPT</p>
</td>
</td>
<td>
<td>
Line 154: Line 147:
</td>
</td>
</tr>
</tr>
<tr>
<tr>
<td>
<td>
<p>
<p>MC_PREPARE_TO_RECEIVE<br />
MC_PREPARE_TO_RECEIVE<br />
&emsp; RESOURCE<br />
&emsp; RESOURCE<br />
&emsp; TYPE<br />
&emsp; TYPE<br />
Line 168: Line 161:
</td>
</td>
<td>
<td>
<p>
<p>INVITE<br />
INVITE<br />
&emsp; cid<br />
&emsp; cid<br />
<br />
<br />
Line 180: Line 172:
</td>
</td>
</tr>
</tr>
<tr>
<tr>
<td>
<td>
<p>
<p>MC_GET_ATTRIBUTES<br />
MC_GET_ATTRIBUTES<br />
&emsp; RESOURCE<br />
&emsp; RESOURCE<br />
&emsp; OWN_FULLY_QUALIFIED_LU_NAME<br />
&emsp; OWN_FULLY_QUALIFIED_LU_NAME<br />
Line 192: Line 184:
</td>
</td>
<td>
<td>
<p>
<p>QUERY PROCESS<br />
QUERY PROCESS<br />
&emsp; cid<br />
&emsp; cid<br />
&emsp; (LOCAL ID returned by Monitor Link)<br />
&emsp; (LOCAL ID returned by Monitor Link)<br />
Line 202: Line 193:
</td>
</td>
</tr>
</tr>
<tr>
<tr>
<td>
<td>
<p>
<p>MC_RECEIVE_AND_WAIT<br />
MC_RECEIVE_AND_WAIT<br />
&emsp; RESOURCE<br />
&emsp; RESOURCE<br />
&emsp; DATA<br />
&emsp; DATA<br />
Line 213: Line 204:
</td>
</td>
<td>
<td>
<p>
<p>RECEIVE<br />
RECEIVE<br />
&emsp; FROM cid<br />
&emsp; FROM cid<br />
&emsp; %variable|IMAGE imagename<br />
&emsp; %variable|IMAGE imagename<br />
Line 222: Line 212:
</td>
</td>
</tr>
</tr>
<tr>
<tr>
<td>
<td>
<p>
<p>MC_REQUEST_TO_SEND<br />
MC_REQUEST_TO_SEND<br />
&emsp; RESOURCE</p>
&emsp; RESOURCE</p>
</td>
</td>
Line 234: Line 224:
</td>
</td>
</tr>
</tr>
<tr>
<tr>
<td>
<td>
<p>
<p>MC_SEND_DATA<br />
MC_SEND_DATA<br />
&emsp; RESOURCE<br />
&emsp; RESOURCE<br />
&emsp; DATA<br />
&emsp; DATA<br />
Line 245: Line 235:
</td>
</td>
<td>
<td>
<p>
<p>SEND<br />
SEND<br />
&emsp; TO cid<br />
&emsp; TO cid<br />
&emsp; %variable|'string'|IMAGE imagename<br />
&emsp; %variable|'string'|IMAGE imagename<br />
Line 254: Line 243:
</td>
</td>
</tr>
</tr>
<tr>
<tr>
<td>
<td>
<p>
<p>MC_SEND_ERROR<br />
MC_SEND_ERROR<br />
&emsp; RESOURCE<br />
&emsp; RESOURCE<br />
&emsp; RETURN_CODE<br />
&emsp; RETURN_CODE<br />
Line 263: Line 252:
</td>
</td>
<td>
<td>
<p>
<p>SEND ERROR<br />
SEND ERROR<br />
&emsp; TO cid<br />
&emsp; TO cid<br />
&emsp; $STATUS and $STATUSD<br />
&emsp; $STATUS and $STATUSD<br />
Line 270: Line 258:
</td>
</td>
</tr>
</tr>
<tr>
<tr>
<td>
<td>
<p>
<p>MC_TEST<br />
MC_TEST<br />
&emsp; RESOURCE<br />
&emsp; RESOURCE<br />
&emsp; TEST<br />
&emsp; TEST<br />
&emsp;&emsp; POSTED<br />
&emsp;&emsp; POSTED<br />
&emsp; RETURN_CODE</p>
&emsp; RETURN_CODE</p></td>
</td>
 
<td>
<td><p>TEST RECEIPT<br />
<p>
TEST RECEIPT<br />
&emsp; cid<br />
&emsp; cid<br />
<br />
<br />
&emsp; [default]<br />
&emsp; [default]<br />
&emsp; $STATUS and $STATUSD</p>
&emsp; $STATUS and $STATUSD</p></td>
</td>
</tr>
</tr>
<tr>
<tr>
<td>
<td><p>WAIT<br />
<p>
WAIT<br />
<br />
<br />
&emsp; RESOURCE_LIST<br />
&emsp; RESOURCE_LIST<br />
<br />
<br />
&emsp; RESOURCE_POSTED<br />
&emsp; RESOURCE_POSTED<br />
&emsp; RETURN_CODE</p>
&emsp; RETURN_CODE</p></td>
</td>
 
<td>
<td><p>WAIT FOR RECEIPT<br />
<p>
WAIT FOR RECEIPT<br />
&emsp; receipt cid<br />
&emsp; receipt cid<br />
&emsp;&emsp; <i>or</i> <br />
&emsp;&emsp; <i>or</i> <br />
&emsp; ANY receipt<br />
&emsp; ANY receipt<br />
&emsp; RETURN<br />
&emsp; RETURN<br />
&emsp; $STATUS and $STATUSD</p>
&emsp; $STATUS and $STATUSD</p></td>
</td>
</tr>
</tr>
</table>
</table>
Line 320: Line 301:
<th>CICS Commands</th>
<th>CICS Commands</th>
</tr>
</tr>
<tr>
<tr>
<td>
<td>
Line 384: Line 366:
</td>
</td>
</tr>
</tr>
<tr class="head">
<tr class="head">
<th>OS/2 APPC</th>
<th>OS/2 APPC</th>

Latest revision as of 21:26, 24 October 2017

Overview

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.

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:

  • Items in full capitals are keyword parameters.
  • Items in lowercase are positional parameters.
  • Items in parentheses are parameters on either DEFINE commands or network control commands; the command name is given in initial capitals.

LU 6.2 and Horizon verb and parameter equivalences

The following table maps LU 6.2 verbs and parameters to SOUL statements and parameters.

LU 6.2 and Horizon equivalences
LU 6.2 verbs and parameters SOUL statements and parameters

MC_ALLOCATE

 LU_NAME(other)


  MODE_NAME
  TPN
  RETURN_CONTROL
   WHEN_SESSION_ALLOCATED
  SYNC_LEVEL
   NONE
   CONFIRM
  SECURITY
   NONE
   SAME

   PGM(USER_ID)
   PGM(PASSWORD)
   PGM(PROFILE)
  PIP
   (YES(var1,var2,...))
   (NO)
  RESOURCE

  RETURN_CODE

OPEN PROCESS
  (REMOTEID on Processgroup);
  pointed to optionally by
  AT on OPEN PROCESS
  (MODENAME on Process)
  (PARTNER on Process)

  [default]

  (NOCONFIRM on Process)
  CONFIRM on Process)

  [default]
  (UIDSOURCE=CURRENT on Process,
  LOGIN=TRUST on Processgroup)
  USERID
  PASSWORD
  PROFILE


  INITIAL DATA
  [default]
  processname|CID
  $STATUS and $STATUSD

MC_CONFIRM

  RESOURCE
  RETURN_CODE

  REQUEST_TO_SEND_RECEIVED

CONFIRM

  cid
  $STATUS and $STATUSD

  REQSEND

MC_CONFIRMED
  RESOURCE

CONFIRMED
  cid

MC_DEALLOCATE
  RESOURCE
  TYPE
   SYNC_LEVEL
   FLUSH
   CONFIRM
   LOCAL
   ABEND
  RETURN_CODE

CLOSE PROCESS
  cid

  SYNCLEV
  FLUSH
  CONFIRM
  [implicit]
  ERROR
  $STATUS and $STATUSD

MC_FLUSH
  RESOURCE

FLUSH PROCESS
  cid

MC_POST_ON_RECEIPT

included in INVITE

MC_PREPARE_TO_RECEIVE
  RESOURCE
  TYPE
   SYNC_LEVEL
   FLUSH
   CONFIRM
  LOCKS
   SHORT
  RETURN_CODE

INVITE
  cid

  SYNCLEVEL
  FLUSH
  CONFIRM

  [default]
  $STATUS and $STATUSD

MC_GET_ATTRIBUTES
  RESOURCE
  OWN_FULLY_QUALIFIED_LU_NAME
  PARTNER_LU_NAME
  PARTNER_FULLY_QUALIFIED_LU_NAME
  MODE_NAME
  SYNC_LEVEL

QUERY PROCESS
  cid
  (LOCAL ID returned by Monitor Link)
  REMOTEID
  REMOTEID
  MODENAME
  SYNCLEVEL

MC_RECEIVE_AND_WAIT
  RESOURCE
  DATA
  LENGTH
  RETURN_CODE
  WHAT_RECEIVED

RECEIVE
  FROM cid
  %variable|IMAGE imagename
  [implicit]
  $STATUS and $STATUSD
  RESULT

MC_REQUEST_TO_SEND
  RESOURCE

SIGNAL
  cid

MC_SEND_DATA
  RESOURCE
  DATA
  LENGTH
  RETURN_CODE
  REQUEST_TO_SEND_RECEIVED

SEND
  TO cid
  %variable|'string'|IMAGE imagename
  [implicit]
  $STATUS and $STATUSD
  REQSEND

MC_SEND_ERROR
  RESOURCE
  RETURN_CODE
  REQUEST_TO_SEND_RECEIVED

SEND ERROR
  TO cid
  $STATUS and $STATUSD
  REQSEND

MC_TEST
  RESOURCE
  TEST
   POSTED
  RETURN_CODE

TEST RECEIPT

  cid

  [default]

  $STATUS and $STATUSD

WAIT


  RESOURCE_LIST

  RESOURCE_POSTED

  RETURN_CODE

WAIT FOR RECEIPT

  receipt cid
   or
  ANY receipt
  RETURN

  $STATUS and $STATUSD

LU 6.2 verb equivalences

The following table maps LU 6.2 verbs to Horizon SOUL statements, CICS commands, and AT&T LU 6.2 Facility commands.

LU 6.2 Verb Equivalences
LU 6.2 Verbs Horizon SOUL Statements CICS Commands


MC_ALLOCATE
MC_CONFIRM
MC_CONFIRMED
MC_DEALLOCATE


MC_FLUSH
MC_GET_ATTRIBUTES
MC_PREPARE_TO_RECEIVE
MC_POST_ON_RECEIPT
MC_RECEIVE_AND_WAIT
MC_REQUEST_TO_SEND
MC_SEND_DATA
MC_SEND_ERROR
MC_TEST
WAIT


OPEN PROCESS
CONFIRM
CONFIRMED
CLOSE PROCESS


FLUSH PROCESS
QUERY PROCESS
INVITE

RECEIVE
SIGNAL
SEND
SEND ERROR
TEST RECEIPT
WAIT FOR RECEIPT

EXEC CICS ALLOCATE
EXEC CICS CONNECT PROCESS


EXEC CICS RETURN
or EXEC CICS SEND LAST
or EXEC CICS ISSUE ABEND
EXEC CICS WAIT
EXEC CICS EXTRACT PROCESS
EXEC CICS ISSUE SIGNAL

EXEC CICS RECEIVE

EXEC CICS SEND
EXEC CICS ISSUE ERROR

OS/2 APPC Horizon SOUL Statements AT&T LU 6.2 Facility
MC_ALLOCATE

MC_CONFIRM
MC_CONFIRMED
MC_DEALLOCATE
MC_FLUSH
MC_GET_ATTRIBUTES
MC_GET_TYPE
MC_PREPARE_TO_RECEIVE
MC_POST_ON_RECEIPT
MC_RECEIVE_AND_WAIT
MC_RECEIVE_IMMEDIATEM
MC_REQUEST_TO_SEND
MC_SEND_DATA
MC_SEND_ERROR

MC_TEST_RTS
OPEN PROCESS

CONFIRM
CONFIRMED
CLOSE PROCESS
FLUSH PROCESS
QUERY PROCESS

INVITE

RECEIVE

SIGNAL
SEND
SEND ERROR
TEST RECEIPT
WAIT FOR RECEIPT

malcnv

mcnfrm
mcnfrmed
mdalcnv
mflush
mgetadr

mprprev
mpstrct
mrcvwt
mrcvim
mrqssnd
msnddta
msnderr
mtestev