TP_ENDED

The TP_ENDED verb notifies Personal Communications that a specified transaction program has ended.

VCB Structure

typedef struct tp_ended
{
 unsigned short    opcode;              /* verb operation code   */
 unsigned char     opext;               /* verb extension code   */
 unsigned char     format;              /* format                */
 unsigned short    primary_rc;          /* primary return code   */
 unsigned long     secondary_rc;        /* secondary return code */
 unsigned char     tp_id[8];            /* TP identifier         */
 unsigned char     type;                /* type of TP ended      */
} TP_ENDED;

Supplied Parameters

The transaction program supplies the following parameters to Personal Communications:
opcode
AP_TP_ENDED
opext
AP_BASIC_CONVERSATION
format
Identifies the format of the VCB. Set this field to zero to specify the version of the VCB listed above.
tp_id
Identifier for the local transaction program. The value of this parameter was returned by the TP_STARTED verb for an invoking transaction program, or by the RECEIVE_ALLOCATE verb for an invoked transaction program.
type
Type of TP_ENDED.

AP_HARD
AP_SOFT
AP_ABEND
AP_CANCEL

If type is AP_ABEND, Personal Communications does not reply to the TP_ENDED signal.

Returned Parameters

If the verb executes successfully, Personal Communications returns the following parameter:
primary_rc
AP_OK

Returned Parameters

If the verb does not execute because of a parameter error, Personal Communications returns the following parameters:
primary_rc
AP_PARAMETER_CHECK
secondary_rc
AP_BAD_TP_ID

AP_BAD_TYPE

The conditions generating the following possible primary return codes (primary_rc) are described in APPC Common Return Codes.
  • AP_TP_BUSY
  • AP_UNEXPECTED_SYSTEM_ERROR