(iseries)

Configure Qshell to run WebSphere scripts

We can configure Qshell to run product scripts for IBM i.

In a default installation, unless otherwise specified, all WebSphere Application Server scripts are in the app_server_root/bin directory.

The scripts must be run from Qshell. To ensure that you use the correct version and directory, run QShell commands using one of the following methods:

• Invoke the fully qualified path name of the script:
  app_server_root/bin/script_name parameters

  where script_name is the name of the script and parameters represents the parameters that are passed to the script.

• Invoke the script from the IBM i command line or from an IBM i CL program. To use this method, run the STRQSH command and specify the fully qualified path name of the script:
  STRQSH CMD('app_server_root/bin/script_name parameters')

  where script_name is the name of the script and parameters represents the parameters that are passed to the script.

• Change directories to the app_server_root/bin directory and run the following script:
  cd app_server_root/bin script_name parameters

  where script_name is the name of the script, and parameters represents the parameters that are passed to the script.

• We can update the PATH environment variable to automatically locate the script when you run it. After you update the PATH variable, we can run these scripts from any directory. To update the PATH environment variable, perform the following steps:

  1. Edit the .profile file in the /home/user_profile_name directory, where user_profile_name is the name of the IBM i user profile.

     If this file does not exist, create it in this directory. We can use the EDTF command from an IBM i command line or use any editor from a workstation. Also note that .profile is the full name of the file. When you start Qshell, it searches for the .profile file, and runs the commands listed in it. We can use the .profile file to set persistent environment variables for the Qshell session.

  2. Add the following line to the .profile file:
     export PATH=app_server_root/bin:$PATH

  3. Save the file.

What to do next

The updates to .profile do not take effect until you restart Qshell (if you had a session open) or start .profile with the ./home/user_profile_name/.profile command.

To change the path for a single Qshell session instead of changing the default path for all Qshell sessions, run the export commands shown in the last step during the Qshell session, but do not edit the .profile.

Related tasks

Scripting and command line reference material