RTVUSRPRF

La commande RTVUSRPRF (Extraire un profil utilisateur) est utilisée dans un programme CL ou une procédure REXX pour extraire une ou plusieurs valeurs associées à un profil utilisateur et stockées dans celui-ci. Les valeurs sont renvoyées dans les variables indiquées pour l'utilisateur concerné.

Le texte d'invite de paramètre indique la longueur minimale des variables en regard des paramètres à extraire. Un seul chiffre est affiché pour les variables alphanumériques, deux pour les variables numériques. Le premier nombre indique la longueur de variable minimale et le second le nombre minimal de positions décimales.

Restrictions :

• Le droit de lecture *READ est requis pour l'utilisateur indiqué au paramètre USRPRF.

Paramètres

Profil utilisateur (USRPRF)

Indique le profil utilisateur dont voulez extraire les informations. Si vous indiquez une variable, elle doit se présenter sous la forme d'une chaîne de 10 caractères contenant un nom d'utilisateur ou la valeur *CURRENT.

*CURRENT

Le profil utilisateur en cours d'exécution est utilisé.

nom

Indiquez le nom du profil utilisateur dont voulez extraire les informations.

Variable pour RTNUSRPRF (10) (RTNUSRPRF)

Indique le nom de la variable utilisée pour extraire le nom du profil utilisateur. Dans les programmes CL, cette variable doit être composée de 10 caractères. Si *CURRENT est indiqué pour le paramètre Profil utilisateur (USRPRF), la valeur renvoyée est le nom du profil utilisateur en cours d'exécution. Si, au contraire, un nom est précisé, la valeur renvoyée sera ce nom.

Variable pour SPCAUT (100) (SPCAUT)

Indique le nom de la variable utilisée pour extraire la liste des droits spéciaux de l'utilisateur. Dans les programmes CL, cette variable doit être composée de 100 caractères. Le format renvoyé est une liste comprenant jusqu'à 10 postes, de 10 caractères chacun ; chaque poste contient un droit spécial. Si le nombre de droits spéciaux est inférieur à 10, les postes restants sont complétés par des blancs à droite. Si l'utilisateur n'a aucun droit spécial, le premier poste contient la valeur *NONE suivie de blancs.

Variable CL MAXSTGLRG (20) (MAXSTGLRG)

Indique le nom de la variable utilisée pour extraire la quantité maximale de mémoire secondaire pouvant être attribuée au stockage des objets permanents de l'utilisateur désigné.

Dans les programmes CL, il doit s'agir d'une variable à 20 caractères. Cette valeur est renvoyée en kilooctets (1 ko = 1024 octets). La valeur renvoyée est un nombre ou *NOMAX. Si la valeur est inférieure à la longueur de la zone, la valeur est complétée par des espaces à droite.

Variable CL STGUSEDLRG (20) (STGUSEDLRG)

Indique le nom de la variable utilisée pour extraire la quantité de mémoire secondaire servant à stocker des objets permanents appartenant au profil utilisateur indiqué.

Dans les programmes CL, il doit s'agir d'une variable à 20 caractères. Cette valeur est renvoyée en kilooctets (1 ko = 1024 octets). Si la valeur est inférieure à la longueur de la zone, la valeur est complétée par des espaces à droite.

Variable pour PTYLMT (1) (PTYLMT)

Nom de la variable utilisée pour extraire le niveau de priorité maximal en file d'attente accordé à l'utilisateur pour chaque travail soumis au système. Dans les programmes CL, la longueur de la variable est de 1 caractère. Cette valeur permet de contrôler la priorité du traitement de chaque travail exécuté par l'utilisateur considéré. En conséquence, les valeurs définies dans les paramètres JOBPTY et OUTPTY de toute commande de travail ne peuvent dépasser la valeur PTYLMT définie pour l'utilisateur en charge du travail en cours d'exécution. Cette valeur est comprise entre 0 et 9, 0 correspondant au niveau de priorité maximal et 9 au niveau de priorité minimal.

