CHGCLS

La commande CHGCLS (Modifier une classe) permet de modifier les attributs d'une classe créée à l'aide de la commande CRTCLS (Créer une classe). La classe détermine les attributs de traitement des travaux pour lesquels elle est utilisée. La classe associée à un travail est définie dans le poste de routage de description de sous-système utilisé pour démarrer le travail. Si le travail comporte plusieurs phases d'activation, la classe utilisée à chacune des phases est indiquée dans le poste de routage utilisé pour démarrer la phase d'activation.

Tous les attributs peuvent être modifiés, sauf l'attribut de droits publics. Pour plus d'informations sur la modification des droits sur les objets, reportez-vous à la commande RVKOBJAUT (Révoquer droits sur un objet) et à la commande GRTOBJAUT (Accorder droits sur un objet).

Restrictions

1. Pour utilisez cette commande, vous devez disposer des droits suivants :
   • Le droit de gestion de l'objet (*OBJMGT) et le droit d'opération sur l'objet (*OBJOPR) de cette classe.
   • Le droit d'exécution (*EXECUTE) sur la bibliothèque dans laquelle réside la classe.

Paramètres

Classe (CLS)

Indique le nom qualifié de la classe.

Remarque : Les classes suivantes fournies par IBM ne sont pas admises pour ce paramètre :

• QARBCLS
• QLPINSTALL
• QMONCLS

Ce paramètre est obligatoire.

Qualificatif 1 : Classe

nom

Indiquez le nom de la classe.

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 le nom de la bibliothèque où se trouve la classe.

Priorité d'exécution (RUNPTY)

Indique la priorité d'exécution des travaux qui utilisent la classe. Il s'agit d'une valeur comprise entre 1 (niveau de priorité le plus élevé) et 99 (niveau le plus bas) correspondant à la priorité d'un travail par rapport à d'autres travaux actifs sur l'unité de traitement. Pour les travaux multitâches, la priorité d'exécution représente la plus haute priorité d'exécution admise pour une unité d'exécution contenu dans un travail. Des unités d'exécution peuvent être associées à une priorité plus basse.

Cette valeur représente l'importance relative (et non pas absolue) du travail. Par exemple, un travail dont la priorité d'exécution est de 25 n'est pas deux fois plus important qu'un travail dont la priorité d'exécution est de 50.

*SAME

La priorité d'exécution ne change pas.

1-99

Indiquez la priorité d'exécution du travail utilisant cette classe.

Tranche de temps (TIMESLICE)

Indique la période de temps processeur maximal, en millisecondes, à accorder à chacune des unités d'exécution d'un travail utilisant cette classe avant que d'autres unités d'exécution de ce travail ou d'autres travaux puissent être exécutées. Cette tranche de temps définit la période nécessaire à une unité d'exécution au sein d'un travail pour effectuer un certain volume de traitement. Une fois la tranche de temps écoulée, l'unité d'exécution peut être mise à l'état inactif, ce qui permet à d'autres unités d'exécution d'être actives dans le pool de mémoire.

*SAME

La tranche de temps n'est pas modifiée.

0-9999999

Indiquez la période maximale d'exécution, en millisecondes, à attribuer à chaque unité d'exécution d'un travail utilisant cette classe.

Remarque :Bien qu'il soit possible d'indiquer une valeur inférieure à 8, la durée minimale d'exécution d'un traitement par le système est de 8 millisecondes. Si vous affichez les attributs d'exécution d'un travail, vous constaterez que la tranche de temps n'est jamais inférieure à 8.

Admis à sortir de mémoire (PURGE)

Indique si le travail peut être transféré de la mémoire principale à la mémoire secondaire au terme d'une tranche de temps ou bien à l'occasion d'une longue attente (attente de la réponse d'un utilisateur de poste de travail, par exemple). Le système d'exploitation n'utilise plus ce paramètre.

*SAME

La valeur ne change pas.

*YES

Le travail peut être transféré de la mémoire principale à la mémoire secondaire. Toutefois, un travail à unités d'exécution multiples ne peut jamais être purgé de la mémoire principale.

*NO

Le travail ne peut pas être transféré de la mémoire principale à la mémoire secondaire. Toutefois, lorsque de la mémoire principale est nécessaire, les pages appartenant à une unité d'exécution de ce travail peuvent être transférées en mémoire secondaire. Ainsi, lorsqu'une unité d'exécution de ce travail s'exécute de nouveau, ses pages sont rechargées en mémoire principale au fur et à mesure des besoins.

Temps d'attente par défaut (DFTWAIT)

