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
-
RCPDestinataire obligatoire -
SUBJECTObjet -
MSGMessage -
ESCALATIONListe d'escalades -
RTNINTNETAdresse Internet de retour -
SPLFFichier spoule -
JOBNom du travail -
SPLNBRNuméro du fichier de spoule -
PAGERANGEPages à envoyer, plage -
SLTTXTSélection de pages -
ATTACHNom de pièce jointe -
SUFFIXSuffixe de pièce jointe -
RMVSPLFRetrait du fichier spoule -
TOINTNETAdresse Internet -
ADRLOCEmplacement de l'adresse -
PGMProgramme d'exit
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.
- 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.
Messages d'erreur
Unknown© Copyright IBM Corp. Texte d'aide reproduit à des fins de formation.