STRSBS

Démarrer un sous-système

En bref

La commande STRSBS (Démarrer un sous-système) permet de démarrer un sous-système à l'aide de la description de sous-système indiquée dans la commande.

STRSBS se lit STR (Démarrer) + SBS. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

STRSBS SBSD(…)

Paramètres

SBSD Description de sous-système obligatoire

Astuce : dans une session 5250, tapez STRSBS puis F4 pour l'invite de saisie, et F1 sur un paramètre pour son aide.

Aide IBM i de la commande

Texte du F1, IBM i 7.5 en français (bibliothèque QSYS)

Où s'exécute : Tous les environnements (*ALL)
Compatible multitâche : Non

La commande STRSBS (Démarrer un sous-système) permet de démarrer un sous-système à l'aide de la description de sous-système indiquée dans la commande. Une fois celui-ci démarré, le système lui attribue les ressources nécessaires et disponibles indiquées dans la description de sous-système : mémoire, postes de travail et files d'attente de travaux.

Allocation de mémoire : La mémoire est allouée au sous-système conformément aux définitions de pool de mémoire qui apparaissent dans la description de sous-système, en commençant par les définitions portant les plus petits numéros. Si toutes les définitions de pool ne peuvent pas être allouées en raison du dépassement du nombre maximal de pools mémoire sur le système ou en raison d'une mémoire disponible insuffisante, des messages indiquant les pools qui n'ont pas pu être alloués sont envoyés à l'opérateur système. Si la mémoire devient disponible ultérieurement ou si le nombre de pools mémoire actifs est réduit, les ressources disponibles sont automatiquement allouées au sous-système pour répondre aux exigences non remplies de celui-ci. Tout travail qui s'exécute normalement dans un pool de mémoire non alloué va s'exécuter dans le pool de mémoire partagé *BASE.

Allocation de postes de travail : Les postes de travail sont alloués au sous-système conformément aux postes écrans de la description de sous-système. Chaque poste de travail dont le nom (ou le type, si le post n'est pas indiqué par son nom) figure dans un des postes écran de la description de sous-systèmes et dont le poste indique AT(*SIGNON) est alloué à ce sous-système, sauf s'il a actuellement ouvert une session sur un autre sous-système. L'invite d'ouverture de session s'affiche sur chaque poste de travail alloué. Les postes de travail qui sont déjà connectés dans un autre sous-système restent alloués à ce sous-système tant que le sous-système qui a permis l'ouverture de session n'est pas arrêté, ou tant que l'utilisateur n'a pas transféré le travail à ce sous-système.

Si plusieurs sous-systèmes indiquent le même poste de travail dans leurs postes écran, chaque sous-système, au fur et à mesure qu'il est démarré, tente d'allouer ce poste de travail. Chacun des sous-systèmes suivants alloue ce poste de travail sauf si un utilisateur ouvre une session lors de l'allocation du poste de travail à l'un des sous-systèmes démarrés précédemment. Lors de la fermeture de session d'un poste de travail, celui-ci reste alloué au même sous-système tant qu'un autre sous-système indiquant ce poste de travail n'est pas démarré. Cependant, si un poste de travail est mis hors fonction et que plusieurs sous-systèmes actifs indiquent ce poste de travail, le sous-système auquel le poste de travail est alloué lors de la mise en fonction de celui-ci est imprévisible.

Allocation de files d'attente de travaux : Si une file d'attente de travaux est indiquée dans les postes travaux de la description de sous-système, la file d'attente de travaux est allouée au sous-système. Si la file d'attente de travaux n'existe pas ou qu'elle est déjà allouée à un sous-système actif, aucune file d'attente de travaux n'est allouée au sous-système et un message est envoyé à l'opérateur système. Si la file d'attente de travaux devient disponible ultérieurement, elle est automatiquement allouée au sous-système.

Restrictions :

Pour utilisez cette commande, vous devez disposer des droits suivants :
- le droit d'utilisation (*USE) sur la description de sous-système et le droit d'exécution (*EXECUTE) sur la bibliothèque contenant cette description.
- le droit d'exploitation des travaux (*JOBCTL),
- le droit d'utilisation (*USE) sur toutes les descriptions d'unités d'ASP du groupe d'ASP si le description de sous-système mentionne un groupe d'ASP.
Si la description de sous-système indique un groupe d'ASP, le groupe d'ASP indiqué doit être mis sous tension et avoir le statut 'Available'.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
SBSD	Description de sous-système	Nom d'objet qualifié	Obligatoire, positionnel 1
	Qualificatif 1: Description de sous-système	Nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB

Description de sous-système (SBSD)

Indique le nom et la bibliothèque de la description de sous-système définissant l'environnement opérationnel (le sous-système) à démarrer.

Le nom de la description de sous-système ne peut pas être identique à celui d'un sous-système actuellement actif, même si les descriptions de sous-systèmes figurent dans des bibliothèques différentes.

Ce paramètre est obligatoire.

Qualificatif 1 : Description de sous-système

nom: Indiquez le nom de la description de sous-système à lancer.
Remarque :L'objet QLPINSTALL fourni par IBM n'est pas admis pour ce nom de description de sous-système.

Qualificatif 2 : Biblio

*LIBL: La recherche porte sur toutes les bibliothèques de l'unité d'exécution jusqu'à ce que la première occurrence soit trouvée.
*CURLIB: La bibliothèque en cours pour l'unité d'exécution permet de localiser l'objet. Si celle-ci n'est indiquée, QGPL est prise par défaut.

nom: Indiquez la bibliothèque dans laquelle se trouve la description de sous-système.
Remarque :La bibliothèque QTEMP n'est pas admise pour le nom de bibliothèque.

Exemples

Exemple 1 : démarrage du sous-système de traitement par lots

STRSBS   SBSD(QBATCH)

Cette commande permet de démarrer le sous-système de traitement par lots appelé QBATCH.

Exemple 2 : démarrage d'un sous-système utilisateur

STRSBS   SBSD(QGPL/TELLER)

Cette commande permet de démarrer le sous-système associé à la description du sous-système TELLER de la bibliothèque QGPL. TELLER est le nom du sous-système.

Messages d'erreur

Messages *ESCAPE

CPF1001: Délai d'attente expiré pour réponse système.
CPF1004: Erreur lors du démarrage du sous-système.
CPF101B: Sous-système &1 non démarré. Groupe d'ASP &3 non disponible.
CPF101C: Non autorisé sur l'unité &1.
CPF1010: Sous-système &1 actif.
CPF1011: Le démarrage du sous-système &1 de &2 a échoué.
CPF1012: Vous n'êtes pas autorisé à démarrer le sous-système.
CPF1013: Sous-système &1 non trouvé dans la bibliothèque &2.
CPF1014: Sous-système &1 non démarré.
CPF1031: Vous n'êtes pas autorisé à utiliser la bibliothèque &1.
CPF1038: Vous n'êtes pas autorisé à utiliser la commande indiquée.
CPF1049: Impossible d'allouer le sous-système &1 de &2.
CPF1050: Espace mémoire insuffisant pour démarrage sous-système.
CPF1057: Sous-système &1 de &2 endommagé.
CPF1067: Impossible d'allouer la bibliothèque &1.
CPF1080: Bibliothèque &1 non trouvée.
CPF1086: Sous-système &1 de &2 alloué à votre travail.
CPF1099: Sous-système non démarré car système en cours d'arrêt.
CPF3D87: Tentative d'utilisation du programme système QLPCTLIN de QSYS.