Configurer les chemins par défaut de QSH – Optimisez votre productivité sur IBM i
mer 12 juillet 2023Pourquoi configurer les chemins par défaut ?
Si vous utilisez régulièrement QSH (QShell) sur IBM i, vous savez à quel point il peut être fastidieux de saisir le chemin complet de chaque commande à chaque utilisation. En configurant les variables d’environnement PATH, vous simplifiez votre workflow, gagnez du temps et réduisez les risques d’erreurs.
Que vous travailliez sur des scripts d’automatisation, des bases de données comme MariaDB, ou simplement pour optimiser votre productivité quotidienne, cette configuration est indispensable.
La configuration de QSH se fait à 2 niveaux, une globale qui s’applique à toutes les connexions et une ciselée par profil.
Configuration globale (pour tous les utilisateurs)
La configuration globale s’applique à tous les utilisateurs du système. Elle est stockée dans le fichier /etc/profile.
Étapes à suivre :
- Créer le fichier
/etc/profile:
touch /etc/profile- Éditer le fichier avec la commande
EDTF:
EDTF STMF('/etc/profile')
- Ajouter les chemins par défaut :
Insérez la ligne suivante pour définir les répertoires où QSH doit chercher les commandes :
# Exemple de configuration pour /etc/profile
export PATH=/usr/bin:.:/QOpenSys/usr/binExplication :
/usr/bin: Répertoire standard pour les commandes Unix..: Répertoire courant (permet d’exécuter des commandes locales)./QOpenSys/usr/bin: Répertoire des outils open source sur IBM i.
- Sauvegarder et quitter :
- Appuyez sur F3 pour sauvegarder.
- Appuyez à nouveau sur F3 pour quitter l’éditeur.
- Appliquer les permissions de sécurité :
Pour des raisons de sécurité, limitez les droits d’écriture à l’administrateur et autorisez la lecture/exécution pour tous :chmod 644 /etc/profile
Configuration locale (pour un utilisateur spécifique)
Si vous souhaitez une configuration personnalisée pour un seul utilisateur, créez un fichier .profile dans son répertoire personnel (/home/[USER]/).
Étapes à suivre :
- Créer le fichier
.profile:
touch /home/[USER]/.profileRemplacez
[USER]par le nom de l’utilisateur (ex :/home/olivier/.profile).
- Éditer le fichier :
EDTF STMF('/home/[USER]/.profile')- Ajouter les chemins personnalisés :
Exemple :
# Exemple de configuration pour /home/olivier/.profile
export PATH=/usr/bin:.:/QOpenSys/usr/bin:/mon_repertoire/perso- Sauvegarder et quitter (F3 + F3).
🔍 Hiérarchie des fichiers de configuration
QSH applique les configurations dans l’ordre suivant :
/home/[USER]/.profile(si le fichier existe)./etc/profile(configuration globale par défaut).
💡 Astuce : Pour vérifier si votre configuration est bien prise en compte, utilisez la commande :
echo $PATH
⚠️ Bonnes pratiques de sécurité
- Droits d’accès :
/etc/profiledoit être lisible par tous (chmod 644 /etc/profile).- Seuls les administrateurs doivent avoir le droit d’écriture.
- Vérification des permissions :
ls -l /etc/profileSi les permissions ne sont pas correctes, utilisez
chmodpour les ajuster.
🛠 Dépannage
Problèmes courants et solutions :
| Problème | Solution |
|---|---|
| Les chemins ne sont pas pris en compte. | Vérifiez les permissions avec ls -l /etc/profile ou ls -l /home/[USER]/.profile. |
| Erreur |
En conclusion
Quand des fichiers de configuration existent, QSH va appliquer la configuration de /home/[USER]/.profile si elle existe sinon celle de /etc/profile.
Nous avons vu pour les chemins par défaut, mais vous pouvez aussi utiliser d’autre variables à exporter.
Cette article est basé sur la documentation du site d’IBM Customizing the Qshell environment – IBM Documentation
Pour aller plus loin, consultez notre guide sur l’installation de MariaDB sur IBM i
Avez-vous déjà configuré QSH ? Partagez vos astuces en commentaire !


[…] Dans ce qui suit, afin de faciliter la saisie des commandes de MariaDb, je vous conseille de configurer les chemins par défaut pour QSH. […]
[…] Pour éviter de mettre les chemins complets des commandes que vous souhaitez utiliser, vous pouvez configurer les chemins par défaut. […]