Variable pour INLPGM (10) (INLPGM)

Indique le nom de la variable utilisée pour extraire le nom du programme initial lancé lorsque l'utilisateur indiqué ouvre une session. Dans les programmes CL, cette variable doit être composée de 10 caractères. S'il n'existe aucun programme initial associé à l'utilisateur, la valeur renvoyée dans la variable est *NONE.

Variable pour INLPGMLIB (10) (INLPGMLIB)

Indique le nom de la variable utilisée pour extraire le nom de la bibliothèque qui contient le programme initial associé à l'utilisateur désigné. Dans les programmes CL, cette variable doit être composée de 10 caractères. S'il n'existe aucun programme initial, des blancs sont renvoyés dans la variable.

Variable pour JOBD (10) (JOBD)

Nom de la variable utilisée pour extraire le nom de la description de travail associée à l'utilisateur indiqué. Dans les programmes CL, cette variable doit être composée de 10 caractères.

Variable pour JOBDLIB (10) (JOBDLIB)

Indique le nom de la variable utilisée pour extraire le nom de la bibliothèque qui contient la description de travail associée à l'utilisateur désigné. Dans les programmes CL, cette variable doit être composée de 10 caractères.

Variable pour GRPPRF (10) (GRPPRF)

Indique le nom de la variable utilisée pour extraire le nom du profil de groupe. Dans les programmes CL, cette variable doit être composée de 10 caractères. Si aucun profil de groupe n'est associé au profil utilisateur indiqué, la valeur *NONE est renvoyée dans la variable.

Variable pour OWNER (10) (OWNER)

Indique le nom de la variable utilisée pour extraire la valeur spéciale *USRPRF ou *GRPPRF. Le propriétaire des objets nouvellement créés est ainsi défini. Il s'agit soit de l'utilisateur indiqué, soit de son profil de groupe. Dans les programmes CL, cette variable doit être composée de 10 caractères. Si aucun profil de groupe n'est associé au profil utilisateur indiqué, la valeur *USRPRF est renvoyée dans la variable.

Variable pour GRPAUT (10) (GRPAUT)

Indique le nom de la variable utilisée pour extraire les droits accordés au profil de groupe sur les objets nouvellement créés. La valeur spéciale *NONE, *CHANGE, *ALL, *USE ou *EXCLUDE est renvoyée dans la variable. S'il n'existe aucun profil de groupe associé à l'utilisateur indiqué, ou si le profil de groupe est propriétaire des objets créés par l'utilisateur indiqué, la valeur *NONE sera renvoyée dans la variable. Dans les programmes CL, cette variable doit être composée de 10 caractères.

Variable pour ACGCDE (15) (ACGCDE)

Nom de la variable utilisée pour extraire la valeur du code comptabilité attribué à l'utilisateur indiqué. Dans les programmes CL, cette variable doit être composée de 15 caractères. Des blancs sont renvoyés dans la variable s'il n'existe aucun code associé à cet utilisateur.

Variable pour MSGQ (10) (MSGQ)

Nom de la variable utilisée pour extraire le nom de la file d'attente de messages associée au profil utilisateur indiqué. Dans les programmes CL, cette variable doit être composée de 10 caractères.

Variable pour MSGQLIB (10) (MSGQLIB)

Indique le nom de la variable utilisée pour extraire le nom de la bibliothèque qui contient la file d'attente de messages associée à l'utilisateur désigné. Dans les programmes CL, cette variable doit être composée de 10 caractères.

Variable pour OUTQ (10) (OUTQ)

Indique le nom de la variable utilisée pour extraire le nom de la file d'attente en sortie associée à l'utilisateur désigné. Dans les programmes CL, cette variable doit être composée de 10 caractères. La valeur spéciale *DEV ou *WRKSTN est renvoyée dans la variable.

Variable pour OUTQLIB (10) (OUTQLIB)

Indique le nom de la variable utilisée pour extraire le nom de la bibliothèque qui contient la file d'attente en sortie associée à l'utilisateur désigné. Dans les programmes CL, cette variable doit être composée de 10 caractères. Des blancs sont renvoyés si le paramètre File d'attente en sortie (OUTQ) a pour valeur *DEV ou *WRKSTN.

