HP-UX SNAplus2 R7 APPC Programmer's Guide

APPC Conversation Verbs
MC_SEND_DATA and SEND_DATA
[MC_]PREPARE_TO_RECEIVE. For the basic-conversation SEND_DATA verb, the data
sent on this verb must be a complete logical record or the end of a logical record; this value cannot be
used if an incomplete logical record is being sent.
AP_SEND_DATA_DEALLOC_FLUSH
Perform the function of the [MC_]DEALLOCATE verb with dealloc_type set to AP_FLUSH. This
is equivalent to issuing [MC_]SEND_DATA followed by [MC_]DEALLOCATE. For the basic-
conversation SEND_DATA verb, the data sent on this verb must be a complete logical record or the
end of a logical record; this value cannot be used if an incomplete logical record is being sent.
AP_SEND_DATA_DEALLOC_CONFIRM
This option is valid only in a half-duplex conversation. Do not use it if the opext parameter includes
the option AP_FULL_DUPLEX_CONVERSATION.
Perform the function of the [MC_]DEALLOCATE verb with dealloc_type set to AP_CONFIRM_TYPE.
This is equivalent to issuing [MC_]SEND_DATA followed by [MC_]DEALLOCATE. For the basic-
conversation SEND_DATA verb, the data sent on this verb must be a complete logical record or the
end of a logical record; this value cannot be used if an incomplete logical record is being sent.
AP_SEND_DATA_DEALLOC_SYNC_LEVEL
Perform the function of the [MC_]DEALLOCATE verb with dealloc_type set to AP_SYNC_LEVEL.
This is equivalent to issuing [MC_]SEND_DATA followed by [MC_]DEALLOCATE. For the basic-
conversation SEND_DATA verb, the data sent on this verb must be a complete logical record or the
end of a logical record; this value cannot be used if an incomplete logical record is being sent.
AP_SEND_DATA_DEALLOC_ABEND
Perform the function of the MC_DEALLOCATE verb with dealloc_type set to AP_ABEND,or
the DEALLOCATE verb with dealloc_type set to AP_ABEND_PROG. This is equivalent to issuing
[MC_]SEND_DATA followed by [MC_]DEALLOCATE.
You cannot use [MC_]SEND_DATA to perform the function of [MC_]DEALLOCATE in the follow-
ing cases:
• The conversation type is AP_BASIC_CONVERSATION, and the required dealloc_type is
AP_ABEND_SVC or AP_ABEND_TIMER
• The conversation’s synchronization level is AP_SYNCPT, and the TP requires implied forget
notification
In these cases, you need to issue [MC_]SEND_DATA and [MC_]DEALLOCATE separately. See
the description of the [MC_]DEALLOCATE verb in Chapter 4, APPC Conversation Verbs for more
information.
UNIX
data_type
Specifies the format of the data being sent. This parameter is used only by the mapped-conversation
MC_SEND_DATA verb. Possible values are:
AP_APPLICATION
Standard APPC application data. SNAplus2 sends the data to the partner LU in Application Data GDS
variables.
AP_USER_CONTROL_DATA
User Control data. SNAplus2 sends the data to the partner LU in User Control Data GDS variables.
Do not set this option unless the partner LU can accept data in this format.
AP_PS_HEADER
219