HP-UX SNAplus2 R7 Administration Guide

Appendix CConﬁguring an Invokable TP from the Command Line

APPLICATION

The TP executable is started as an application using the CreateProcess system call.

SERVICE

The TP executable is started as a service using the StartService system call. In this case, the

service must have been previously installed with the Service Control Manager using the name speciﬁed

by the

SERVICE_NAME parameter.

This value refers to a TP running as a Windows Service (not to an SNA service TP with a name

consisting of 4 characters speciﬁed in hexadecimal). Windows allows only one copy of a Service to be

running at a time, and so the TYPE parameter should not be set to NON-QUEUED; if you specify this

value, the value QUEUED-BROADCAST will be used instead.

SERVICE_NAME

This parameter applies only to Win32 clients.

The name of the service installed with the Service Control Manager. This parameter is only used if the

SECURITY_TYPE is SERVICE.

USERID

Specify the domain and user ID that the client should use to start the TP when the SECURITY_TYPE is

APPLICATION. The format for this parameter is domain_name\user_ID if the Windows Client computer is

part of a domain, or computer_name\user_ID (indicating the Windows Client’s own computer name instead

of a domain name) if the Windows Client computer is not part of a domain.

The client attempts to start the TP in the speciﬁed user’s logon session. If USERID is blank or unspeciﬁed,

the TP is started in the console session. If the speciﬁed user is not logged on, or no user is logged on at the

console, the TP is not started and the SNAplus2 server is notiﬁed of the failure.

Note the following points about the format of these entries:

• You can include a comment line by including # as the ﬁrst character of the line; SNAplus2 then ignores this

line. SNAplus2 also ignores completely blank lines.

• Each parameter=value entry must be on one line; it cannot contain line-break characters. The maximum length

of a line is 255 characters; additional characters are ignored.

• White space (space characters and tab characters) at the start or end of a line, or before or after the = character,

is ignored (except in the string environment_variable=value for the ENV parameter).

• Each TP deﬁnition begins with the line identifying the TP name, and ends with the end of the ﬁle or the next

TP name.

• Except for the ENV line, which can occur up to 64 times, do not specify the same parameter more than once

for the same TP. If you do specify the same parameter more than once, only the last instance of each keyword

is used.

204