Aller au contenu

SNDDSTJS

Envoyer distribution via JS

En bref

La commande SNDDSTJS vous permet d'envoyer un fichier spoule joint à un nouveau message de distribution à un destinataire ou une liste d'escalades.

SNDDSTJS se lit SND (Envoyer) + DSTJS. Sur IBM i, le nom d'une commande associe presque toujours un verbe et un objet.

Syntaxe minimale

SNDDSTJS RCP(…)

Paramètres

Astuce : dans une session 5250, tapez SNDDSTJS 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 QIJS)

Où s'exécute : Tous les environnements (*ALL)
Compatible multitâche : Non

La commande SNDDSTJS vous permet d'envoyer un fichier spoule joint à un nouveau message de distribution à un destinataire ou une liste d'escalades. Les informations concernant le destinataire peuvent être indiquées de manière explicite ou extraites d'un fichier spoule.

Remarque :Il est nécessaire d'utiliser une interface graphique pour afficher les messages et arrêter l'escalade.

Paramètres

Mot-clé Description Valeurs possibles Remarques
RCP Destinataire Valeurs uniques: *NONE, *SPLF, *ONCALL
Autres valeurs (jusqu'à 50 répétitions): Nom
Obligatoire, positionnel 1
SUBJECT Objet Valeur caractère, *NONE Facultatif
MSG Message Valeur caractère, *NONE Facultatif
ESCALATION Liste d'escalades Valeur caractère, *NONE, *RCP Facultatif
RTNINTNET Adresse Internet de retour Valeur caractère, *RTNDFT Facultatif
SPLF Fichier spoule Nom, *NONE Facultatif
JOB Nom du travail Valeurs uniques: *
Autres valeurs: Nom de travail qualifié
Facultatif
Qualificatif 1: Nom du travail Nom
Qualificatif 2: Utilisateur Nom
Qualificatif 3: Numéro 000000-999999
SPLNBR Numéro du fichier de spoule Entier, *ONLY, *LAST Facultatif
PAGERANGE Pages à envoyer, plage Liste d'éléments Facultatif
Élément 1: Page de début 1-99999999, 1
Élément 2: Page de fin 1-99999999, *END
SLTTXT Sélection de pages Liste d'éléments Facultatif
Élément 1: Texte de sélection Valeur caractère, *NONE
Élément 2: Numéro de ligne 0-256
Élément 3: Position de début 0-256
ATTACH Nom de pièce jointe Nom, *SPLF, *NONE Facultatif
SUFFIX Suffixe de pièce jointe Valeur caractère, PDF Facultatif
RMVSPLF Retrait du fichier spoule *NO, *YES Facultatif
TOINTNET Adresse Internet Values (jusqu'à 50 répétitions): Valeur caractère, *NONE Facultatif
ADRLOC Emplacement de l'adresse Liste d'éléments Facultatif
Élément 1: Numéro de ligne 0-256, *TEXT
Élément 2: Position de début 0-256, *AFTER
Élément 3: Longueur 0-60
Élément 4: Texte Valeur caractère
PGM Programme d'exit Valeurs uniques: *NONE
Autres valeurs: Nom d'objet qualifié
Facultatif
Qualificatif 1: Programme d'exit Nom
Qualificatif 2: Bibliothèque Nom, *LIBL, *CURLIB

Destinataire (RCP)

Destinataire auquel vous voulez envoyer le message de distribution.

Remarque :Il est nécessaire d'utiliser l'interface graphique pour créer et mettre à jour les informations de courrier électronique des destinataires.

Ce paramètre est obligatoire.

Valeurs uniques

*NONE
Aucun destinataire n'est indiqué pour le message de distribution. Vous devez indiquer une adresse Internet.
*SPLF
Les informations relatives au destinataire sont extraites du fichier spoule joint.
*ONCALL
Seuls les destinataires qui sont de garde reçoivent le message.

Autres valeurs (jusqu'à 50 répétitions)

nom
Indiquez le nom du destinataire. Appuyez sur F4 à l'invite pour effectuer votre choix dans la liste des destinataires existants.

Objet (SUBJECT)

Objet du message de distribution.

*NONE
Aucun objet n'a été défini pour ce message de distribution.
valeur-alphanumérique
Indiquez l'objet du message de distribution.

Message (MSG)

Texte du message de distribution.

Remarque :Utilisez le symbole &N dans le corps du message pour forcer un retour ligne.

*NONE
Il n'existe aucun corps de message pour le message de distribution.
valeur-alphanumérique
Indiquez le corps de message du message de distribution.

Liste d'escalades (ESCALATION)

Liste d'escalades pour le message de distribution.

Remarque :Il est nécessaire d'utiliser une interface graphique pour gérer les listes d'escalades.

*RCP
La liste d'escalades utilisée pour le message de distribution est celle qui est associée au destinataire.
*NONE
Aucune liste d'escalades n'est utilisée pour le message de distribution.
valeur-alphanumérique
Indiquez le nom de la liste d'escalades pour le message de distribution.

Adresse Internet de retour (RTNINTNET)

Adresse Internet de retour (i.e. adresse de courrier électronique) pour le message de distribution.

*RTNDFT
Utilisez l'adresse Internet de retour indiquée dans les propriétés de courrier électronique.
valeur-alphanumérique
Indiquez l'adresse de courrier électronique de retour pour le message de distribution.

Fichier spoule (SPLF)

Fichier spoule que vous voulez joindre au message de distribution.

Remarque :Les fichiers spoule contenant des graphiques ne sont pas acceptés.

*NONE
Vous ne voulez pas envoyer de fichier spoule avec le message de distribution.
nom
Indiquez le nom du fichier spoule à joindre au message de distribution.

Nom du travail (JOB)

Nom du travail qui a créé le fichier spoule joint au message de distribution.

Valeurs uniques

*
Le travail qui a créé le fichier spoule est celui qui a émis la commande.

Nom qualifié 1 : Nom du travail

nom
Indiquez le nom du travail qui contient le fichier spoule.

Nom qualifié 2 : Utilisateur

nom
Indiquez le nom de l'utilisateur qui a créé le fichier spoule.

Nom qualifié 3 : Numéro

000000-999999
Indiquez un numéro compris entre 000000 et 999999, correspondant au numéro de travail attribué par le système.

Numéro du fichier de spoule (SPLNBR)

Numéro unique du fichier spoule joint au message de distribution.

*ONLY
Un seul fichier spoule du travail porte le nom de fichier indiqué ; par conséquent, le numéro de fichier spoule n'est pas nécessaire.
*LAST
S'il existe plusieurs fichiers spoule portant le nom du fichier indiqué, c'est celui qui porte le numéro le plus élevé qui est envoyé.
entier
Indiquez le numéro du fichier spoule correspondant au fichier que vous souhaitez envoyer.

Pages à envoyer, plage (PAGERANGE)

Plage à envoyer.

Elément 1 : Page de début

1
Première page du fichier spoule.
page-début
Indiquez la page de début à envoyer.

Elément 2 : Page de fin

*END
La dernière page du fichier correspond à la page de fin à envoyer.
page-fin
Indiquez la page de fin à envoyer.

Sélection de pages (SLTTXT)

Texte figurant dans une page du fichier spoule et que vous voulez sélectionner pour le joindre au message de distribution.

Remarque :Pour rechercher le texte de sélection sur la totalité de la page, n'indiquez pas de numéro de ligne ou de position de début.

Elément 1 : Texte de sélection

*NONE
L'intégralité du fichier spoule va être envoyée.
valeur-alphanumérique
Indiquez le texte figurant dans une page du fichier spoule que vous voulez sélectionner et joindre à un message de distribution. Vous pouvez, par exemple, indiquer SLTTXT('Account - 1234'), et IBM Advanced Job Scheduler for i sélectionnera les pages contenant 'Account - 1234' afin de l'envoyer au destinataire indiqué.

Elément 2 : Numéro de ligne

0-256
Indiquez le numéro de ligne dans le fichier spoule.

Elément 3 : Position de début

0-256
Indiquez la position de début dans le fichier spoule.

Nom de pièce jointe (ATTACH)

Nom à utiliser pour la pièce jointe au message de distribution.

*SPLF
Le nom de la pièce jointe correspond au nom indiqué pour le paramètre Fichier spoule (SPLF).
*NONE
Aucun nom de pièce jointe n'est indiqué. Le fichier spoule va être imbriqué dans le corps du message.
nom
Indiquez le nom de la pièce jointe au fichier spoule.

Suffixe de pièce jointe (SUFFIX)

Indiquez le nom du suffixe de la pièce jointe au fichier spoule. Vous pouvez indiquer une extension comportant 3 ou 4 caractères pour le fichier spoule. Le suffixe par défaut est PDF pour une conversion de format PDF. En modifiant le suffixe, vous ne modifiez pas le format du fichier. Ainsi, un fichier joint de suffixe TXT aura simplement les caractéristiques d'un fichier texte lors de l'envoi, même si ce n'en est pas vraiment un. Vous devez alors avoir un fichier texte sur votre système.

Remarque :Outre PDF, TXT est le seul suffixe correctement converti en pièce jointe à un courrier électronique.

PDF
La pièce jointe est convertie au format PDF (Portable Document Format).
valeur-alphanumérique
Indiquez le suffixe de fichier de la pièce jointe au fichier spoule.

Retrait du fichier spoule (RMVSPLF)

Indique si vous voulez retirer le fichier spoule du fichier spoule de votre système une fois le message de distribution envoyé.

*NO
Vous ne souhaitez pas retirer le fichier spoule une fois le message envoyé.
*YES
Vous souhaitez retirer le fichier spoule une fois le message envoyé.

Adresse Internet (TOINTNET)

Adresse Internet (i.e. adresse de courrier électronique) pour le message de distribution.

*NONE
Aucune adresse Internet n'est indiquée pour ce message.
valeur-alphanumérique
Indiquez l'adresse Internet pour le message de distribution.

Emplacement de l'adresse (ADRLOC)

Paramètres de recherche d'informations d'adresse pour le message de distribution. Ils incluent le numéro de ligne dans le fichier spoule, la position de début, la longueur et le texte de recherche. Vous pouvez extraire une adresse de courrier électronique à partir de chaque page du fichier spoule ou utiliser un programme d'exit et la valeur extraite de chaque page du fichier spoule. Ainsi, vous pouvez indiquer que l'adresse de courrier électronique d'une facture figure toujours à la ligne 3, position 45, que sa longueur est égale à 40, ou qu'elle figure à la suite du mot Email:, ou encore que le numéro de compte d'un client suit le mot 'Compte:' et que sa longueur est égale à 10, et qu'un programme d'exit doit extraire l'adresse de courrier électronique correspondante.

Elément 1 : Numéro de ligne

*TEXT
La fonction de recherche de texte est utilisée pour localiser l'adresse.
0-256
Indiquez le numéro de ligne dans le fichier spoule.

Elément 2 : Position de début

*AFTER
La position de début correspond au premier caractère suivant le texte de recherche localisé.
0-256
Indiquez la position de début dans le fichier spoule.

Elément 3 : Longueur

0-60
Indiquez la longueur des informations d'adresse.

Elément 4 : Texte

valeur-alphanumérique
Indiquez le texte à rechercher dans le fichier spoule.

Programme d'exit (PGM)

Programme que IBM Advanced Job Scheduler for i va utiliser pour extraire l'adresse. Le paramètre ADRLOC peut être utilisé pour localiser les informations essentielles dont le programme aura besoin pour trouver l'adresse. Ce programme écrit par l'utilisateur doit comporter 2 paramètres. Le premier est un paramètre alphanumérique sur 60 octets. Il contient la valeur extraite du fichier spoule à partir du numéro de ligne, d'une position de début et d'une longueur. Le second est un paramètre alphanumérique sur 256 octets. Il doit renvoyer l'adresse électronique à utiliser lors de l'envoi de cette page du fichiers spoule. Si aucune adresse n'est trouvée, ce paramètre doit renvoyer des caractères blancs.

Valeurs uniques

*NONE
Aucun programme n'est utilisé pour extraire l'adresse.

Nom qualifié 1 : Programme d'exit

nom
Indiquez le nom du programme d'exit.

Nom qualifié 2 : Bibliothèque

*LIBL
Le programme est recherché dans la liste des bibliothèques.
*CURLIB
Le programme est recherché dans la bibliothèque en cours. Si aucune bibliothèque en cours n'est définie pour le travail, la bibliothèque QGPL est utilisée.
nom
Indiquez le nom de la bibliothèque contenant le programme d'exit.

Exemples

SNDDSTJS   SPLF(QPINVOICE)  JOB(*)  SPLNBR(*LAST)
           MSG('Ci-joint votre facture.')
           PGM(MYLIB/PGMEXIT)  ADRLOC(5 3 10)

Cette commande envoie le dernier fichier spoule créé intitulé QPINVOICE pour le travail en cours sous forme de pièce jointe au courrier électronique. Le programme d'exit PGMEXIT de la bibliothèque MYLIB va être appelé. Le numéro de compte figure à la ligne 5 de chaque page du fichier spoule, position 3, et sa longueur est égale à 10. Un programme est appelé pour extraire l'adresse de courrier électronique correspondant au numéro de compte trouvé dans le fichier spoule.

© Copyright IBM Corp. Texte d'aide reproduit à des fins de formation.