• Created by user-2c621, last updated by user-eb51a on Apr 05, 2023 3 minute read

18.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 18.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.

  • No labels