SETASPGRP

La commande SETASPGRP permet de définir le groupe d'ASP pour l'unité d'exécution en cours. Elle permet également d'indiquer d'autres bibliothèques dans la liste de bibliothèques de l'unité d'exécution en cours. Si un groupe d'ASP est déjà défini, cette commande supprime le groupe existant de l'unité d'exécution en définissant le nouveau. Toutes les bibliothèques des ASP indépendants dans le groupe d'ASP sont alors accessibles et tous les objets qu'elles contiennent peuvent être référencés à l'aide d'une syntaxe de nom d'objet standard. Les bibliothèques des ASP indépendants du groupe d'ASP, ajoutées aux bibliothèques de l'ASP système (ASP numéro 1) et aux ASP utilisateur de base (ASP 2 à 32) constituent l'espace de nom de bibliothèque pour l'unité d'exécution. Toutes les bibliothèques de la liste doivent figurer dans le même espace de nom de bibliothèque, sinon la liste reste inchangée et le nouveau groupe ASP n'est pas défini.

Restrictions :

• Vous devez disposer des droits *USE sur toutes les descriptions d'unité ASP contenues dans le groupe et sur toutes les bibliothèques spécifiées dans la liste pour que l'espace de nom et la liste de bibliothèques puissent être modifiés. Si vous ne disposez pas de droits sur une description d'unité ASP ou sur l'une des bibliothèques, le groupe d'ASP n'est pas défini et la liste reste inchangée.
• Si *CURUSR est spécifié au paramètre Groupe ASP (ASPGRP) ou Biblio unité exéc en cours (USRLIBL), vous devez disposer d'un droit d'accès en lecture (*READ) sur la description de travail répertoriée dans votre profil utilisateur, et d'un droit d'exécution (*EXECUTE) sur la bibliothèque contenant ce travail.
• La commande SETASPGRP n'est pas admise pour les éléments suivants :
  • Travaux système QPFRADJ, QJOBSCD, QSYSARB, QSYSARB3, QSYSARB4 et QLUS.
  • Tous les travaux de moniteur de sous-système.
  • Travaux DDM, DRDA, serveur hôte de base de données et travaux de serveur SQL une fois l'espace nom établi.
  • Programmes d'exit de commande RCVJRNE et DLTJRNRCV.
  • Programmes d'exit RIGS (point d'exit QIBM_QYIV_INVGTRSRV).
  • Programmes déclencheurs ou programme de sélection de format exécutés dans le cadre d'opérations d'E-S.
  • Programmes de gestion de la touche ATTN (paramètre PGM de la commande SETATNPGM).
  • Programme de gestion des interruptions (paramètre PGM de la commande CHGMSGQ).
  • Fonctions PDM (Programming Development Manager).
  • Toutes les unités d'exécution avec un accès spécial à un contenu protégé.

Paramètres

Groupe ASP (ASPGRP)

Indique le nom du groupe d'ASP à définir pour l'unité d'exécution en cours. Il s'agit de l'unité ASP principale du groupe d'ASP.

Ce paramètre est obligatoire.

*CURUSR

Le groupe d'ASP prend la valeur du Groupe ASP initial (INLASPGRP) spécifiée dans la description de travail par défaut du profil utilisateur associé à l'unité d'exécution.

*NONE

L'unité d'exécution en cours ne doit pas avoir de groupe d'ASP. L'espace de nom de bibliothèque ne contient alors aucune bibliothèque de groupe d'ASP. Seules les bibliothèques de l'ASP système et des ASP utilisateur de base figurent alors dans l'espace de nom de bibliothèque.

nom

Indiquez le nom de l'ASP principal du groupe d'ASP à définir pour l'unité d'exécution en cours. Toutes les bibliothèques de tous les ASP de ce groupe sont alors incluses dans l'espace nom de bibliothèque.

Liste bibliothèques système (SYSLIBL)

Désigne la partie système de la liste des bibliothèques pour l'unité d'exécution concernée.

*CURSYSBAS

Les bibliothèques de la partie système de la liste de bibliothèques de l'unité d'exécution en cours, qui figurent dans l'ASP système (ASP numéro 1) ou l'un des ASP utilisateur de base (ASP 2 à 32) sont utilisées comme nouvelle partie système de la liste.

*SYSVAL

La partie système de la liste de bibliothèques de l'unité d'exécution en cours est définie à partir de la valeur système QSYSLIBL en cours.

Bibliothèque en cours (CURLIB)

Indique la bibliothèque à utiliser comme bibliothèque en cours de la liste pour l'unité d'exécution. Si *CURUSR ou un nom de bibliothèque est spécifié et que la bibliothèque est introuvable dans l'espace de nom de bibliothèque correspondant, un message d'erreur est émis mais la liste de bibliothèques et le groupe d'ASP restent inchangés.

