Des paramètres nœuds peuvent être définis pour configurer le protocole FTP ou SFTP. Reportez-vous à la section Dollar Universe – Paramétrage FTP. Pour modifier un comportement local, ces variables peuvent être modifiées dans les variables de nœud, d'unité de gestion, d'Uproc et aussi dans le script de l'Uproc (dans cet ordre de priorité, le plus prioritaire étant le script).
Les paramètres hôte, fichier origine, chemin origine, fichier cible et chemin cible peuvent contenir des parties variables qui sont évaluées par Dollar Universe au moment de la soumission de l'Uproc.
Ces parties variables sont encadrées du caractère ‘!’ sous la forme !CODE:FORMAT!. Le caractère "!" ne doit donc pas être contenu dans le nom de la variable.
CODE
Peut être un code décrit dans le tableau suivant, ou bien n’importe quelle variable nœud, UG, Uproc, tâche, Lancement ou variable d’environnement du batch (examinées dans cet ordre).
Code |
Signification |
---|---|
DTRAIT ou PDATE |
Date de traitement : variable S_DATRAIT. Par défaut sous le format AAAAMMDD. Règles de format particulières (ci-dessous). |
DTRAIT_X ou PDATE_X |
Date de traitement : variable S_DATRAIT_X. Format indiqué par la variable d'environnement U_FMT_DATE. |
COMP ou SOC |
Société : variable S_SOCIETE. |
NOEUD ou NODE |
Nœud : variable S_NOEUD. |
ESP ou AREA |
Espace : variable S_ESPEXE. |
UG ou MU |
Unité de gestion : variable S_CODUG. |
APP |
Application : variable S_APPLI. |
UPR |
Uproc : variable S_PROCEXE. |
SESS |
Session : variable S_CODSESS. |
FIC |
Variable FIC, valeur obtenue par la table des répertoires des unités de gestion. |
EXE |
Variable EXE, valeur obtenue par la table des répertoires des applications. |
FORMAT
Peut être nul, sinon il est présenté sous la forme n,p. Ce qui signifie prendre les p caractères de la valeur de la variable à partir de la position n (n commence à 1).
Attention ! Le code DTRAIT admet un format particulier : n’importe quelle combinaison de chaînes ‘AAAA’ (ou ‘YYYY’), ‘AA’ (ou ‘YY’), ‘MM’, ‘JJ’ (ou ‘DD’).
Dollar Universe cherche d’abord s’il s’agit d’un code (voir liste des codes dans le tableau ci-dessous), ensuite d’une variable.
Pour spécifier le caractère ‘!’ lui-même dans le nom d'hôte : il faut le précéder du caractère '\'. Utilisez la séquence ‘\!’. Exemple : pour utiliser !FRSDAIX!VAR! (avec VAR une variable), la syntaxe correcte est : \!FRSDAIX!VAR!
Pour spécifier le caractère ‘!’ lui-même dans un chemin ou un nom de fichier : il faut le précéder du caractère '#'. Utilisez la séquence '#!'. Exemple : pour utiliser c:\!rep\!VAR!, (avec !rep un nom de chemin et VAR une variable codée !VAR!), la syntaxe correcte est : c:\#!rep\!VAR!
Si le code indiqué n’est ni un code Dollar Universe valide, ni une variable existante, la chaîne !CODE:FORMAT! est remplacée par une chaîne vide (variable non trouvée).
Si le nom de fichier ou de répertoire obtenu après remplacement de toutes les parties variables est plus grand que la taille maximale admissible (256 caractères), le traitement se termine en erreur avec un message précis.
Exemples
!CODE:FORMAT! utilisés avec des variables et la valeur obtenue :
!DTRAIT! 20110427
!DTRAIT:DD-MM-YY! 27-04-11
!COMP! UNIV60
!COMP:4,3! V60
Il est possible d'utiliser les caractères génériques "?" et "*" dans les noms de fichier (pas dans les chemins).
Des règles s'appliquent sur la combinaison des caractères génériques :
Il est donc possible d'écrire par exemple:
Par contre (au vu des règles et de la signification des caractères génériques) les exemples suivants n'ont pas de sens :