DSPNCK

La commande DSPNCK (Afficher un alias) permet d'afficher, imprimer ou créer un fichier base de données en sortie pour les alias dans le répertoire de distribution du système.

Un alias est le nom abrégé d'un poste de répertoire ou d'un nom de liste de diffusion. Pour plus d'informations sur les alias, reportez-vous au manuel SNA Distribution Services, SC41-5410.

La sortie générée par cette commande est dirigée comme suit :

• Pour une sortie affichée, une liste de tous les alias est affichée par défaut. Lorsqu'un alias est précisé, seules des informations détaillées sur cet alias sont affichées.
• Pour une sortie imprimée ou dirigée vers un fichier base de données, tous les alias auxquels l'utilisateur a accès sont écrits. Lorsqu'un alias est indiqué, seules des informations détaillées concernant cet alias sont écrites dans le fichier en sortie.

Restriction : Pour afficher un alias privé, vous devez en être le propriétaire. En revanche, aucun droit spécial n'est requis pour afficher un alias privé dont vous êtes propriétaire, ou un alias public.

Paramètres

Alias (NCK)

Indique les alias à afficher, imprimer ou écrire dans un fichier base de données.

Les valeurs d'alias possibles sont les suivantes :

*ALL

Tous les alias du répertoire de distribution du système sont dirigés en sortie.

alias

Indiquez l'alias pour lequel des informations détaillées doivent être dirigées en sortie.

Les valeurs possibles d'accès à l'alias sont les suivantes :

*PRV

Le dernier accès précisé par l'utilisateur en cours pour afficher, sélectionner ou gérer des alias est utilisé.

*ALL

Tous les alias auxquels vous avez accès sont dirigés en sortie, notamment les alias privés dont vous êtes propriétaire et tous les alias publics du répertoire de distribution du système.

*PRIVATE

Les alias privés dont vous êtes propriétaire sont dirigés en sortie.

*PUBLIC

Tous les alias publics du répertoire de distribution de système sont dirigés en sortie.

Type d'alias (TYPE)

Indique le type d'alias (utilisateur ou liste) à afficher, imprimer ou écrire dans un fichier base de données.

*ALL

Tous les alias de types utilisateur et liste sont dirigés en sortie.

*USER

Les alias utilisateur sont dirigés en sortie.

*LIST

Les alias de liste sont dirigés en sortie.

Propriétaire (OWNER)

Indique le propriétaire des alias à afficher, imprimer ou écrire dans un fichier base de données.

*ALL

Les alias appartenant à tous les profils utilisateur sont dirigés en sortie. Les alias privés auxquels l'utilisateur n'a pas accès ne sont pas inclus.

*CURRENT

Les alias appartenant à l'utilisateur en cours sont dirigés en sortie.

nom-du-profil-utilisateur

Indiquez le profil utilisateur du propriétaire dont les alias doivent être dirigés en sortie.

Sortie (OUTPUT)

Indique si la sortie générée par la commande est affichée sur le poste de travail demandeur, imprimée avec la sortie spoule du travail ou écrite dans un fichier base de données.

*

La sortie demandée par un travail interactif s'affiche à l'écran. Si la commande est exécutée dans un travail par lots, la sortie est imprimée avec la sortie spoule du travail.

*PRINT

La sortie est imprimée avec la sortie spoule du travail.

*OUTFILE

La sortie est dirigée vers le fichier base de données indiqué au paramètre OUTFILE.

Fichier recevant la sortie (OUTFILE)

Indique le nom du fichier base de données vers lequel la sortie doit être dirigée. Si le fichier n'existe pas, cette commande crée le fichier base de données dans la bibliothèque indiquée. Le texte du fichier créé est "OUTFILE for DSPNCK" et le droit public est le droit d'exclusion *EXCLUDE.

Remarque :Ce paramètre est requis lorsque OUTPUT(*OUTFILE) est indiqué.

Le nom du fichier base de données peut être accompagné de 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.

nom-bibliothèque

Indiquez le nom de la bibliothèque sur laquelle doit porter la recherche.

La seule valeur possible est la suivante :

nom-fichier-base-données

