Sessions

Cette section décrit les commandes sur les Sessions. L'Environnement par défaut peut être modifié.

Note : La commande uxupd n'existe pas pour les sessions

La commande uxadd SES crée une session dans la liste des sessions. Sa syntaxe est la suivante :

uxadd SES SES=session [VSES=version] [LABEL=label] HEADER=uproc [FATHER=uproc[(nnn)] [SONOK=((uproc(nnn),{XY}) (uproc(nnn),mu)...)] [SONKO=((uproc(nnn),{XY}) (uproc(nnn),mu)...)] [SONRC=((uproc(nnn),mu,RC) (uproc(nnn),{XY},RC)…)]

La commandeuxdup SES duplique une session. Sa syntaxe est la suivante :

uxdup SES SES=session VSES=version TSES=session TVSES=version [TLABEL=label]

La commande uxdlt SES supprime une session. Sa syntaxe est la suivante :

uxdlt SES SES=session [VSES=version]

La commande uxshw SES affiche les caractéristiques d'une session. Sa syntaxe est la suivante :

uxshw SES SES=session [VSES=version] [LST|LNK] [OUTPUT=filename]

La commande uxlst SES liste les sessions. Sa syntaxe est la suivante :

uxlst SES [SES=session] [VSES=version] [INF|FULL] [OUTPUT=filename]

La commande uxtra SES transfère les sessions dans un autre espace de la même société sur le même nœud. Sa syntaxe est la suivante :

uxtra SES SES=session [VSES=version] TESP=I|S|X

La commande uxext SES extrait la définition complète d'une session. Sa syntaxe est la suivante :

uxext SES SES=session [VSES=version] [REPL] [NOVERIF] OUTPUT=filename

La commande uxins SES insère la définition complète d'une session dans les fichiers correspondants de Dollar Universe pour le même espace et la même version de Dollar Universe que l'extraction. Sa syntaxe est la suivante :

uxins SES SES=session [VSES=version] [REPL] [ENABLE|NOENABLE] INPUT=filename

• Si des sessions ont été extraites de l'espace exploitation ou simulation (version 000), elles peuvent être insérées dans les espaces intégration ou application en définissant au préalable la nouvelle valeur de la version (paramètre nœud S_VSES_REINSERT, catégorie Réglages de l'interface commande) :

  S_VSES_REINSERT=XYZ

  XYZ étant la nouvelle valeur de la version de la session soit au minimum 001 pour pouvoir être insérée dans les espaces intégration ou application.

• Toutes les commandes d'insertion suivantes utiliseront ce paramètre pour définir la version des sessions insérées (quelque soit l'espace cible).

Description des items

• SES=

  Code session. Requiert la saisie d'un code session ou * (valeur générique acceptée sauf pour uxadd et uxdup).
  Format : 64 caractères alphanumériques.

• TSES=

  Code de la session résultat de la duplication.
  Format : 64 caractères alphanumériques.

• VSES=

  (Optionnel sauf pour uxdup) Version de session. Permet la saisie d'une version de session (valeur explicite).
  Format : 3 caractères numériques.

  Défaut : toutes les versions des sessions renseignées sont extraites (inutile avec EXP ou SIM).

• TVSES=

  Version de la session résultat de la duplication.
  Format : 3 caractères numériques.

• LABEL=

  (Optionnel) Libellé descriptif de la session.
  Format : 64 caractères alphanumériques.

• TLABEL=

  (Optionnel) Libellé descriptif de la session résultat de la duplication.
  Format : 64 caractères alphanumériques.

• TESP=

  Code de l'espace cible du transfert : X pour Exploitation, S pour Simulation ou I pour intégration.

• HEADER=

  Uproc entête de la session. Code de l'Uproc en tête de la session.
  Format : 64 caractères alphanumériques.

• FATHER=

  (Optionnel) Saisissez la première Uproc de la branche de la session. Ce code peut être suivi du numéro d'occurrence de l'Uproc au sein de la session (3 caractères numériques, pour différencier deux citations de la même Uproc dans la session) selon la syntaxe : uproc(nnn). L'Uproc FATHER doit être suivie de ses Uprocs SONOK, SONKO et SONRC.
  