Variable pour TEXT (50) (TEXT)

Indique le nom de la variable utilisée pour extraire le texte descriptif associé au profil utilisateur désigné. Dans les programmes CL, cette variable doit être composée de 50 caractères. Des blancs sont renvoyés dans la variable CL s'il n'existe aucun texte descriptif.

Variable pour PWDCHGDAT (6) (PWDCHGDAT)

Indique le nom de la variable utilisée pour extraire la date de la dernière modification du mot de passe associé à l'utilisateur désigné. La date est renvoyée au format AAMMJJ. Dans les programmes CL, il doit s'agir d'une variable à 6 caractères. Des blancs sont renvoyés si aucune date n'est associée à l'utilisateur.

Variable pour USRCLS (10) (USRCLS)

Indique le nom de la variable utilisée pour extraire la classe de l'utilisateur désigné. La valeur spéciale *USER, *SYSOPR, *PGMR, *SECADM ou *SECOFR est renvoyée dans la variable CL. Dans les programmes CL, cette variable doit être composée de 10 caractères.

Variable pour ASTLVL (10) (ASTLVL)

Indique le nom de la variable utilisée pour extraire la valeur du niveau d'assistance associé à l'utilisateur désigné. La valeur spéciale *SYSVAL, *BASIC, *INTERMED, ou *ADVANCED est renvoyée dans la variable. Dans les programmes CL, cette variable doit être composée de 10 caractères.

Variable pour SPCENV (10) (SPCENV)

Indique le nom de la variable correspondant à l'environnement initial dans lequel travaille l'utilisateur désigné. Une valeur spéciale *SYSVAL, *NONE ou *S36 est renvoyée dans la variable. Dans les programmes CL, cette variable doit être composée de 10 caractères.

Variable pour CURLIB (10) (CURLIB)

Nom de la variable utilisée pour extraire le nom de la bibliothèque en cours associée à l'utilisateur indiqué. La valeur *CRTDFT est renvoyée dans la variable s'il n'existe aucune bibliothèque en cours pour cet utilisateur. Dans les programmes CL, cette variable doit être composée de 10 caractères.

Variable pour INLMNU (10) (INLMNU)

Indique le nom de la variable utilisée pour extraire le nom du menu initial qui s'affiche lorsque l'utilisateur indiqué ouvre une session. Dans les programmes CL, cette variable doit être composée de 10 caractères.

Variable pour INLMNULIB (10) (INLMNULIB)

Nom de la variable utilisée pour extraire le nom de la bibliothèque qui contient le menu initial. Dans les programmes CL, cette variable doit être composée de 10 caractères.

Variable pour LMTCPB (10) (LMTCPB)

Indique le nom de la variable utilisée pour extraire les valeurs des limites auxquelles les utilisateurs peuvent modifier leurs profils utilisateur et commandes d'exécution. Dans les programmes CL, cette variable doit être composée de 10 caractères. Une valeur spéciale *NO, *YES ou *PARTIAL est renvoyée dans la variable.

Variable pour DLVRY (10) (DLVRY)

Indique le nom de la variable utilisée pour extraire la valeur de communication du contrôle des messages pour le profil utilisateur désigné. Dans les programmes CL, cette variable doit être composée de 10 caractères. La valeur spéciale *NOTIFY, *BREAK, *HOLD ou *DFT est renvoyée dans la variable.

Variable pour SEV (2 0) (SEV)

Indique le nom de la variable utilisée pour extraire le niveau de gravité de contrôle des messages associé à l'utilisateur désigné. Dans les programmes CL, il doit s'agir d'une variable décimale d'une longueur de (2 0).

Variable pour PRTDEV (10) (PRTDEV)