Indiquez le nom du fichier base de données devant recevoir la sortie. Si le fichier n'existe pas, il est créé dans la bibliothèque indiquée. S'il n'existe pas et qu'aucune bibliothèque n'est indiquée, ou s'il est qualifié par *LIBL, mais que le système ne parvient pas à le trouver, il est créé dans la bibliothèque par défaut de l'utilisateur. Celle-ci est précisée dans le profil de l'utilisateur en cours. Si ce n'est pas le cas, le fichier est créé dans la bibliothèque QGPL.

Options pour membre de sortie (OUTMBR)

Indique le nom du membre du fichier base de données vers lequel est dirigée la sortie. Si un membre existe déjà, le système utilise le deuxième élément de ce paramètre pour déterminer si le membre est effacé avant d'ajouter les nouveaux enregistrements. Si le membre n'existe pas et qu'aucun nom de membre n'est indiqué, le système crée un membre en lui donnant le nom du fichier en sortie précisé au paramètre OUTFILE. Si un nom de membre de fichier en sortie est indiqué, mais que le membre n'existe pas, le système le crée.

Les valeurs possibles pour le membre en sortie sont les suivantes :

*FIRST

Le premier membre du fichier reçoit la sortie. Si OUTMBR(*FIRST) est indiqué et que le membre n'existe pas, le système crée un membre portant le nom du fichier indiqué au paramètre OUTFILE.

nom-membre

Indiquez le membre du fichier qui reçoit la sortie. Si OUTMBR(nom-membre) est indiqué et que le membre n'existe pas, ce dernier est créé par le système.

Les valeurs possibles d'action sur le membre sont les suivantes :

*REPLACE

Le système efface le membre existant et ajoute les nouveaux enregistrements.

*ADD

Le système ajoute les nouveaux enregistrements à la suite des enregistrements existants.

Exemples

Exemple 1 : affichage d'une liste d'alias

DSPNCK   NCK(*ALL *PRIVATE)

Cette commande montre une liste des alias privés à leur propriétaire. Celui-ci peut alors demander d'afficher ou d'imprimer des informations complémentaires pour les alias affichés.

Exemple 2 : impression d'une liste d'alias

DSPNCK   NCK(MANAGER *PRIVATE)  OUTPUT(*PRINT)

Cette commande imprime des informations détaillées sur l'alias privé MANAGER de l'utilisateur.

Exemple 3 : transcription des alias dans un fichier de base de données

DSPNCK   NCK(*ALL *PUBLIC)  OUTPUT(*OUTFILE)  OUTFILE(ALLNICKS)
         OUTMBR(*FIRST *REPLACE)

Cette commande retranscrit dans le fichier de base de données ALLNICKS un enregistrement pour chaque alias public du répertoire. Si ce fichier est introuvable dans la liste des bibliothèques (le qualificateur de bibliothèque par défaut), il est créé dans la bibliothèque par défaut de l'utilisateur ou dans la bibliothèque QGPL si aucune bibliothèque utilisateur par défaut n'a été définie.

Exemple 4 : transcription des alias pour un propriétaire dans un fichier de base de données

DSPNCK   NCK(*ALL *PUBLIC)  OWNER(CDJONES)  OUTPUT(*OUTFILE)
         OUTFILE(NICKNAME/CDJONES)
         OUTMBR(*FIRST *REPLACE)

Cette commande retranscrit dans le fichier de base de données CDJONES de la bibliothèque NICKNAME un enregistrement pour chaque alias public possédé par l'utilisateur dont le profil utilisateur est CDJONES. Si ce fichier est introuvable dans la bibliothèque NICKNAME, il est créé.

Messages d'erreur

Messages *ESCAPE

CPF9A89

Echec de la fonction d'alias.

CPF9009

Le fichier &1 de la bibliothèque &2 doit être journalisé.

CPF9820

Non autorisé à utiliser la bibliothèque &1.

CPF9822

Non autorisé au fichier &1 de &2.

CPF9838

Limite mémoire du profil utilisateur dépassée.

CPF9845

Erreur lors de l'ouverture du fichier &1.

CPF9846

Erreur lors du traitement du fichier &1 de &2.

CPF9847

Erreur lors de la fermeture du fichier &1 de bibliothèque &2.

CPF9850

Substitution non admise pour fichier imprimante &1.

CPF9851

Valeur de ligne fin de page trop faible pour fichier &1 dans &2.

CPF9860

Erreur lors du traitement du fichier de sortie.