17 4 12 PSxx Server Parameters

LANSA Technical

previous page next page

17.4.12 PSxx Server Parameters

Please note these parameters are primarily provided to aid developers in testing applications in SuperServer mode. It is very strongly recommended that you use your own entry point function in production applications. This function should establish any required SuperServer user profile and connections details and then connect via the Built-In Functions described below.

An additional specialized set of parameters may be used on the X_RUN command to establish an automatic connection to a single server (called the "PS" or "Primary Server").

These parameters are specifically designed to be used in conjunction with the DBID=*ANY/*AS400/*OTHER parameter described earlier.

These parameters will be ignored unless one of the special values DBID=*ANY, DBID=*AS400 or DBID=*OTHER is used to trigger their use..

These specialized parameters directly equate to, and default like arguments to server Built-In Functions as described in the LANSA Technical Reference Guide.

When connecting to a Server with DBID=*ANY, the following PSxx arguments can be used:

Param	Directly Equates to this Built-In Function:	Argument Number
PSLU	DEFINE_ANY_SERVER	2 (LU partner name)
PSCC	DEFINE_ANY_SERVER	3 (Commitment control)
PSEA	DEFINE_ANY_SERVER See PSEA Notes (Primary Server Exceptional Arguments)	4 (X_RUN exceptional arguments)
PSDL	DEFINE_ANY_SERVER	5 (Divert locks)
PSWM	DEFINE_ANY_SERVER	6 (Show please wait message)
PSEP	DEFINE_ANY_SERVER	7 (Server execution priority)
PSCT	DEFINE_ANY_SERVER	8 (Client to Server table)
PSST	DEFINE_ANY_SERVER	9 (Server to Client table)
PSPW	CONNECT_SERVER	2 (Password)
PSTC	CONNECT_SERVER. See PSTC Notes (Primary Server Trusted Connection)	3 (Use Kerberos Authentication)
PSUS	See PSUS Notes (Primary Server User)
PSTY	See PSTY Notes (Primary Server Type).
PSRA	See PSRA Notes (Primary Server Route Authority)
PSRR	See PSRR Notes (Primary Server Route Repository)

The SSN (Symbolic Server Name) used when automatically connecting to a server with DBID=*ANY is always DTASERVER. This value cannot be changed.

When connecting to an IBM i with DBID=*AS400, the following PSxx arguments can be used:

Param	Directly Equates to this Built-In Function:	Argument Number
PSLU	DEFINE_OS_400_SERVER	2 (LU partner name)
PSCC	DEFINE_OS_400_SERVER	3 (Commitment control)
PSDB	DEFINE_OS_400_SERVER	4 (DBCS capable)
PSDL	DEFINE_OS_400_SERVER	5 (Divert locks)
PSWM	DEFINE_OS_400_SERVER	6 (Show please wait message)
PSEP	DEFINE_OS_400_SERVER	7 (Server execution priority)
PSCT	DEFINE_OS_400_SERVER	8 (Client to Server table)
PSST	DEFINE_OS_400_SERVER	9 (Server to Client table)
PSPW	CONNECT_SERVER	2 (Password)
PSUS	See PSUS Notes (Primary Server User)
PSTC	CONNECT_SERVER. See PSTC Notes (Primary Server Trusted Connection)	3 (Use Kerberos Authentication)
PSTY	See PSTY Notes (Primary Server Type).
PSRA	See PSRA Notes (Primary Server Route Authority)
PSRR	See PSRR Notes (Primary Server Route Repository)

The SSN (Symbolic Server Name) used when automatically connecting to an IBM i server with DBID=*AS400 is always AS400. This value cannot be changed.

When connecting to a Server with DBID=*OTHER, the following PSxx arguments can be used:

Param	Directly Equates to this Built-In Function:	Argument Number
PSLU	DEFINE_OTHER_SERVER	2 (Server network name)
PSDL	DEFINE_OTHER_SERVER	3 (Divert locks)
PSWM	DEFINE_OTHER_SERVER	4 (Show please wait message)
PSEA	DEFINE_OTHER_SERVER See PSEA Notes (Primary Server Exceptional Arguments)	5 (X_RUN exceptional arguments)
PSTC	CONNECT_SERVER. See PSTC Notes (Primary Server Trusted Connection)	3 (Use Kerberos Authentication)
PSPW	CONNECT_SERVER	2 (Password)
PSUS	See PSUS Notes (Primary Server User)
PSTY	See PSTY Notes (Primary Server Type).
PSRA	See PSRA Notes (Primary Server Route Authority)
PSRR	See PSRR Notes (Primary Server Route Repository)

The SSN (Symbolic Server Name) used when automatically connecting to a non-IBM i server with DBID=*OTHER is always DTASERVER. This value cannot be changed.

When these parameters are used in conjunction with the DBID=*ANY/*AS400/*OTHER parameter, the first function or component to be invoked will act as if it used these Built-In Functions during its start up logic:

DEFINE_ANY_SERVER, DEFINE_OS_400_SERVER or DEFINE_OTHER_SERVER to define the server as per the PSxx= parameter

CONNECT_SERVER to establish the connection

CONNECT_FILE to connect all files (file name "*" is used) to the server.

Note: The connection uses the default blocking factor on all files. This means that SELECT / UPDATE / ENDSELECT and SELECT / DELETE / ENDSELECT loops that are updating the last record read (i.e. the DELETE or UPDATE has no WITH_KEY or WITH_RRN parameter) may not process as expected. Refer to the CONNECT_FILE Built-In Function for more details of this problem and how to correct it. Another method of correcting this problem is described in 17.4.7 INIT and TERM Parameters.

If any of these actions fail then the function will fail during start up. This cannot be trapped. To use trapping, avoid using the PSxx= parameters and initially invoke your own start up function instead.

previous page start next page