Indique le nom de la variable utilisée pour extraire le nom de l'imprimante associée à l'utilisateur désigné. Dans les programmes CL, cette variable doit être composée de 10 caractères. La valeur *SYSVAL est renvoyée si le nom de l'imprimante provient de la valeur système QPRTDEV. La valeur *WRKSTN est renvoyée si le nom de l'imprimante correspond à l'imprimante du poste de travail de l'utilisateur.

Variable pour ATNPGM (10) (ATNPGM)

Indique le nom de la variable utilisée pour extraire le nom du programme de gestion de la touche ATTN associé à l'utilisateur désigné. Dans les programmes CL, cette variable comporte 10 caractères. Il s'agit d'une valeur *SYSVAL si le programme de gestion de la touche d'attention s'appuie sur la valeur système QATNPGM. La valeur *NONE est renvoyée si aucun programme n'a été indiqué pour cet utilisateur.

Variable pour ATNPGMLIB (10) (ATNPGMLIB)

Indique le nom de la variable utilisée pour extraire le nom de la bibliothèque du programme de gestion de la touche ATTN associé à l'utilisateur désigné. Dans les programmes CL, cette variable doit être composée de 10 caractères. Des blancs sont renvoyés dans la variable si le paramètre Programme pour ATTN (ATNPGM) a pour valeur *NONE.

Variable pour USROPT (240) (USROPT)

Indique le nom de la variable utilisée pour extraire la liste des valeurs des options utilisateur associées à l'utilisateur désigné. Dans les programmes CL, cette variable doit être composée de 240 caractères. La valeur spéciale *NONE ou une liste de valeurs est renvoyée dans la variable.

Variable pour DSPSGNINF (7) (DSPSGNINF)

Indique le nom de la variable utilisée pour extraire l'indicateur de l'écran Informations d'ouverture de session de l'utilisateur désigné. Dans les programmes CL, cette variable doit être composée de 7 caractères. La valeur spéciale *SYSVAL, *YES, ou *NO est renvoyée dans la variable. Si *SYSVAL est renvoyé, l'indicateur provient alors de la valeur système QDSPSGNINF.

Variable pour PWDEXPITV (5 0) (PWDEXPITV)

Indique le nom de la variable utilisée pour extraire le délai de péremption du mot de passe de l'utilisateur désigné. Dans les programmes CL, il doit s'agir d'une décimale de longueur (5,0). La valeur renvoyée peut varier de 1 à 366, être égale à 0 pour *SYSVAL, ou être égale à -1 dans le cas de *NOMAX. Si 0 est renvoyé (*SYSVAL), le délai d'expiration du mot de passe provient alors de la valeur système QPWDEXPITV.

Variable pour PWDEXP (4) (PWDEXP)

Indique le nom de la variable utilisée pour extraire l'indicateur de mot de passe périmé de l'utilisateur désigné. Dans les programmes CL, cette variable doit être composée de 4 caractères. La valeur spéciale *YES ou *NO est renvoyée dans la variable.

Variable pour STATUS (10) (STATUS)

Nom de la variable utilisée pour extraire l'état du profil utilisateur indiqué. Dans les programmes CL, cette variable doit être composée de 10 caractères. La valeur spéciale *ENABLED ou *DISABLED est renvoyée dans la variable.

Variable pour PRVSIGN (13) (PRVSIGN)

Indique le nom de la variable utilisée pour extraire la date et l'heure de la dernière ouverture de session par l'utilisateur désigné. La date et l'heure sont renvoyée au format SAAMMJJHHMMSS. Dans les programmes CL, il devra s'agir d'une variable de 13 caractères. Si l'utilisateur n'a ouvert aucune session précédemment, des blancs sont renvoyés.

Variable pr NOTVLDSIGN (11 0) (NOTVLDSIGN)

Indique le nom de la variable utilisée pour extraire le nombre de tentatives infructueuses de vérification de mot de passe pour l'utilisateur désigné. Dans les programmes CL, il doit s'agir d'une décimale condensée de longueur (11 0).

Variable pour LMTDEVSSN (7) (LMTDEVSSN)