• SONOK=

  (Optionnel) Décrit les Uprocs suivantes sur le chemin normal d'exécution. Code de l'Uproc enfant par rapport au FATHER précédent.

  Pour une seule Uproc : (uproc[(nnn)][,{XY}|mu])

  Si plusieurs Uprocs sont lancées en parallèle, l'ensemble du chemin est décrit entre parenthèses : ((uproc[(nnn)][,{XY}|mu]) (uproc[(nnn)][,{XY}|mu])…)

  • uproc : code de l'Uproc à lancer. 64 caractères alphanumériques.
  • nnn : (optionnel) numéro d'occurrence de l'Uproc dans la session. 3 caractères numériques.
  • {XY} : (optionnel) expression d'un TIH (facultatif) ou mu code d'une unité de gestion explicite. 64 caractères alphanumériques.
    Défaut : même UG.

• SONKO=

  (Optionnel) Décrit l'Uproc suivante sur le chemin erreur. Code de l'Uproc enfant par rapport au FATHER précédent, mêmes remarques et format que SONOK.

• SONRC=

  (Optionnel) Décrit l'Uproc suivante sur le chemin code retour. Code de l'Uproc enfant par rapport au FATHER précédent.

  Pour une seule Uproc : (uproc[(nnn)],[{XY}|mu],returncode)

  Si plusieurs Uprocs sont lancées en parallèle, l'ensemble du chemin est décrit entre parenthèses : ( (uproc[(nnn)],[{XY}|mu],returncode) (uproc[(nnn)],[{XY}|mu],returncode) …)

  • uproc : code de l'Uproc à lancer. 64 caractères alphanumériques.
  • nnn : (optionnel) numéro d'occurrence de l'Uproc dans la session. 3 caractères numériques.
  • {XY} : (optionnel) expression d'un TIH (facultatif) ou mu code d'une unité de gestion explicite. 64 caractères alphanumériques. Si ce champ utilise la valeur par défaut, la virgule doit être saisie si un code retour doit être spécifié.
    Défaut : même UG.
  • coderetour : code retour de l'Uproc parent qui doit lancer l'Uproc enfant. Vous pouvez saisir une expression du même type que celle utilisée pour déterminer le code retour étendu de l'Uproc EXT_RETCODE=.
    Format : n1;n2;[n3,n4];[n5,n6]/n7 sur 64 caractères maximum. La liste des valeurs peut être composée:

    • D'une valeur simple : format : * ou nombre entier positif ou négatif (de -32767 à 32768).
      Exemple: -2.

    • D'une plage de valeurs entières positives ou négatives (de -32767 à 32768) : format : [min,max].
      Exemple: [-10,10] : de -10 à 10 inclus.

    • De valeurs calculées à partir d'un multiple. Format : N/m (N positif ou négatif, m positif uniquement).
      Exemple: */3 : tous les multiples de 3.

    • De valeurs calculées dans une plage (de -32767 à 32768) selon le multiple spécifié (m positif uniquement) : format [min,max]/m.
      Exemple: [1,10]/4 : 4 et 8.
      Chacune des valeurs ou des plages doit être séparée par un point virgule. La liste ne doit pas dépasser 64 caractères.
      Exemple: -2;[-10,10];*/3;[1,10]/4.

    • Défaut : *

• REPL

  (Optionnel) Indicateur de remplacement. Indique si l'enregistrement extrait (inséré) annule et remplace l'enregistrement déjà existant dans le fichier de destination;

  Défaut : l'extraction (l'insertion) est refusée pour chaque enregistrement déjà existant (signalé par un message pour chaque occurrence).

• NOVERIF

  (Optionnel) peut être utilisé avec la commande uxext uniquement. Cette option permet de ne pas vérifier le fichier d'extraction avant d'y écrire de nouveaux enregistrements et d'améliorer ainsi les performances de cette commande. Cet item ne doit être utilisé que pour un nouveau fichier.

• ENABLE

  (Optionnel) Option de libération. Indique si l'Uproc sera insérée dans l'état libéré. L'action de libération sera nécessaire avant toute modification d'Uproc si l'objet est inséré avec le qualifier NOENABLE.

  Défaut : ENABLE.

• LST | LNK

  (Optionnel) Option d'affichage de uxshw.

  • LST : Liste des Uprocs de la session. Indique que le résultat de la commande uxshw doit être la liste des Uprocs de la session, si une Uproc est citée deux fois ou plus dans la session, elle n'apparaîtra qu'une seule fois dans cette liste.
  • LNK : Liste des Uprocs de la session. Indique que le résultat de la commande uxshw doit présenter la session sous la forme d'un tableau décrivant les liens entre les Uprocs, les chemins normaux, code retour et dégradés.

  Défaut : LST

