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