HP-UX SNAplus2 R7 Administration Guide

Appendix CConﬁguring an Invokable TP from the Command Line

C.1 File Format for an Invokable TP Deﬁnition

The ﬁle that supplies conﬁguration information for an invokable TP is an ASCII text ﬁle that can be modiﬁed using

any standard text editor. Each entry in the ﬁle has the following format:

[TPname]

PATH = full_pathname_of_executable_file

ARGUMENTS = command-line_arguments_separated_by_spaces

TYPE = QUEUED | QUEUED-BROADCAST | NON-QUEUED

TIMEOUT = nnn

UNIX

USERID = user_ID

GROUP = group_ID

LUALIAS = LU_alias

ENV = environment_variable=value

WINDOWS

SECURITY_TYPE = APPLICATION | SERVICE

SERVICE_NAME = name_of_installed_service

USERID = domain_name\user_ID

The parameters are as follows. For an operator-started TP, the only parameters used are the TP name, the TP type,

the timeout value, and (for an APPC TP on HP-UX) the LU alias; the other parameters apply only to automatically

started TPs.

UNIX

On HP-UX machines, SNAplus2 returns an error message if you enter an invalid parameter.

WINDOWS

On Windows machines, SNAplus2 ignores invalid parameters.

TPname

The name of the TP (1–64 characters, with no embedded space characters). The TP name speciﬁed on

the Receive_Allocate, or on the incoming Allocate request, is matched against this name. If the TP is an

automatically started TP, it must specify this TP name on the Receive_Allocate when it starts up, to enable

SNAplus2 to route the incoming Attach to the correct TP.

This name must be enclosed within square brackets. The name can be speciﬁed as an ASCII string, enclosed

in double quotation marks (for example, ["TPNAME1"]). Alternatively, it can be speciﬁed as a hexadecimal

array representing the EBCDIC characters of the TP name (for example, [<53504E414D45F1>])orasa

200