17 4 12 PSxx Server Parameters

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.