HP-UX SNAplus2 R7 APPC Programmer's Guide

APPC Control Verbs

SET_TP_PROPERTIES

The value of this parameter was returned by the TP_STARTED verb in the invoking TP or by RE-

CEIVE_ALLOCATE in the invoked TP.

set_prot_id

Speciﬁes whether APPC is to modify the protected Logical Unit of Work identiﬁer. Possible values are:

AP_YES

Modify the protected LUWID for this TP.

AP_NO

Leave the protected LUWID unchanged.

new_prot_id

Speciﬁes whether APPC should generate a new protected Logical Unit of Work identiﬁer, or to use the one

speciﬁed on this verb. This parameter is reserved if

set_prod_id is set to AP_NO. Possible values are:

AP_YES

Generate a new protected LUWID.

AP_NO

Set the TP’s protected LUWID to the one supplied on this verb.

prot_id

If set_prot_id is set to AP_YES and new_prot_id is set to AP_NO, this structure speciﬁes the new protected

LUWID for the TP; otherwise this structure is reserved. The structure contains the following parameters:

prot_id.fq_length

The length (1–17 bytes) of the fully qualiﬁed LU name associated with the Logical Unit of Work (the

LU name itself is speciﬁed by the following parameter)

prot_id.fq_luw_name

The fully qualiﬁed LU name associated with the Logical Unit of Work. This name is a 17-byte EBCDIC

string, padded on the right with EBCDIC spaces. It consists of a network ID of 1–8 A-string characters,

an EBCDIC dot (period) character, and an LU name of 1–8 A-string characters.

prot_id.instance

The instance number associated with the Logical Unit of Work (a 6-byte binary number).

prot_id.sequence

The sequence number of the current segment of the Logical Unit of Work (a 2-byte binary number).

set_unprot_id

Speciﬁes whether APPC is to modify the unprotected Logical Unit of Work identiﬁer. Possible values are:

AP_YES

Modify the unprotected LUWID for this TP.

AP_NO

Leave the unprotected LUWID unchanged.

new_unprot_id

Speciﬁes whether APPC should generate a new unprotected Logical Unit of Work identiﬁer, or to use the one

speciﬁed on this verb. This parameter is reserved if set_unprot_id is set to AP_NO. Possible values are:

AP_YES