LU 6.2 and Horizon equivalences

From m204wiki
Jump to: navigation, search

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