*CURSYSBAS

Le nom de bibliothèque figurant comme bibliothèque en cours dans la liste de bibliothèques est adopté comme nouvelle bibliothèque en cours si celle-ci se trouve dans l'ASP système (ASP numéro 1) ou dans l'un des ASP utilisateur de base (ASP numéros 2 à 32). Si le nom de la bibliothèque indiquée comme bibliothèque en cours est introuvable dans l'ASP système ou dans tout autre ASP utilisateur de base, il est supprimé de la liste des bibliothèques.

*CURUSR

La bibliothèque en cours adopte la valeur définie pour l'attribut Bibliothèque en cours (CURLIB) dans le profil utilisateur associé à l'unité d'exécution.

*CRTDFT

Retire de la liste des bibliothèques tout poste relatif à la bibliothèque en cours. Si les objets sont créés à l'aide du paramètre *CURLIB comme nom de bibliothèque, le système utilise QGPL.

nom

Indiquez le nom de la bibliothèque remplaçant la bibliothèque en cours dans la liste des bibliothèques.

Biblio unité exéc en cours (USRLIBL)

Indique les bibliothèques qui figurent dans la partie utilisateur de la liste des bibliothèques. Si *CURUSR ou une liste de noms de bibliothèques est spécifié et que l'une des bibliothèques est introuvable dans l'espace de nom correspondant, un message d'erreur est émis. La liste de bibliothèques et le groupe d'ASP restent inchangés.

Valeurs uniques

*CURSYSBAS

Les bibliothèques de la partie utilisateur de la liste de bibliothèques de l'unité d'exécution en cours qui se trouvent dans l'ASP système (ASP numéro 1) ou dans n'importe quel ASP utilisateur de base (ASP 2 à 32) sont utilisées comme nouvelle partie utilisateur de la liste de bibliothèques.

*CURUSR

La partie utilisateur de la liste de bibliothèques de l'unité d'exécution adopte la valeur définie pour la Liste bibliothèques initiale (INLLIBL) dans la description de travail par défaut du profil utilisateur correspondant.

*SYSVAL

La partie utilisateur de la liste de bibliothèques est définie à partir de la valeur système QUSRLIBL en cours.

*NONE

Retire tous les noms de bibliothèque de la partie utilisateur de la liste de bibliothèques.

Autres valeurs (jusqu'à 250 répétitions)

nom

Indiquez les noms de bibliothèques à employer comme partie utilisateur de la liste, dans l'ordre de recherche souhaité.

Exemples

Exemple 1 : Définition d'un nouveau groupe d'ASP

SETASPGRP   ASPGRP(WAREHOUSE1) SYSLIBL(*SYSVAL)  CURLIB(*CURUSR)
            USRLIBL(*CURSYSBAS)

Cette commande permet de définir un groupe d'ASP pour l'unité d'exécution dans laquelle s'exécute la commande pour WAREHOUSE1. L'espace nom de la bibliothèque de l'unité d'exécution est modifié afin d'inclure toutes les bibliothèques des ASP indépendants dans le groupe d'ASP identifiés par l'unité ASP indépendante WAREHOUSE1. La partie système de la liste de bibliothèques est définie à partir de la valeur système QSYSLIBL. La bibliothèque en cours adopte la valeur de Bibliothèque en cours dans le profil utilisateur associé à l'unité d'exécution. La partie utilisateur de la liste de bibliothèques est définie en utilisant la partie utilisateur de la liste de bibliothèques en cours et en supprimant les bibliothèques qui ne figurent pas dans l'ASP système ou dans des ASP utilisateur de base configurés.

Exemple 2 : Définition d'un groupe non ASP

SETASPGRP   ASPGRP(*NONE)  SYSLIBL(*CURSYSBAS)  CURLIB(*CRTDFT)
            USRLIBL(*NONE)

Cette commande permet de retirer tout groupe ASP de l'unité d'exécution dans laquelle s'exécute la commande. L'espace nom de bibliothèque de l'unité d'exécution est modifié afin d'inclure uniquement ces bibliothèques dans l'ASP système (ASP 1) et les ASP utilisateur de base (ASP 2 à 32). La partie système de la liste de bibliothèques est définie en utilisant la partie système de la liste de bibliothèques en cours et en supprimant les bibliothèques qui ne figurent pas dans l'ASP système ou dans des ASP utilisateur de base configurés. La bibliothèque en cours dans la liste des bibliothèques se vide, ce qui entraîne l'utilisation de QGPL en tant que bibliothèque en cours. La partie utilisateur de la liste de bibliothèques se vide également.

Messages d'erreur

Messages *ESCAPE

CPFB8E9

Le groupe ASP &1 n'est pas défini pour l'unité d'exécution &2.