4.1.2 Add a new Linux User Id

The user must have permission to read files under the LANSAXROOT directory and subdirectories, and permission to execute the files in the $LANSAXROOT/x_lansa/bin directory. The easiest way to accomplish these goals is to add the user to the LANSA owner's primary group.

During execution, LANSA may need to create or update files in particular directories. If the user does not have permission to create files in those directories, processing may continue as expected, without the creation of the file (for example, when attempting to produce trace information), or processing may fail. It is important that you determine which directories users need permission to create files in, and confirm that users have appropriate rights.

To help you with your planning, here are some of the default locations for the most common files created during LANSA processing:

• If LANSA Communications Tracing and logging is enabled, lroute.trc and lroute.log are created or updated in the $LANSAXROOT directory. To change the location, refer to Linux Configuration Files in the LANSA Communications Setup Guide.

• If LANSA internal tracing is enabled (x_run argument ITRO=Y), x_err.log, x_tracennn.txt and temporary files are created in the $LANSAXROOT/log directory. To change the location, refer to TPTH= in Standard X_RUN Parameters in the Technical Reference Guide.

• By default, the .RRN files (which must be in the same location for all users), are created in the partition directory. For example, for the DEM partition, this is $LANSAXROOT/x_lansa/x_dem. To change the location, refer to RPTH= in Standard X_RUN Parameters in the Technical Reference Guide.

• If PRTR=*PATH, reports are created in the partition directory. For example, for the DEM partition, this is $LANSAXROOT/x_lansa/x_dem. To change the location, refer to PPTH= in Standard X_RUN Parameters in the Technical Reference Guide.