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

Chapter 5 93
Intrinsic Descriptions
MCGetAllocate
MCGetAllocate
Establishes a conversation initiated by a remote TP.
Syntax
I16V CA CA I16
MCGetAllocate( TPID , SessionType , LocalTPName , ResourceID ,
I32 I16 I16V I16V
Status , [ SyncLevel ], [ Timer ], [ Security ],
I16V I16A CA CA CA
[ NumPIPs ], [ PIPLengths ], [ 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; output. 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.
LocalTPName Required; character array; output in EBCDIC on
MPE V; input in ASCII on MPE XL.;
NOTE If you are migrating a TP to LU 6.2 API/XL from LU 6.2 API/V or from
a version of LU 6.2 API/XL prior to the Node Type 2.1 version, you must
change the
LocalTPName parameter from an output parameter to an
input parameter.
On MPE V,
LocalTPName is an output parameter, received in EBCDIC
from the remote TP. It contains the name of the job file sent by the
remote TP. The job file name must be 8 characters long; if it is shorter
than 8 characters long, it must be padded with blanks. The job file must
be located in the APPC.SYS group and account. When the HP 3000
receives the job file name, it streams the job, which runs the local TP.
Because LU 6.2 API performs no translation on the
LocalTPName array,