Aller au contenu

SETOBJACC

Définir l'accès à un objet

En bref

La commande SETOBJACC (Définir l'accès à un objet) permet de modifier temporairement le temps d'accès à un objet soit en stockant celui-ci dans un pool mémoire principale, soit en l'éliminant de tous les pools mémoire principale.

SETOBJACC se lit SET (Définir) + OBJACC. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

SETOBJACC OBJ(…)

Paramètres

Astuce : dans une session 5250, tapez SETOBJACC 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 SETOBJACC (Définir l'accès à un objet) permet de modifier temporairement le temps d'accès à un objet soit en stockant celui-ci dans un pool mémoire principale, soit en l'éliminant de tous les pools mémoire principale. Dans le premier cas, vous devez sélectionner un pool disposant d'un espace suffisant et non associé à des travaux. L'utilisation répétée de cette commande permet à un ensemble d'objets de devenir résidents d'un pool mémoire principale.

Restrictions :

  • Vous devez disposer du droit *OBJOPR sur tous les objets placés dans un pool de mémoire principale ou supprimés de tous les pools de mémoire principale.

Paramètres

Mot-clé Description Valeurs possibles Remarques
OBJ Objet Nom d'objet qualifié Obligatoire, positionnel 1
Qualificatif 1: Objet Nom
Qualificatif 2: Biblio Nom, *LIBL, *USRLIBL, *CURLIB, *ALL, *ALLUSR
OBJTYPE Type d'objet *FILE, *PGM Facultatif, positionnel 2
POOL Pool mémoire Liste d'éléments Facultatif, positionnel 3
Élément 1: Pool partagé ou sous-système Nom, *JOB, *BASE, *SHRPOOL1, *SHRPOOL2, *SHRPOOL3, *SHRPOOL4, *SHRPOOL5, *SHRPOOL6, *SHRPOOL7, *SHRPOOL8, *SHRPOOL9, *SHRPOOL10, *SHRPOOL11, *SHRPOOL12, *SHRPOOL13, *SHRPOOL14, *SHRPOOL15, *SHRPOOL16, *SHRPOOL17, *SHRPOOL18, *SHRPOOL19, *SHRPOOL20, *SHRPOOL21, *SHRPOOL22, *SHRPOOL23, *SHRPOOL24, *SHRPOOL25, *SHRPOOL26, *SHRPOOL27, *SHRPOOL28, *SHRPOOL29, *SHRPOOL30, *SHRPOOL31, *SHRPOOL32, *SHRPOOL33, *SHRPOOL34, *SHRPOOL35, *SHRPOOL36, *SHRPOOL37, *SHRPOOL38, *SHRPOOL39, *SHRPOOL40, *SHRPOOL41, *SHRPOOL42, *SHRPOOL43, *SHRPOOL44, *SHRPOOL45, *SHRPOOL46, *SHRPOOL47, *SHRPOOL48, *SHRPOOL49, *SHRPOOL50, *SHRPOOL51, *SHRPOOL52, *SHRPOOL53, *SHRPOOL54, *SHRPOOL55, *SHRPOOL56, *SHRPOOL57, *SHRPOOL58, *SHRPOOL59, *SHRPOOL60, *PURGE
Élément 2: Identificateur du pool 1-10
MBR Membre Nom, *FIRST Facultatif
MBRDATA Données de membre *BOTH, *ACCPTH, *DATA Facultatif

Objet (OBJ)

Indique le nom qualifié de l'objet à placer dans la mémoire principale ou à effacer de celle-ci.

Le nom de l'objet spécifié peut être qualifié par l'une des valeurs de bibliothèque suivantes :

*LIBL
La recherche porte sur toutes les bibliothèques de la liste des bibliothèques de l'unité d'exécution en cours jusqu'à ce que la première occurrence soit trouvée.
*CURLIB
La recherche porte sur la bibliothèque en cours du travail. Si celle-ci n'est pas précisée, QGPL est utilisée par défaut.
*USRLIBL
La recherche porte uniquement sur les bibliothèques figurant dans la partie utilisateur de la liste des bibliothèques du travail.
*ALL
La recherche porte sur toutes les bibliothèques du système.
*ALLUSR
La recherche porte sur toutes les bibliothèques utilisateur. La recherche porte sur toutes les bibliothèques dont le nom ne commence pas par la lettre Q, à l'exception des bibliothèques suivantes : 

#CGULIB     #DSULIB     #SEULIB
#COBLIB     #RPGLIB
#DFULIB     #SDALIB

Bien que les bibliothèques Qxxx suivantes soient fournies par IBM, elles contiennent généralement des données utilisateur qui sont fréquemment modifiées. Par conséquent, ces bibliothèques sont considérées comme des bibliothèques utilisateur et sont donc recherchées : 

QDSNX       QRCLxxxxx   QUSRDIRDB   QUSRVI
QGPL        QSRVAGT     QUSRIJS     QUSRVxRxMx
QGPL38      QSYS2       QUSRINFSKR  QWQCENT
QMGTC       QSYS2xxxxx  QUSRNOTES   QWQREPOS
QMGTC2      QS36F       QUSROND
QMPGDATA    QUSER38     QUSRPOSGS
QMQMDATA    QUSRADSM    QUSRPOSSA
QMQMPROC    QUSRBRM     QUSRPYMSVR
QPFRDATA    QUSRDIRCF   QUSRRDARS
QRCL        QUSRDIRCL   QUSRSYS

  1. 'xxxxx' représente le numéro de l'ASP principal.
  2. L'utilisateur peut créer une bibliothèque de nom différent, au format QUSRVxRxMx, pour chacune des éditions précédentes prises en charge par IBM, afin d'y stocker les commandes utilisateur à compiler dans un programme CL pour une édition précédente. En ce qui concerne la bibliothèque utilisateur QUSRVxRxMx, VxRxMx correspond à une version, édition et niveau de modification précédents encore admis par IBM.
nom-bibliothèque
Indiquez le nom de la bibliothèque sur laquelle porte la recherche.

Les valeurs possibles sont les suivantes :

nom-objet
Indiquez le nom de l'objet.

Type d'objet (OBJTYPE)

Indique le type de l'objet à placer dans la mémoire principale ou à effacer de celle-ci.

Les valeurs possibles sont les suivantes :

*FILE
L'objet est un fichier.
*PGM
L'objet est un programme.

Pool mémoire (POOL)

Indique si l'objet est placé dans la mémoire principale ou s'il est éliminé de celle-ci.

Les valeurs possibles sont les suivantes :

*JOB
L'objet est placé dans le pool associé au travail.
*BASE
L'objet est placé dans le pool de base.
*SHRPOOLn
L'objet est placé dans le pool partagé général. Les valeurs possibles sont comprises entre 1 et 10.
*PURGE
L'objet est éliminé de tous les pools. Elément 1 : Sous-système
sous-système
Indiquez un nom de sous-système. Elément 2 : Identificateur du pool
identificateur-pool
Indiquez un identificateur de pool sous-système.
*PURGE
L'objet est éliminé de tous les pools.

Membre (MBR)

Indique le fichier base de données à placer dans la mémoire principale ou à éliminer de celle-ci.

Les valeurs possibles sont les suivantes :

*FIRST
Le premier membre est sélectionné.
nom-membre-fichier
Indiquez un nom de membre.

Données de membre (MBRDATA)

Indique les données de membre à placer dans la mémoire principale ou à éliminer de celle-ci.

Les valeurs possibles sont les suivantes :

*BOTH
La totalité de l'objet est sélectionnée.
*ACCPTH
Le chemin d'accès du membre de fichier est sélectionné.
*DATA
Les données du membre de fichier sont sélectionnées.

Exemples 

SETOBJACC   OBJ(OBJA)  OBJTYPE(*PGM)  POOL(*JOB)

Cette commande permet de placer le programme OBJA dans le pool associé au travail dans lequel la commande s'exécute.

Messages d'erreur

Messages *ESCAPE

CPF1858
Le pool indiqué n'existe pas.
CPF1859
L'utilisation d'un chemin d'accès a été demandée, mais il n'en existe aucun.
CPF9855
Le fichier &1 de la bibliothèque &3 ne contient aucun membre.

© Copyright IBM Corp. Texte d'aide reproduit à des fins de formation.