Indique le temps maximal par défaut (en secondes) pendant lequel une unité d'exécution d'un travail attend qu'une instruction système, telle l'instruction machine LOCK, obtienne une ressource. Ce temps d'attente par défaut est utilisé si aucun autre temps d'attente n'est défini. En général, il s'agit du temps pendant lequel l'utilisateur du système veut attendre avant d'annuler la demande.

Si le temps d'attente pour l'exécution d'une instruction est dépassé, un message d'erreur s'affiche, à moins qu'il ne soit géré par la commande MONMSG (Intercepter message).

*SAME

Le temps d'attente par défaut n'est pas modifié.

*NOMAX

Aucun temps d'attente maximal n'a été défini.

0-9999999

Indiquez le temps maximal (en secondes) pendant lequel le système doit attendre que l'instruction obtienne une ressource.

Remarque :Même si un délai d'attente par défaut de 0 est admis, celui-ci n'est pas conseillé. Certaines instructions système imposent l'utilisation de ressources système qui sont probablement en cours d'utilisation et qui provoquent l'échec de l'instruction lorsqu'un délai par défaut de 0 est indiqué. Lorsqu'une instruction système échoue (dépassement du délai d'attente par défaut), des résultats imprévus risquent de se produire pour l'unité d'exécution. La plupart des ressources du système seront utilisées pendant un court délai ; un délai d'attente par défaut court ne détériore donc pas considérablement les performances d'une unité d'exécution

Temps maximal unité traitement (CPUTIME)

Indique le temps UC maximal (en millisecondes) alloué au travail. Si ce dernier est composé de plusieurs phases d'activation, chacune d'elles dispose de ce temps UC maximal. En cas de dépassement du temps maximum, le travail est suspendu.

*SAME

Le temps UC maximal n'est pas modifié.

*NOMAX

Le temps UC n'est pas limité.

1-9999999

Indiquez le temps UC maximal (en millisecondes).

Mémoire temporaire maximale (MAXTMPSTG)

Indique le volume maximal de mémoire temporaire (secondaire) (en mégaoctets) utilisable par le travail. Si ce dernier est composé de plusieurs phases d'activation, il s'agit de la mémoire secondaire maximale pouvant être utilisée par une phase d'activation. Cette mémoire temporaire fournit les ressources nécessaires au programme lui-même et aux objets internes du système créés implicitement pour prendre en charge le travail. (Elle n'inclut pas la mémoire des objets de la bibliothèque QTEMP.) En cas de dépassement du volume de mémoire temporaire maximal, le travail est suspendu. Ce paramètre ne s'applique pas à l'utilisation de la mémoire secondaire permanente gérée par le profil utilisateur.

*SAME

La capacité mémoire temporaire maximale pour les travaux utilisant cette classe n'est pas modifiée.

*NOMAX

La capacité maximale admise par le système est utilisée.

1-2147483647

Indiquez la quantité maximale de mémoire temporaire (en mégaoctets) utilisable.

Nombre max unités exécution (MAXTHD)

Nombre maximal d'unités d'exécution pouvant être exécutées par un travail à un moment donné. Si plusieurs unités d'exécution sont démarrées simultanément, cette valeur peut être dépassée. Dans ce cas, les unités d'exécution en surnombre pourront s'exécuter jusqu'à la fin de leur traitement. En revanche, aucune nouvelle unité d'exécution ne pourra être démarrée tant que le nombre d'unités d'exécution du travail ne sera pas redescendu en dessous de la valeur maximale.

*SAME

La valeur ne change pas.

*NOMAX

Il n'existe aucun nombre maximal d'unités d'exécution.

1-32767

Indiquez le nombre d'unités d'exécution pour un travail.

Remarque :Selon les ressources utilisées par les unités d'exécution et celles disponibles sur le système, il se peut que le démarrage d'unités d'exécution supplémentaires soit impossible avant que la valeur maximale ne soit atteinte.

Texte 'descriptif' (TEXT)

Texte décrivant brièvement l'objet.

*BLANK

Aucun texte n'est indiqué.

'descriptif'

Indiquez, entre apostrophes, un texte de 50 caractères au maximum.

Exemples

CHGCLS   CLS(CLASS1)  RUNPTY(60)  TIMESLICE(900)

Cette commande permet de modifier une classe appelée CLASS1 de la bibliothèque figurant dans la liste des bibliothèques du travail. La priorité d'exécution de la classe passe à 60 et la tranche de temps est de 900 millisecondes.

Messages d'erreur

Messages *ESCAPE

CPF1169

Classe &1 de bibliothèque &2 non modifiée.