• INF | FULL

  (Optionnel) Option d'affichage.

  • INF : Limite l'affichage au nom des objets.
  • FULL : Affiche toutes les informations disponibles sur la liste des objets.

  Défaut : FULL

• OUTPUT=

  • Fichier de sortie de la commande uxext.
  • (Optionnel) Fichier de stockage de l'affichage pour les commandes uxshw ou uxlst.

  Défaut : la sortie est envoyée à l'écran.

• INPUT=

  Fichier d'entrée pour la commande uxins.

Exemples

• Crée une session "SES_TEST" dans l'environnement courant (société, nœud) selon le schéma suivant :

  

  uxadd SES EXP SES=SES_TEST label=\"Creation session\" HEADER=IU_TEST FATHER=IU_TEST SONOK=((IU_TST000)(IU_TST001(001))) SONKO=((IU_ERR)) FATHER=IU_TST000 SONOK=((IU_TST002,{A })) FATHER=IU_ERR SONOK=((IU_TST001(002))) FATHER=IU_TST001(002) SONKO=((IU_ALARM))

• Crée une session avec 3 branches (vous pouvez insérer un \ pour écrire la commande sur plusieurs lignes) :

  uxadd SES EXP SES=SES_TEST LABEL=\"Create session\" HEADER=IU_TEST \

  FATHER=IU_TEST SONOK="((IU_TEST2)(IU_TEST3(001)))" SONKO="((IU_ALARM(002)))" \

  FATHER=IU_TEST2 SONOK="((IU_TEST3(003),{A }))" \

  FATHER=IU_TEST3\(003\) SONOK="((D_BACKUP))" SONKO="((IU_ALARM(004)))"

• Créé la session D_LOAD_BCK composée de l'entête D_LOAD_FIL suivie de l'Uproc D_BACKUP en chemin normal sur la même unité de gestion d'exécution.

  uxadd SES EXP SES=D_LOAD_BCK label=\"Load file\" HEADER=D_LOAD_FIL FATHER=D_LOAD_FIL SONOK="((D_BACKUP))"

• Crée une session avec 1 Uproc sur le chemin normal et 2 Uprocs sur le chemin code retour :

  uxadd ses ses=MYSESSION LABEL=\"Create session\" HEADER=HEADER FATHER=HEADER SONOK=((MYSONOK)) SONRC="((MYSONCR4,,4) (MYSONANY))"

• Duplique une session dans l'espace Exploitation :

  uxdup SES EXP SES=TEST VSES=000 TSES=TEST2 TVSES=000 TLABEL=\"Session de test\"

• Supprime la session "SES_TEST" dans l'environnement courant (société, nœud, espace).

  uxdlt SES SES=SES_TEST

• Affiche une session avec ses Uprocs et les liens entre elles :

  uxshw SES EXP SES=D_LOAD_BCK LNK

  La colonne "Return Code" affiche le code retour attendu pour déclencher cette Uproc dans le cas d'un lien Code retour entre l'Uproc parent et l'Uproc enfant : code retour 4 pour l'Uproc MYSONCR4, code retour * pour l'Uproc MYSONANY.

  uxshw ses ses=MYSESSION lnk vses=*

  TYPE .| ses

  ITEMS .| ses : MYSESS
  .| vses : 000
  .| label :
  .| header : HEADER
  .| links :
  .|
  .|| NumF | NumS | Path | Father .| Son | HDP/MU | Return Code ||
  .|| 0001 | 0002 | OK | HEADER | MYSONOK | { } | ||
  .|| 0001 | 0003 | CR | | MYSONCR4 | { } | 4 ||
  .|| 0001 | 0004 | CR | | MYSONANY | { } | * ||"

• Liste les sessions dans le fichier c:\temp\LstSes.txt :

  uxlst SES OUTPUT=c:\temp\LstSes.txt

• Transfère toutes les sessions commençant par D_ de l'espace Application vers l'espace Exploitation :

  uxtra SES app SES=D_* TESP=X

• Extrait toutes les sessions commençant par D_ de l'espace exploitation et archive les données dans le fichier c:\temp\DOC.ext :

  uxext SES EXP SES=D_* output=c:\temp\DOC.ext

• Insère toutes les sessions du fichier c:\temp\DOC.ext dans l'environnement courant (société, nœud) en espace exploitation sauf si elles existent déjà :

  uxins SES EXP SES=* input=c:\temp\DOC.ext