Indique le nom de la variable utilisée pour extraire l'indicateur de sessions limitées à un écran pour l'utilisateur désigné. La valeur *SYSVAL, *YES, *NO, 0, 1, 2, 3, 4, 5, 6, 7, 8 ou 9 peut être renvoyée pour la variable CL. Si *SYSVAL est renvoyé, l'indicateur provient alors de la valeur système QLMTDEVSSN. Dans les programmes CL, cette variable doit être composée de 7 caractères.

Variable pour KBDBUF (10) (KBDBUF)

Indique le nom de la variable utilisée pour extraire la valeur de la mémoire tampon de clavier associée à l'utilisateur désigné. La valeur spéciale *SYSVAL, *NO, *TYPEAHEAD, ou *YES est renvoyée dans la variable CL. Si *SYSVAL est renvoyée, la valeur de la mémoire tampon de frappe correspond à la valeur système QKBDBUF. Dans les programmes CL, cette variable doit être composée de 10 caractères.

Variable pour LANGID (10) (LANGID)

Indique le nom de la variable utilisée pour extraire l'identificateur de langue pour l'utilisateur désigné. Soit la valeur spéciale *SYSVAL, soit l'identificateur de langue est renvoyé dans cette variable. Si *SYSVAL est renvoyé, l'identificateur de langue de l'utilisateur est déterminé par la valeur système QLANGID. Dans les programmes CL, cette variable doit être composée de 10 caractères.

Variable pour CNTRYID (10) (CNTRYID)

Indique le nom de la variable utilisée pour extraire l'identificateur de pays ou région pour l'utilisateur désigné. Soit la valeur spéciale *SYSVAL, soit l'identificateur de pays ou région est renvoyé dans cette variable. Si *SYSVAL est renvoyé, l'identificateur de pays ou région de l'utilisateur est déterminé par la valeur système QCNTRYID. Dans les programmes CL, cette variable doit être composée de 10 caractères.

Variable pour CCSID (5 0) (CCSID)

Indique le nom de la variable utilisée pour extraire le CCSID (ID codé de jeu de caractères) pour l'utilisateur désigné. La valeur retournée est soit composée de 5 chiffres, soit égale à -2 (si la valeur système QCCSID est utilisée pour déterminer le CCSID de l'utilisateur). Dans les programmes CL, cette valeur doit être une variable décimale de longueur (5 0).

Variable pour SRTSEQ (10) (SRTSEQ)

Indique le nom de la variable utilisée pour extraire la table de séquence de tri pour l'utilisateur désigné. La valeur renvoyée est l'une des valeurs suivantes : *HEX, *LANGIDUNQ, *LANGIDSHR, *SYSVAL ou l'identificateur de table composé de 10 caractères. Si la valeur *SYSVAL est renvoyée, l'identificateur de table pour l'utilisateur est déterminé par la valeur système QSRTSEQ.

Variable pour SRTSEQLIB (10) (SRTSEQLIB)

Indique le nom de la variable utilisée pour extraire la bibliothèque de la table de séquence de tri pour l'utilisateur désigné. La valeur renvoyée est l'identificateur de la bibliothèque composé de 10 caractères. En l'absence d'un nom de table de séquence de tri, la variable est mise à blanc.

Variable pour OBJAUD (10) (OBJAUD)

