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

96 Chapter5
Intrinsic Descriptions
MCGetAllocate
NOTE If the remote TP sends more PIPs than the value specified in the
NumPIPs parameter, the PIPLengths parameter and all PIPs are
ignored. A status info value of -1010 is returned.
PIPLengths 16-bit signed integer array; input/output. This is an
array of up to 16 integers that indicate the lengths, in
bytes, of the Program Initialization Parameters
(
PIP1 ... PIP16 ). The combined length of all the PIPs
must not be greater than 1980 bytes.
Input:
The values the local TP passes in
PIPLengths indicate
the maximum number of characters each PIP can
receive.
Output:
The values the intrinsic returns in PIPLengths indicate
the actual lengths of the PIPs sent by the remote to the
local TP.
NOTE If NumPIPs is greater than 0, the PIPLengths parameter is required. If
NumPIPs is zero, the PIPLengths parameter is ignored.
PIP1, PIP2,...PIP16
character array; output; EBCDIC. Each PIP is a
character array containing a Program Initialization
Parameter received from the remote TP. PIPs are used
to transmit any special information the remote TP
wants to send to the local TP at conversation initiation.
The combined length of all the PIPs must not be greater
than 1980 bytes.
Because LU 6.2 API performs no translation on this
array, the local TP must convert it from EBCDIC to
ASCII. The MPE CTRANSLATE intrinsic, or the intrinsic
on MPE XL, may be used
NOTE If NumPIPs is greater than 0, the specified number of PIPs must be
supplied. If NumPIPs is zero, all PIPs are ignored.
Description
MCGetAllocate is called to receive a conversation allocation request
from the remote TP and initialize all the resources the local TP needs to
conduct a conversation. When the remote TP issues the equivalent of
the MCAllocate intrinsic, it sends a TP name to the HP 3000,
indicating the local TP with which it wants a conversation. The