HP-UX SNAplus2 R7 APPC Programmer's Guide

APPC Control Verbs

TP_STARTED

unsigned short opcode;

unsigned char opext;

unsigned char reserv2;

unsigned short primary_rc;

unsigned long secondary_rc;

unsigned char lu_alias[8];

unsigned char tp_id[8];

unsigned char tp_name[64];

} TP_STARTED;

3.1.3 Supplied Parameters

The TP supplies the following parameters to APPC:

opcode

AP_TP_STARTED

lu_alias

Alias by which the local LU is known to the local TP. This name must match an LU alias established during

conﬁguration.

This parameter is an 8-byte ASCII character string. It can consist of any of the following characters:

• Uppercase letters

• Numerals 0–9

• Blanks

• Special characters $, #, %, and @

The ﬁrst character of this string cannot be a blank (unless the whole string consists of blanks).

If the LU alias is shorter than eight characters, pad it on the right with ASCII blanks (0x20).

Depending on the conﬁguration, you may be able to specify that the application uses a default local LU (check

with your System Administrator); to do this, set lu_alias to a string of eight binary zeros. For compatibility

with other APPC implementations, SNAplus2 also accepts a string of eight ASCII blanks to indicate the

default LU; however, new applications should use binary zeros.

tp_name

Name of the local TP. The ﬁrst eight characters of this name are translated into ASCII, and used by SNAplus2

administration programs to identify the TP in a list of running APPC TPs.

This parameter is a 64-byte case-sensitive EBCDIC character string. The tp_name parameter normally consists

of characters from the type-AE EBCDIC character set (unless it is the name of a service TP). These characters

are as follows:

• Uppercase and lowercase letters

• Numerals 0–9

• Special characters $, #, @, and period (.)

If the TP name is fewer than 64 bytes, use EBCDIC blanks (0x40) to pad it on the right.

The SNA convention for naming a service TP is an exception to the normal tp_name parameter; the name

consists of up to four characters, of which the ﬁrst character is a hexadecimal byte between 0x00 and 0x3F.

The other characters are from the EBCDIC AE character set.