Nom de la variable de 10 caractères utilisée pour extraire la valeur d'audit d'objet pour l'utilisateur indiqué. La valeur spéciale *NONE, *CHANGE ou *ALL, telle qu'elle est indiquée dans la commande CHGUSRAUD (Modifier un audit d'utilisateur), est renvoyée dans la variable. Lorsque l'utilisateur de cette commande ne dispose pas du droit spécial *ALLOBJ ou *AUDIT, la valeur *NOTAVL est renvoyée. Lorsque moins de 10 caractères sont renvoyés, la variable est complétée par des blancs à droite.

Variable pour AUDLVL (640) (AUDLVL)

Indique le nom de la variable utilisée pour extraire les valeurs d'audit d'action pour l'utilisateur désigné. Dans les programmes CL, la longueur de la variable est de 640 caractères. Le format renvoyé est une liste de 64 valeurs d'audit d'action au maximum, chacune d'elles étant composée de 10 caractères. Si la liste contient moins de 64 valeurs d'audit d'action à renvoyer, les valeurs restantes sont complétées à droite par des blancs.

Si l'utilisateur de cette commande ne dispose pas des droits spéciaux *ALLOBJ ou *AUDIT, la première valeur renvoyée est *NOTAVL suivie de blancs.

S'il n'existe aucune valeur d'audit d'action pour l'utilisateur, la première valeur renvoyée est *NONE suivie de blancs.

S'il existe des valeurs d'audit d'action pour l'utilisateur, une ou plusieurs des valeurs spéciales ci-dessous sont renvoyées dans la variable, tel que spécifié dans la commande CHGUSRAUD (Modifier l'audit d'utilisateur).

• *AUTFAIL
• *CMD
• *CREATE
• *DELETE
• *JOBBAS
• *JOBCHGUSR
• *JOBDTA
• *NETBAS
• *NETCLU
• *NETCMN
• *NETFAIL
• *NETSCK
• *NETSECURE
• *NETUDP
• *OBJMGT
• *OFCSRV
• *OPTICAL
• *PGMADP
• *PGMFAIL
• *PRTDTA
• *SAVRST
• *SECCFG
• *SECDIRSRV
• *SECIPC
• *SECNAS
• *SECRUN
• *SECSCKD
• *SECURITY
• *SECVFY
• *SECVLDL
• *SERVICE
• *SPLFDTA
• *SYSMGT

Variable pour GRPAUTTYP (10) (GRPAUTTYP)

Indique le nom de la variable utilisée pour extraire le type de droit à accorder au profil utilisateur sur les objets nouvellement créés. Dans les programmes CL, cette variable comporte 10 caractères. La variable reçoit la valeur spéciale *PRIVATE ou *PGP.

Variable pour SUPGRPPRF (150) (SUPGRPPRF)

Indique le nom de la variable utilisée pour extraire les profils de groupe supplémentaires pour l'utilisateur désigné. Dans les programmes CL, la variable comporte 150 caractères. Le format renvoyé constitue une liste de 15 groupes supplémentaires au maximum, chaque groupe ayant une longueur de 10 caractères. Si la liste comporte moins de 15 groupes, les postes restants sont complétés à droite par des blancs. Si l'utilisateur ne dispose pas de groupes supplémentaires, le premier poste contient la valeur *NONE suivie par des blancs.

Les profils de groupe supplémentaires sont renvoyés au format suivant :

Poste-1
   Profil de groupe supplémentaire (10 caractères)
Poste-2
   Profil de groupe supplémentaire (10 caractères)
    .
    .
    .
Poste-15
Profil de groupe supplémentaire (10 caractères)

Variable pour UID (10 0) (UID)

Indique le nom de la variable utilisée pour extraire le numéro d'identificateur de l'utilisateur désigné (UID). Dans les programmes CL, il doit s'agir d'une variable décimale de longueur (10 0).

Variable pour GID (10 0) (GID)

Indique le nom de la variable utilisée pour extraire l'identificateur de groupe (gid) de l'utilisateur désigné. Dans les programmes CL, il doit s'agir d'une variable décimale de longueur (10 0). La valeur renvoyée est un nombre à 10 chiffres ou la valeur 0 si le GID a pour valeur *NONE. La variable doit être un nombre à 10 chiffres sans décimales.

Variable pour SETJOBATR (160) (SETJOBATR)

Indique le nom de la variable utilisée pour l'extraction des attributs de travail définis à partir du nom de chemin d'environnement local de l'utilisateur désigné. Dans les programmes CL, la longueur de la variable est de 160 caractères. Le format renvoyé correspond à une liste dans laquelle sont définis jusqu'à 16 attributs de travail d'une longueur de 10 caractères chacun. Si la liste contient moins de 16 attributs, les entrées restantes sont complétées à droite par des blancs. Si aucun attribut n'est défini à partir du nom de chemin d'environnement local de l'utilisateur, la première entrée contient la valeur *NONE suivie de blancs.

Contrôle ID caractère (CHRIDCTL)

Indique le nom de la variable utilisée pour extraire le contrôle d'identificateur (ID) caractère pour l'utilisateur désigné. Dans les programmes CL, cette variable doit avoir une longueur de 10 caractères. La valeur spéciale *DEVD, *JOBCCSID ou *SYSVAL est renvoyée dans la variable. Si *SYSVAL est renvoyée, le paramètre CHRID pour l'utilisateur est déterminé par la valeur système QCHRIDCTL.

Variable pour LCLPWDMGT (10) (LCLPWDMGT)

Indique le nom de la variable utilisée pour extraire la commande de gestion locale du mot de passe de l'utilisateur désigné. Dans les programmes CL, cette variable doit avoir une longueur de 10 caractères. La valeur spéciale *YES ou *NO est renvoyée dans la variable.

Variable pour PWDCHGBLK (10) (PWDCHGBLK)

Indique le nom de la variable utilisée pour extraire la valeur de modification de blocage du mot de passe pour l'utilisateur désigné. La valeur *NONE, *SYSVAL, ou 1-99 peut être renvoyée dans la variable CL. Si *SYSVAL est renvoyé,la valeur de modification de blocage du mot de passe de l'utilisateur est déterminée par la valeur système QPWDCHGBLK. Dans les programmes CL, cette variable doit être composée de 10 caractères.

Variable pour USREXPDATE (6) (USREXPDATE)

Indique le nom de la variable utilisée pour extraire la date lorsque le profil utilisateur vient à expiration. La date est renvoyée au format AAMMJJ. Dans les programmes CL, il doit s'agir d'une variable à 6 caractères. En l'absence de date de péremption pour le profil utilisateur, des blancs sont renvoyés.

Variable pour USREXPITV (5 0) (USREXPITV)

Indique le nom de la variable utilisée pour extraire l'intervalle de péremption de l'utilisateur indiqué. Dans les programmes CL, il doit s'agir d'une décimale condensée de longueur (5,0). La valeur renvoyée est soit un nombre compris entre 1 et 366, soit 0 si aucun intervalle de péremption de l'utilisateur n'est défini pour le profil. Si une valeur autre que 0 est renvoyée, la zone réservée à l'intervalle de péremption de l'utilisateur (USREXPDATE) contient la date à laquelle le profil utilisateur vient à expiration.

Variable pour USREXPACT (10) (USREXPACT)

Indique le nom de la variable utilisée pour extraire l'action à exécuter lorsque le profil utilisateur vient à expiration. Dans les programmes CL, cette variable doit être composée de 10 caractères. La valeur spéciale *NONE, *DISABLE ou *DELETE est renvoyée dans la variable.

Var pour AUTCOL (1) (AUTCOL)

Indique le nom de la variable utilisée pour extraire l'indicateur qui spécifie si la collecte des droits est active pour cet utilisateur. Dans les programmes CL, cette variable doit être composée d'1 caractère. La valeur renvoyée est '0 ou '1'. La valeur '0' indique que la collecte des droits n'est pas active pour cet utilisateur. La valeur '1' indique que la collecte des droits est active pour cet utilisateur.

Var pour AUTCOLOBJ (1) (AUTCOLOBJ)

Indique le nom de la variable utilisée pour extraire l'indicateur qui spécifie si une collecte des droits existe pour cet utilisateur. Dans les programmes CL, cette variable doit être composée d'1 caractère. La valeur renvoyée est '0 ou '1'. La valeur '0' indique qu'il n'existe aucun référentiel de collecte des droits pour cet utilisateur. La valeur '1' indique qu'un référentiel de collecte des droits existe pour cet utilisateur.

Variable pour MAXSIGN (10) (MAXSIGN)

Indique le nom de la variable utilisée pour extraire le nombre maximal de tentatives d'ouverture de session. Dans les programmes CL, cette variable doit être composée de 10 caractères. Si la valeur est inférieure à la longueur de la zone, la valeur est complétée par des espaces à droite.

La valeur *SYSVAL ou une valeur comprise entre 1 et 25 peut être renvoyée. Si la valeur *SYSVAL esr renvoyée, la valeur système QMAXSIGN est utilisée pour déterminer le nombre maximal de tentatives d'ouverture de session. Si le nombre maximal de tentatives d'ouverture de session est atteint, l'action indiquée par la valeur système QMAXSGNACN sera exécutée.

Variable pour MAXSTG (11 0) (MAXSTG)

Indique le nom de la variable utilisée pour extraire la quantité maximale de mémoire secondaire pouvant être attribuée au stockage des objets permanents de l'utilisateur désigné.

Dans les programmes CL, il doit s'agir d'une variable décimale d'une longueur de (11 0). La variable doit se présenter sous la forme d'une valeur à 11 chiffres, sans position décimale. La valeur renvoyée est une valeur à 11 chiffres en kilooctets (1 kilooctet = 1024 octets), -1 si *NOMAX est spécifié, ou -2 si le volume de mémoire secondaire maximal est supérieur à 2 147 483 647. Utilisez le paramètre Variable CL MAXSTGLRG (20) (MAXSTGLRG) pour extraire une valeur supérieure à 2 147 483 647.

Variable pour STGUSED (15 0) (STGUSED)

Indique le nom de la variable utilisée pour extraire la quantité de mémoire secondaire servant à stocker des objets permanents appartenant au profil utilisateur indiqué.

Dans les programmes CL, il doit s'agir d'une variable décimale d'une longueur de (15 0). La variable doit être un nombre à 15 chiffres sans position décimale. La valeur renvoyée est une valeur à 15 chiffres en kilooctets (1 kilooctet = 1024 octets) ou -2 si le volume de mémoire secondaire maximal est supérieur à 2 147 483 647. Utilisez le paramètre Variable CL STGUSEDLRG (20) (STGUSEDLRG) pour extraire une valeur supérieure à 2 147 483 647.

Exemples

CRTUSRPRF   USRPRF(SMITH)  SPCAUT(*SAVSYS *SECADM)
            MAXSTG(*NOMAX)  PTYLMT(4)
            INLPGM(*NONE)  MSGQ(QGPL/SMITHMQ)
            OUTQ(QGPL/QSMITH)  TEXT('Profil utilisateur John Smith')

Si le profil utilisateur SMITH est créé à l'aide de la commande précédente, lorsque l'utilisateur SMITH appelle un programme en langage de contrôle contenant les éléments suivants :

DCL   &UNAME    *CHAR  10
DCL   &URIGHT   *CHAR  100
DCL   &IPGM     *CHAR  10
DCL   &IPGMLB   *CHAR  10
DCL   &UMSGQ    *CHAR  10
DCL   &UMSQLB   *CHAR  10
DCL   &USED     *CHAR  10
 :
RTVUSRPRF   USRPRF(*CURRENT)  STGUSED(&USED)  +
            RTNUSRPRF(&UNAME)  SPCAUT(&URIGHT)  +
            INLPGM(&IPGM)  INLPGMLIB(&IPGMLB)

Cette commande extrait les informations relatives au profil utilisateur en cours et les renvoie sous la forme des variables de programme en langage de contrôle suivantes :

&UNAME      'SMITH      '
&URIGHT    !'*SAVSYS   *SECADM   ...              !
           !____________100 caractères____________!
&IPGM       '*NONE      '
&IPGMLB     '           '

Messages d'erreur

Messages *ESCAPE

CPF2203

Profil utilisateur &1 incorrect.

CPF2204

Profil utilisateur &1 non trouvé.

CPF2213

Impossible d'allouer le profil utilisateur &1.

CPF2217

Non autorisé au profil utilisateur &1.

CPF2225

Impossible d'allouer objet système interne.

CPF8134

Profil utilisateur &4 endommagé.