HP-UX SNAplus2 R7 APPC Programmer's Guide

APPC Conversation Verbs
MC_SEND_CONVERSATION and SEND_CONVERSATION
This parameter is required only if the security parameter is set to AP_PGM or AP_PGM_STRONG; otherwise
it is reserved.
The pwd and user_id parameters must match a user ID/password pair configured on the computer where the
invoked TP is located.
This parameter is a 10-byte EBCDIC character string; it is case-sensitive. The user_id parameter can consist
of characters from the type-AE EBCDIC character set. These characters are as follows:
• Uppercase and lowercase letters
• Numerals 0–9
• Special characters $, #, @, and period (.)
If the user ID is fewer than 10 bytes, use EBCDIC blanks (0x40) to pad it on the right.
pip_dlen
Length of the program initialization parameters (PIP) to be passed to the partner TP.
The range for this value is 0–32,767.
Not all APPC implementations can receive PIP data (although they may be able to send it); in addition, CPI-C
does not support PIP data. Set pip_dlen to 0 (zero) if the partner TP is using an implementation of APPC
that does not support PIP data, or if the partner is a CPI-C application.
pip_dptr
Address of buffer containing PIP data.
Use this parameter only if pip_dlen is greater than 0 (zero).
PIP data can consist of initialization parameters or environment setup information required by a partner
TP or remote operating system. The PIP data must follow the General Data Stream format. For further
information, refer to the IBM publication Systems Network Architecture Format and Protocol Reference
Manual: Architecture Logic for LU Type 6.2.
fqplu_name
Fully qualified LU name of the partner LU. This parameter is used only if plu_alias is set to zeros. The name
must match the name of a partner LU established during configuration.
This name is a 17-byte EBCDIC string, padded on the right with EBCDIC spaces, containing one of the
following:
• A network ID of 1–8 A-string characters, an EBCDIC dot (period) character, and an LU name of 1–8
A-string characters
• An LU name of 1–8 A-string characters (without the network ID or the EBCDIC dot)
dlen
Number of bytes of data to be sent. The range for this value is 0–65,535.
dptr
Address of the buffer containing the data to be sent.
WINDOWS
The data buffer can reside in a static data area or in a globally allocated area. The data buffer must fit entirely
within this area.
4.15.6 Returned Parameters
After the verb executes, APPC returns parameters to indicate whether the execution was successful and, if not, to
indicate the reason the execution was not successful.
212