Introduction

Bienvenue dans le Manuel Commandes de Dollar Universe ! Ce manuel décrit toutes les commandes utilisateur de Dollar Universe. Les commandes d'administration sont décrites dans le manuel d'administration de Dollar Universe ou d'Univiewer.

Les commandes de Dollar Universe permettent d'agir sur l'automate depuis un environnement extérieur (applicatif client, shell UNIX, scripts...). Elles se répartissent en groupes présentés dans les chapitres suivants de ce manuel :

Les Commandes de paramétrage pour définir ou de modifier le paramétrage de Dollar Universe.
Les Commandes d'exploitation pour consulter et d'intervenir sur l'exploitation en dehors des interfaces graphiques.
Les Commandes de gestion de batch pour soumettre et de surveiller des exécutions.
Les Commandes FTP pour transférer des données par FTP (sauf OS/400).
Les Commandes DQM pour gérer les queues batch et les jobs dans les queues batch.
Les Commandes de gestion de date (sauf OS/400).
Les Commandes du CL des Uprocs pour agir sur l'automate depuis le script d'une Uproc.

Note: Les commandes de gestion du paramétrage qui permettent d'extraire les objets du paramétrage d'une Société v5 ou v6 (y compris les événements jobs) afin d'obtenir un fichier au format XML, de vérifier le format du fichier XML, d'insérer ce paramétrage dans une Société v6, sont documentées dans l'article Export – Import de paramétrage.

Commandes de paramétrage

Valide sous Windows / UNIX / OpenVMS

Les commandes de paramétrage correspondent aux options de consultation et de mise à jour des fonctions interactives. Elles peuvent être utilisées sous la ligne de commande du système d'exploitation ou dans une procédure.

Le tableau ci-dessous décrit, par thème, la liste des commandes de paramétrage disponibles.

Commande : ux… Thème :	add	upd	dup	dlt	shw	lst	tra	dst	ext	ins	rls	scv
Administration									X	X
Société	X	X		X	X	X		X
Nœud					X	X		X
Var. Nœud	X	X		X		X
Type UG	X	X		X	X	X
UG	X	X	X	X	X	X		X
TIH	X			X	X	X		X
Domaine	X	X		X	X	X		X
Application	X	X		X	X	X		X
Rep. Appli.	X	X		X	X	X		X
Rep. UG.	X	X		X	X	X		X
Var. UG	X	X		X		X
Utilisateur	X	X		X	X	X		X
Classe	X	X		X	X	X		X
Ressource	X	X		X	X	X		X	X	X
Règle	X	X		X	X	X			X	X
Uproc	X	X	X	X	X	X	X	X	X	X	X	X
Session	X		X	X	X	X	X	X	X	X
Calendrier	X	X		X	X	X	X	X	X	X
Tâche	X	X	X	X	X	X	X	X	X	X
Dossier d’exploitation	X	X		X	X	X

Elles sont décrites à la section Commandes de paramétrage.

Commandes d'exploitation

Valide sous Windows / UNIX / OpenVMS

Les commandes d'exploitation permettent d'intervenir sur l'exploitation en cours.Elles peuvent être utilisées sous la ligne de commande du système d'exploitation ou dans une procédure.

Le tableau ci-dessous décrit, par thème, les commandes d'exploitation disponibles.

Commande ux… Thème :	add	upd	dlt	shw	lst	pre	rsv	cnr	hld	rls	pur	rst	wak	str	end
Ressource						X	X	X	X	X
Tâche									X	X
Lancement	X	X	X	X	X				X	X		X
Plage de maintenance	X		X	X	X
Exception	X	X	X	X	X
Evénement	X	X	X	X	X
Contrôle					X						X	X			X
Note	X	X	X	X	X
Automate					X								X	X	X
Hist. Exec.				X	X
Planning prev.					X
Statistiques	X	X	X	X	X

Elles sont décrites à la section Commandes d'exploitation.

Commandes de gestion de batch

Valide sous Windows / UNIX / OpenVMS

Vous pouvez utiliser les commandes de gestion de batch pour déclencher l'exécution d'un batch et en surveiller la durée d'exécution. Elles peuvent être utilisées sous la ligne de commande du système d'exploitation ou dans une procédure.

Quatre commandes sont disponibles :

uxordre - Déclencher un job batch : déclenche une tâche provoquée ou planifiée.
uxsurjob - Surveiller et interrompre un job: (obsolète) surveille la durée d'exécution d'une Uproc et interrompt l'exécution au-delà d'un temps limite.
uxspvjob - Surveiller et exécuter un job: (obsolète) surveille la durée d'exécution d'une Uproc et exécute un script au delà d'un temps limite. Précis à la minute.
uxalrjob - Surveiller et exécuter un job avec paramètres : (obsolète) surveille la durée d'exécution d'une Uproc et exécute un script avec des paramètres au delà d'un temps limite. Précis à la seconde.

Commandes FTP

Valide sous Windows / UNIX / OpenVMS

