CHGFCNUSG

Modifier utilisation fonction

En bref

La commande CHGFCNUSG (Modifier utilisation fonction) permet de modifier les informations d'utilisation admises d'une fonction enregistrée.

CHGFCNUSG se lit CHG (Modifier) + FCNUSG. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

CHGFCNUSG FCNID(…)

Paramètres

FCNID ID fonction obligatoire
USER Utilisateur
USAGE Utilisation
DEFAULT Droit par défaut
ALLOBJAUT Droit spécial *ALLOBJ

Astuce : dans une session 5250, tapez CHGFCNUSG 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 : Oui

La commande CHGFCNUSG (Modifier utilisation fonction) permet de modifier les informations d'utilisation admises d'une fonction enregistrée. Les fonctions peuvent être enregistrées à l'aide de l'API QSYRGFN (enregistrement de fonctions).

Certaines fonctions offrent d'autres moyens pour autoriser des utilisateurs à les utiliser. Par exemple, un utilisateur autorisé à utiliser la fonction de trace de maintenance (QIBM_SERVICE_TRACE) sera toujours autorisé à utiliser la commande TRCINT s'il dispose du droit spécial de maintenance (*SERVICE).

Restrictions : Vous devez disposer du droit spécial d'administrateur de la sécurité (*SECADM) pour pouvoir modifier des informations d'utilisation à l'aide de cette commande.

Paramètres

Mot-clé	Description	Valeurs possibles	Remarques
FCNID	ID fonction	Nom	Obligatoire, positionnel 1
USER	Utilisateur	Nom simple	Facultatif
USAGE	Utilisation	ALLOWED, DENIED, *NONE	Facultatif
DEFAULT	Droit par défaut	SAME, ALLOWED, *DENIED	Facultatif
ALLOBJAUT	Droit spécial *ALLOBJ	SAME, USED, *NOTUSED	Facultatif

ID fonction (FCNID)

Indique l'identificateur de la fonction pour lequel les informations d'utilisation doivent être modifiées.

Ce paramètre est obligatoire.

nom: Indique le nom de l'ID de la fonction pour laquelle les informations d'utilisation doivent être modifiées.

Utilisateur (USER)

Nom du profil utilisateur dont les informations d'utilisation de la fonction sont à modifier.

nom: Indiquez le nom du profil utilisateur dont les informations d'utilisation de la fonction sont à modifier.

Utilisation (USAGE)

Indique l'utilisation autorisée pour le profil utilisateur indiqué au paramètre Utilisateur (USER).

*ALLOWED: Le profil utilisateur est autorisé à utiliser la fonction.
*DENIED: Le profil utilisateur n'est pas autorisé à utiliser la fonction, sauf si cette dernière offre d'autres possibilités d'autorisation pour les utilisateurs.
*NONE: Le profil utilisateur ne sera pas explicitement autorisé ou non à utiliser la fonction.

Droit par défaut (DEFAULT)

Indique l'utilisation par défaut de la fonction. L'utilisation par défaut est employée si l'utilisateur ou l'un de ses groupes n'a pas de paramètre d'utilisation particulier.

*SAME: La valeur reste inchangée.
*ALLOWED: Les profils utilisateur sans paramètre d'utilisation pour la fonction sont autorisés à utiliser la fonction.
*DENIED: Les profils utilisateur sans paramètre d'utilisation pour la fonction ne sont pas autorisés à utiliser la fonction, sauf si cette dernière offre d'autres possibilités d'autorisation pour les utilisateurs.

Droit spécial *ALLOBJ (ALLOBJAUT)

Indique si les droits spéciaux sur tous les objets (*ALLOBJ) peuvent être utilisés pour accorder à un utilisateur l'accès à la fonction.

*SAME

La valeur reste inchangée.

*USED

Un utilisateur ayant les droits spéciaux *ALLOBJ est toujours autorisé à utiliser la fonction.

*NOTUSED

Pour qu'un utilisateur disposant des droits spéciaux *ALLOBJ utilise la fonction, les informations d'utilisation indiquées pour la fonction doivent indiquer que l'utilisateur est autorisé à utiliser la fonction pour l'une des raisons suivantes :

l'utilisateur a les droits d'utilisation,
l'un de ses groupes a les droits d'utilisation, ou
le paramètre par défaut accorde les droits d'utilisation.

Exemples

CHGFCNUSG   FCNID(QIBM_SERVICE_TRACE)  DEFAULT(*DENIED)
            USER(QSRVBAS)  USAGE(*ALLOWED)

Cette commande interdit à l'utilisateur par défaut l'accès à la fonction QIBM_SERVICE_TRACE. Elle autorise d'autre part le profil utilisateur QSRVBAS à utiliser cette fonction.

Messages d'erreur

Messages *ESCAPE

CPF2204: Profil utilisateur &1 non trouvé.
CPF2225: Impossible d'allouer objet système interne.
CPF222E: Le droit spécial &1 est requis.
CPF228A: La fonction &1 n'est pas enregistrée. Function &1 not registered.
CPF229B: Opération non admise pour la fonction &1.
CPF229D: Opération non admise sur le profil utilisateur &1.
CPF3CD9: La fonction demandée ne peut pas être exécutée pour le moment. Requested function cannot be performed at this time.
CPF3CDA: Le référentiel du service d'enregistrement n'est pas disponible. Registration facility repository not available for use.
CPF4ADB: Echec de l'opération en raison d'erreurs de réplication.