TP_STARTED

The TP_STARTED verb notifies Personal Communications that a program has requested resources for a transaction program initiated as a result of a local command, rather than an incoming allocation request.

VCB Structure

typedef struct tp_started
{
 unsigned short   opcode;                /* verb operation               */
 unsigned char    opext;                 /* verb extension               */
 unsigned char    format;                /* format                       */
 unsigned short   primary_rc;            /* primary return code          */
 unsigned long    secondary_rc;          /* secondary return code        */
 unsigned char    lu_alias[8];           /* LU alias                     */
 unsigned char    tp_id[8];              /* TP identifier                */
 unsigned char    tp_name[64];           /* TP name                      */
} TP_STARTED;

Supplied Parameters

The transaction program supplies the following parameters to Personal Communications:
opcode
AP_TP_STARTED
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.
lu_alias
Alias by which the local LU is known. If it is set to zero, Communications Server uses the control point LU. This is an 8-byte string in a locally displayable character set. For Personal Communications, use the default local LU, if specified, otherwise use the control point LU. This is an 8–byte string in a locally displayable character set. All 8 bytes are significant and must be set. A blank lu_alias field is accepted. In this case Communications Server uses the control point LU and Personal Communications uses the default local LU, if specified, otherwise Personal Communications uses the control point LU.

Displays a Communications Server product icon.
The following information only applies on the Communications Server Win32 SNA API clients.

The default local LU alias for each user can be assigned using the appropriate configuration utility, either INI configuration or LDAP.

APPC programs can choose to use a default local LU alias rather than specify one directly. When an APPC program issues a TP_START verb with the local_LU_alias field set to binary zeroes, the APPC API uses the configured default local LU alias.

tp_name
Name of the transaction program. Personal Communications does not check the character set of this field.

Returned Parameters

If the verb was executed successfully, Personal Communications returns the following parameters:
primary_rc
AP_OK
tp_id
Identifier for the local transaction program. This value is assigned by Personal Communications to the transaction program. The transaction program passes this identifier to Personal Communications on all subsequent APPC verbs.
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_INVALID_LU_NAME

AP_INVALID_ENABLE_POOL

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