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

Chapter 5 75
Intrinsic Descriptions
MCAllocate
MCAllocate
Establishes a conversation initiated by a local TP.
Syntax
I16V CA CA I16V
MCAllocate ( TPID , SessionType , RemoteTPName , RemoteTPLen ,
I16 I32 I16V I16V
ResourceID , Status , [ ReturnControl ], [ SyncLeve l],
I16V I16V I16V I16A
[ Timer ], [ Security ], [ NumPIPs ], [ PIPLengths ],
CA CA CA
[ PIP1 ,] [ PIP2 ,] . . . [ PIP16 ]);
Parameters
TPID
Required; 16-bit signed integer by value; input. This
number is assigned to the specific instance of the TP
during the execution of the TPStarted intrinsic. (More
than one instance of the same TP may be executing at
once, and the
TPID uniquely identifies a single instance
of a TP.)
SessionType
Required; character array; input. This is an
8-character ASCII array, left justified and padded with
blanks. It contains the name of a session type that is
configured for the APPC subsystem. For more
information on session types and configuration of the
APPC subsystem, see the LU 6.2 API/V Node
Manager’s Guide or the APPC Subsystem on MPE XL
Node Manager’s Guide.
RemoteTPName
Required; character array; input; EBCDIC. This is an
array of up to 64 EBCDIC characters. It contains the
name of the remote TP to be connected at the other end
of the conversation. The remote TP must be written to
use mapped conversations.
Because LU 6.2 API performs no translation on this
array, the local TP must convert it from ASCII to