Environment Variables for OS/2-Based Clients

The following list shows the correct form for the sections and entries to add to the SNA.INI file (located in the root SNA Server directory) for autostarted invokable TPs on an OS/2-based client. The section headings are shown enclosed in square brackets; include the brackets when adding the section to the SNA.INI file.

For each TP type, the applicable variables and their locations are shown in Clients Running OS/2.

[SNAServerAutoTPs]

TPNameX=SectionNameX

For all TPs. Associates TPnameX with SectionNameX. Additional lines may follow TPNameX=SectionNameX, each one using the same syntax to name a different TP and the section containing the information for that TP.

[SectionName]

Forms a section heading for entries applying to one TP; SectionName must match a section name listed under [SNAServerAutoTPs].

PathName=path

Specifies the full path and file name of the executable file. The default is TPNAME.EXE.

LocalLU=LUalias

Specifies the alias of the local LU to be used when this TP is started on this computer.

Parameters=ParameterList

Lists strings to be passed as command line parameters for the TP. Separate parameters with spaces. The default is no parameters.

Timeout=number

Specifies the time, in milliseconds, that an Accept_Conversation will wait before timing out. The default is infinity (no limit).

Queued={ YES | NO }
Queued=OPERATOR

Specifies the type of TP: YES for an autostarted queued TP, NO for an autostarted nonqueued TP, or OPERATOR for an operator-started TP (which must always be queued). The default is YES.

AcceptNames=TPNameList

Lists additional names under which the invokable TP can be invoked. Separate TP names with spaces. The default is none. If an invokable TP does not issue a Specify_Local_TP_Name for each name configured under AcceptNames in the registry, that TP will fail.

ConversationSecurity={ YES | NO }

Indicates whether this TP supports conversation security. The default is NO.

AlreadyVerified={ YES | NO }

Indicates whether this TP can be invoked with a user identifier and password that have already been verified. AlreadyVerified is ignored if ConversationSecurity is set to NO.

For detailed information about the AlreadyVerified variable, see the description for it under Registry Entries for Clients Running Windows NT.

The default is NO.

Username1=Password1
...
UsernameX=PasswordX

Sets one or more user names and passwords to be compared with those sent by the invoking TP. The user name and password can have as many as 10 characters each. Both parameters are case-sensitive. This variable is ignored if conversation security is not activated or if the password has already been verified, as described for the AlreadyVerified entry.

Environment=VariableList

For an autostarted TP, lists the variables to be set in the TP's environment. Separate multiple variables with spaces.

NewScreenGroup={ 1 | 0 }

For an autostarted TP, specifies 1 to indicate that the TP runs in the foreground, or 0 to indicate that the TP runs in the background. The default is 1 (foreground).

IconFile=path

For an autostarted TP, specifies the full path and file name of the icon file. The default is no icon file.

SessionType=number

For an autostarted TP, specifies a value used by OS/2; see the note following. The default is 0.

PgmControl=number

For an autostarted TP, specifies a value used by OS/2; see the note following. The default is 32768.

InitXPos=number

For an autostarted TP, specifies a value used by OS/2; see the note following. The default is 80.

InitYPos=number

For an autostarted TP, specifies a value used by OS/2; see the note following. The default is 80.

InitXSize=number

For an autostarted TP, specifies a value used by OS/2; see the note following. The default is 470.

InitYSize=number

For an autostarted TP, specifies a value used by OS/2; see the note following. The default is 330.

Note  SessionType, PgmControl, InitXPos, InitYPos, InitXSize, and InitYSize are filled directly into the STARTDATA structure passed to the OS/2 DosStartSession call for the new session.