LU 6.2 API Application Programmer's Reference Guide (30294-90008)

76 Chapter5
Intrinsic Descriptions
MCAllocate
EBCDIC. The MPE CTRANSLATE intrinsic, or the
NLTRANSLATE intrinsic on MPE XL, may be used.
RemoteTPLen
Required; 16-bit signed integer by value; input. This
parameter contains the length, in characters, of the
RemoteTPName . It must be an integer from 1 through
64.
ResourceID
Required; 16-bit signed integer; output. This number
identifies the conversation being allocated. It must be
used in all subsequent intrinsic calls, so that LU 6.2
API can determine which conversation the intrinsic
calls belong to.
Status
Required; 32-bit signed integer; output. Indicates the
result of intrinsic execution. See the “Status
Parameter” section, earlier in this chapter, for more
information.
ReturnControl
6-bit signed integer by value; input. Specifies when the
local LU will return control to the local TP after
allocating or attempting to allocate a session. Possible
values are as follows:
0 = IMMEDIATE
If an active session is immediately available, it will be
allocated, and control will be returned to the calling
program. If no session is immediately available, no
session will be allocated, and control will be returned to
the calling program.
1 = WHEN_SESSION_ALLOCATED
The requested session will be allocated before control is
returned to the calling program. If no session is
immediately available, the request will be queued, and
the calling program will be suspended until a session is
activated or freed, or until the allocation request fails.
Default: 0 (IMMEDIATE)
SyncLevel
16-bit signed integer by value; input. This parameter
determines the synchronization level (whether or not
confirmation will be used) for this conversation.
Possible values are as follows: