STRAGTSRV

La commande STRAGTSRV (Démarrer services d'agent) démarre tous les services d'agent du système qui sont définis dans un fichier de préférences. Un autre fichier de préférences est également utilisé pour définir le démarrage des services. Les fichiers de préférences sont des fichiers STREAM nommés ableplatform.preferences et able.preferences qui se trouvent dans le répertoire indiqué à l'invite Répertoire fichier préférences (paramètre PREFDIR).

Vous pouvez exécuter la commande ENDAGTSRV (Arrêter services d'agent) pour arrêter les services d'agent démarrés à l'aide de la commande STRAGTSRV.

Restrictions :

• Vous devez disposer des droits spéciaux sur les objets (*ALLOBJ) et d'exploitation des travaux (*JOBCTL) pour exécuter cette commande.

Paramètres

Répertoire fichier préférences (PREFDIR)

Indique le répertoire contenant les fichiers de préférences qui définissent les services d'agent à démarrer et leur mode de démarrage. Les fichiers de préférences doivent être nommés ableplatform.preferences et able.preferences.

*DFT

Utilisez les fichiers de préférences situés dans /QIBM/ProdData/OS400/able/.

nom-chemin

Indiquez le répertoire contenant les fichiers de préférences à utiliser pour démarrer les services d'agent.

Répertoire initial (HOMEDIR)

Indique le répertoire à utiliser comme répertoire principal des services d'agent.

*CURRENT

Utilisez le répertoire principal en cours pour le travail exécutant cette commande. Il s'agit du répertoire principal défini pour le profil utilisateur en cours du travail exécutant la commande STRAGTSRV.

nom-chemin

Indiquez le nom de chemin d'accès au répertoire à utiliser comme répertoire principal pour les JVM (machines virtuelles Java) utilisées par les agents qui s'exécutent dans ces services. Les services utilisent ce répertoire pour trouver les ressources nécessaires.

Chemin classe supplémentaire (CLASSPATH)

Indique le chemin de classe supplémentaire à ajouter au paramètre de chemin de classe de chaque JVM devant démarrer pour exécuter les services d'agent.

*NONE

Aucun chemin de classe supplémentaire ne sera ajouté.

nom-chemin

Indiquez le nom de chemin d'accès du chemin de classe supplémentaire à ajouter au paramètre de chemin de classe de chaque JVM.

Profil utilisateur pour SBMJOB (SBMJOBUSER)

Indique le profil utilisateur à utiliser pour les travaux JVM qui exécuteront les services d'agent. Vous pouvez indiquer qu'une JVM particulière s'exécute sous un profil différent du profil utilisateur en cours du travail exécutant la commande STRAGTSRV.

Vous pouvez indiquer un profil utilisateur secondaire pour 10 travaux JVM au maximum.

Valeurs particulières

*CURRENT

Tous les travaux JVM s'exécuteront sous le profil utilisateur en cours du travail exécutant cette commande.

Elément 1 : Identificateur du pool

valeur-alphanumérique

Indiquez un identificateur qui correspond à une JVM définie dans le fichier de préférences indiqué à l'invite Répertoire fichier préférences (paramètre PREFDIR).

Elément 2 : Profil utilisateur

nom

Indiquez le nom du profil utilisateur à utiliser sur les commandes SBMJOB (Soumettre un travail) pour les JVM. Les travaux JVM s'exécuteront sous le profil utilisateur indiqué plutôt que sous le profil utilisateur en cours du travail exécutant cette commande.

Exemples

Exemple 1 : démarrage avec les valeurs livrées par défaut

STRAGTSRV

Cette commande démarre tous les services d'agent définis dans le fichier par défaut ableplatform.preferences dans "/qibm/prodData/OS400/able/" comme défini dans le fichier par défaut able.preferences dans "/qibm/prodData/OS400/able/". Le répertoire principal de chaque service d'agent correspondra au répertoire principal de l'utilisateur en cours. Tous les travaux soumis pour exécuter les JVM s'exécuteront sous le profil en cours.

Exemple 2 : démarrage avec les valeurs définies par l'utilisateur

STRAGTSRV  PREFDIR('/qibm/userData/OS400/able/test/')
           HOMEDIR('/qibm/userData/OS400/able/test/')
           CLASSPATH('/qibm/userData/OS400/able/test/test.jar')
           SBMJOBUSER((POOL1 TESTPROF1) (POOL3 TESTPROF3))

Cette commande démarre tous les services d'agent définis dans le fichier ableplatform.preferences dans "/qibm/userData/OS400/able/test/" comme défini dans le fichier par défaut able.preferences dans "/qibm/userData/OS400/able/test/". Le répertoire principal de chaque service d'agent sera "/qibm/userData/OS400/able/test/". Le chemin de classe des JVM sera défini de sorte à inclure le fichier JAR test.jar dans "/qibm/userData/OS400/able/test/". Les travaux soumis pour exécuter les JVM pour POOL1 et POOL3 s'exécuteront sous les utilisateurs TESTPROF1 et TESTPROF3 respectivement. Les autres JVM s'exécuteront sous le profil utilisateur en cours.

Messages d'erreur

Messages *ESCAPE

CPF1890

Droit *ALLOBJ requis pour l'opération demandée.

CPF90FF

Droit spécial *JOBCTL requis pour l'opération demandée.

Messages d'erreur liés au travail soumis :

Cette commande soumet un travail par lots qui, à son tour, soumet des travaux par lots supplémentaires où les services d'agent s'exécuteront. Les messages d'erreur suivants peuvent être signalés pour ce travail par lots :

CPF4B01

Service d'agent non soumis. Code raison &1.

CPF4B02

La machine JVM du service d'agent service n'a pas démarré. Code raison &1

CPF4B03

Une erreur JVM s'est produite.