SETATNPGM

Définir programme pour ATTN

En bref

La commande SETATNPGM (Définir programme pour ATTN) permet de définir un programme qui est appelé lorsque la touche ATTN est utilisée.

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

Syntaxe minimale

SETATNPGM PGM(…)

Paramètres

PGM Programme obligatoire
SET Etat de la touche ATTN

Astuce : dans une session 5250, tapez SETATNPGM 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 : Environnements interactifs (*INTERACT *IPGM *IREXX *EXEC)
Compatible multitâche : Non

La commande SETATNPGM (Définir programme pour ATTN) permet de définir un programme qui est appelé lorsque la touche ATTN est utilisée. Cette définition est admise pour ce niveau de récursivité, et les niveaux inférieurs si d'autre programmes sont appelés, mais cesse de l'être si le travail passe à un niveau de récursivité supérieur. Aucun paramètre n'est transmis au gestionnaire de touche. Le gestionnaire de la touche ATTN fonctionne avec les attributs de travail, les substitutions et les droits de groupe du programme qui exécute la commande SETATNPGM. Cependant, les droits adoptés par le programme ne sont pas maintenus.

La gestion de la touche d'interruption ne modifie pas le groupe d'ASP en vigueur. Le groupe d'ASP détermine l'espace de noms de la bibliothèque de l'unité d'exécution. Si le programme de gestion des interruptions se trouve dans un ASP indépendant, et si cet ASP ne fait pas partir de l'espace de noms de bibliothèque pour l'unité d'exécution lors de la gestion de la touche d'interruption, le programme souhaité est introuvable. Pour éviter des incidents potentiels lorsque les applications modifient l'espace de noms de bibliothèque, le programme doit se trouver dans l'ASP du système ou dans un ASP utilisateur de base.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
PGM	Programme	Valeurs uniques: CURRENT, PRVINVLVL Autres valeurs: Nom d'objet qualifié	Obligatoire, positionnel 1
	Qualificatif 1: Programme	Nom
	Qualificatif 2: Biblio	Nom, LIBL, CURLIB
SET	Etat de la touche ATTN	ON, OFF	Facultatif, positionnel 2

Programme (PGM)

Indique le nom qualifié du programme de gestion de la touche ATTN à ce niveau de récursivité.

Ce paramètre est obligatoire.

Valeurs uniques

*CURRENT: Ce paramètre a pour valeur le nom du gestionnaire de la touche ATTN en cours.
*PRVINVLVL: Le gestionnaire de la touche ATTN actif au niveau de récursivité précédent est également utilisé à ce niveau. Le paramètre SET (Etat de la touche ATTN) n'est pas admis si cette valeur spéciale est indiquée car l'état SET définie au niveau précédent est reprise. Cette option est utilisée si un programme définit un programme pour ATTN et doit repasser à un niveau de récursivité précédent.

Qualificatif 1 : Programme

nom: Indiquez le programme du gestionnaire de la touche ATTN.

Qualificatif 2 : Biblio

*LIBL: La recherche est effectuée dans toutes les bibliothèques de la liste des bibliothèques jusqu'à ce qu'une occurrence soit trouvée.
*CURLIB: Le programme est recherché dans la bibliothèque en cours de l'unité d'exécution. Si la bibliothèque n'est pas indiquée, QGPL est utilisée par défaut.

nom: Indiquez la bibliothèque contenant le programme du gestionnaire de la touche ATTN.

Etat de la touche ATTN (SET)

Indique si le gestionnaire de la touche ATTN défini dans le paramètre PGM (Programme) est appelé lorsque l'utilisateur appuie sur la touche correspondante. Ce paramètre n'est pas admis si *PRVINVLVL est indiqué pour le paramètre PGM.

*ON: Le gestionnaire de la touche ATTN indiqué dans le paramètre PGM (Programme) est appelé lorsque l'utilisateur appuie sur la touche correspondante.
*OFF: Le gestionnaire de la touche ATTN indiqué dans le paramètre PGM (Programme) n'est pas appelé lorsque l'utilisateur appuie sur la touche ATTN.

Exemples

Exemple 1 : Définition du programme de gestion de la touche ATTN

SETATNPGM   PGM(QGPL/ATTN)  SET(*ON)

Cette commande permet au programme QGPL/ATTN de gérer la touche ATTN. SET(*ON) étant indiqué, le programme est appelé lorsque l'utilisateur appuie sur la touche ATTN.

Exemple 2 : Désactivation de la touche ATTN

SETATNPGM   PGM(*CURRENT)  SET(*OFF)

Le programme de gestion de la touche ATTN passe à l'état SET(*OFF). En raison de l'état SET(*OFF), le programme de gestion de la touche ATTN n'est pas appelé lorsque l'utilisateur appuie sur la touche ATTN.

Exemple 3 : Prise en charge du niveau de récursivité précédent

SETATNPGM   PGM(*PRVINVLVL)

Le gestionnaire de la touche ATTN et l'état actif au niveau de récursivité précédent est également utilisé à ce niveau. Si aucun gestionnaire de la touche ATTN n'est actif, rien ne se produit après l'exécution de cette commande, lorsque l'utilisateur appuie sur la touche ATTN.

Exemple 4 : Emulation de la touche Attente système

SETATNPGM   PGM(QWSSYSRQ)

Le programme QWSSYSRQ fourni par le système est appelé lorsque l'utilisateur appuie sur la touche ATTN. Ce programme système permet à la touche ATTN d'assurer la fonction de touche d'appel système en affichant le menu d'attente système lorsque l'utilisateur appuie sur la touche ATTN.

Messages d'erreur

Messages *ESCAPE

CPF1318: Programme de gestion de la touche ATTN &1 de &2 non défini.