HP-UX SNAplus2 R7 Administration Guide

Appendix CConfiguring an Invokable TP from the Command Line
• Ensure that the TP appends data to an existing file instead of creating the file (so that all copies of
the TP append data to the same file)
• Design the TP to generate file names at run-time, based on the process ID with which the TP is
running (so that each copy of the TP writes to a different file).
This line is optional. If it is not included, or if an invalid value is specified, the default is QUEUED.
TIMEOUT
The maximum length of time, in seconds, that a Receive_Allocate call issued by the TP should block if there
is no incoming Allocate request pending. If no incoming Allocate is received in this time, the call fails with
a return code indicating “State check - Allocate not pending.”
A timeout value of 0 indicates that the call always fails unless an incoming Allocate is already pending when
the call is issued. A timeout value of
−1 indicates that the call waits indefinitely for an incoming Allocate
and does not time out.
This line is optional. If it is not included, or if an invalid value (a non-numeric value) is speci
fied, the default
is −1 (infinite).
Do not specify this parameter if the
TYPE parameter is set to NON-QUEUED. SNAplus2 uses a timeout value
of 0 for nonqueued TPs, because the TP is always started in response to an incoming Allocate and so there
is always one pending.
UNIX
USERID
Specify the user ID that SNAplus2 uses to start the TP. The TP is started in the home directory associated
with this user ID. This home directory is also the default path for trace files and any other files accessed by
the TP (unless the application overrides it by specifying a full path). If the application specifies a file name
without a path, SNAplus2 searches for the file in this home directory; if the application specifies a file name
with a relative path, SNAplus2 searches for the file in the specified directory relative to this home directory.
This line is required, and must be specified. The ID must be a valid login ID on the SNAplus2 computer; it
can be up to 64 characters, unless your HP-UX configuration restricts user names to fewer characters.
The executable file for the TP, specified by the PAT H parameter, must have execute permission for the
specified user. In addition, if USERID is set to root, the file must be owned by root and must have setuid
and setgid permission in order to be started automatically by SNAplus2.
GROUP
Specify the group ID that SNAplus2 uses to start the TP. This must be a valid group ID on the SNAplus2
computer; it can be up to 64 characters, unless your HP-UX configuration restricts group names to fewer
characters.
This line is optional; if it is not included, the default is other.
LUALIAS
Specify the local LU alias from which the TP is to accept incoming Attaches.
Note
This parameter can be used only if the TP is an APPC TP. If the TP is a CPI-
C application, do not specify this parameter. CPI-C does not support accepting
incoming Attaches from a particular local LU; specifying an LU alias (even a blank
LU alias) for a CPI-C application will cause errors in routing the incoming Attach
to the TP.
This is an eight-character name that must match the name of a SNAplus2 local APPC LU.
202