Vous pouvez utiliser les commandes FTP pour transférer des fichiers via Dollar Universe. Ces commandes utilisent les mécanismes de Dollar Universe Manager for File Transfer, intégré à Dollar Universe v6. Elles peuvent être utilisées sous la ligne de commande du système d'exploitation ou dans une procédure.

Deux commandes sont disponibles :

Commandes DQM

Vous pouvez utiliser les commandes DQM pour manipuler et gérer les queues batch et pour contrôler les jobs qui s'y exécutent. Elles peuvent être utilisées sous la ligne de commande du système d'exploitation ou dans une procédure.

DQM propose des commandes de gestion des queues batch :

Et des commandes de gestion des jobs dans les queues batch :

uxsubjob - Soumettre un job (UNIX / Linux uniquement)
uxrlsjob - Libérer un job suspendu
uxhldjob - Suspendre un job
uxshwjob - Afficher l'état d'un job
uxstpjob - Arrêter un job
uxsetpri - Modifier les priorités d'un job

Sous OpenVMS, les jobs sont lancés dans une queue batch DQM et sont ensuite soumis à VMS Queue Manager lorsque leur statut passe à "Exécution en cours". Les commandes DQM n'impactent que les queues batch DQM et les commandes de VMS Queue Manager n'impactent que les queues batch VMS. Reportez-vous à la documentation OpenVMS pour plus d'informations sur la gestion des queues batch OpenVMS.

Note : Sous OpenVMS, l'utilisateur doit avoir le privilège OPER pour exécuter les commandes de VMS Queue Manager.

Important! Lors de modifications du script .profile de l'utilisateur root, exécuter les étapes suivantes (DQM travaille principalement en mémoire) :

Arrêter DQM.
Se déconnecter de la session root.
Se reconnecter avec l'utilisateur root.
Relancer DQM.

Commandes de gestion de date

Valide sous Windows / UNIX / OpenVMS

Vous pouvez utiliser les commandes de date pour formater ou effectuer des décalages sur des dates / heures. Elles peuvent être utilisées sous la ligne de commande du système d'exploitation ou dans une procédure.

Deux commandes sont disponibles :

uxdat - Format et décalage de dates: modifier le format d'une date, de réaliser un décalage et d'obtenir le type ou le rang d'un jour dans le calendrier.
uxtim - Format de date et décalage d'heure: convertir une date (connue ou non) dans un format donné et/ou d'y ajouter un décalage horaire.

Elles sont décrites à la section "Commandes de gestion de date".

Commandes du CL des Uprocs

Vous pouvez utiliser les commandes du CL pour faire interagir le job exécuté avec l'automate : transmettre des informations à l'automate ou récupérer des informations venant de l'automate. Ces commandes ne peuvent être utilisées que dans un CL associé à une Uproc. Elles ne peuvent s'exécuter que dans le contexte fourni par l'automate.

Vous pouvez utiliser les commandes uxset pour agir sur l'automate depuis le script de l'Uproc :

uxset msg - Ecrire un message: envoyer des messages dans la trace automate de l'exécution à des fins de diagnostic (UXSETMSG sous OS/400).
uxset step - Ecrire des jalons : poser des jalons pour suivre l'exécution d'un script (UXSETSTEP sous OS/400).
uxset parm - Passer des paramètres: passer des paramètres, au sein d'une session, d'une Uproc à sa suivante (UXSETPARM sous OS/400).
uxset var - Reconduire des variables: reconduire la valeur des variables d’une Uproc au sein d’une session (UXSETVAR sous OS/400).
uxset info - Afficher des informations: afficher des informations supplémentaires dans le suivi des exécutions (UXSETINFO sous OS/400).
uxsetabort - Interdire l'arrêt de l'exécution d'une Uproc: interdire l'interruption d'un job par une interface d'exploitation de Dollar Universe.

Vous pouvez utiliser les commandes des “Gérer les variables d'héritage” pour gérer la transmission des variables dans une session :

uxset hvar : assigner des valeurs aux variables et spécifie quelles variables seront transmises à l'Uproc suivante.
uxunset hvar : arrêter la transmission à l'Uproc suivante des variables spécifiées.
uxset inheritance : définir si les variables seront transmises à l'Uproc suivante.

Vous pouvez utiliser les commandes des variables cachées pour gérer des variables dont la valeur est cachée à l'utilisateur (interface, logs…). Elles peuvent être utilisées sous la ligne de commande du système d'exploitation ou dans une procédure. Les commandes suivantes sont décrites à la section "Gérer les variables cachées":

uxhideval … insert…: créer une variable avec sa valeur dans le fichier des variables.
uxhideval … list…: lister les variables du fichier ainsi que leurs valeurs.
uxhideval … delete…: supprimer une variable et sa valeur du fichier.
uxhideval … extract…: afficher en clair la valeur de la variable dans la sortie standard.
uxexechidden: (alias EXECHIDDEN sous OS/400) exécuter une commande passée en paramètre en utilisant la valeur cachée d'une ou de plusieurs variables.