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
|