Rubrique précédente: ExempleRubrique suivante: Exemple


regproc—Enregistrement de procédures

La commande regproc permet d'enregistrer une procédure d'élément imbriquée ou supplémentaire avec un programme logiciel existant. La procédure d'élément doit se trouver dans un répertoire accessible par le gestionnaire de domaines.

La syntaxe de la commande est la suivante :

cadsmcmd regproc 	item=nom_élément
version=nom_version
task={install | activate | configure | uninstall} 
procedure=nom_procédure
os=se
type={executable | command | SWD | MSI | SXP | PKG | PIF | IPS | PALM | WINCE| RPM | NOKIA}
[enduser] 
[notRAC]]
[externalproc]
file=nom_fichier 
path=nom_chemin
[paramètres=paramètres_procédure] 
[defaultProc][query=nom_requête][sep=signe_séparation]
[comment=commentaire]
[usedefaultMsg]
Commentaire

Spécifie un commentaire pour la procédure.

defaultProc

S'il est codé, l'enregistrement de la procédure devient la valeur par défaut pour toutes les procédures du même type.

utilisateur final

Spécifie si le la procédure peut être planifiée pour être exécutée par un utilisateur final via l'interface utilisateur graphique Catalogue.

externalproc

(Facultatif) Indique que la procédure fournie dans le paramètre de procédure est externe. (la procédure doit être fournie par les systèmes cibles concernés).

fichier

Spécifie le nom du fichier de procédure.

élément

Spécifie le nom de l'élément auquel cette procédure est associée en tant que procédure d'élément ajoutée.

notRAC

(Facultatif) Indiquant que la procédure ne doit pas être prise en compte au moment d'une réinstallation après un arrêt brutal (RAC - Reinstall After Crash).

os

Spécifie le type de système d'exploitation pris en charge par la procédure.

Valeurs :
os={AIX|AIX_3.2_RS/6000|AIX_4.1_RS/6000
...|AIX_4.2_RS/6000|AIX_4.3_RS/6000
...|AIX_5.0_RS/6000|AIX_5.1_RS/6000
...|AIX_5.2_RS/6000|AIX_5.3_RS/6000
...|AIX_5.4_RS/6000|AIX_5.5_RS/6000
...|AIX_5.6_RS/6000|AIX_5.7_RS/6000
...|AIX_5.8_RS/6000|ANY|COMPAQ_TRU64_(DEC)
...|COMPAQ_TRU64_5.X_ALPHA
...|DEC_3.0_ALPHA|DEC_3.2_ALPHA
...|DEC_4.0_ALPHA|DGUX|DGUX_4.1_INTEL
...|DGUX_4.1_MC88|DGUX_4.2_INTEL
...|DOS|DRS/NX_7MP_SPARC|DRS/NX_7_SPARC
...|DRS/NX_SPARC|DYNIX|DYNIX_4.2.X_INTEL
...|DYNIX_4.4.X_INTEL|HPUX
...|HPUX_10|HPUX_10_700|HPUX_10_800
...|HPUX_11|HPUX_11I_V2|HPUX_11_700
...|HPUX_11_800|HPUX_11_IA64
...|HPUX_12|HPUX_12I_V2|HPUX_12_700
...|HPUX_12_800|HPUX_12_IA64
...|HPUX_9|HPUX_9_700|HPUX_9_800
...|IRIX|IRIX_6.2|IRIX_6.3
...|IRIX_6.4|IRIX_6.5|LINUX
...|LINUX_2.1_INTEL|LINUX_2.2_INTEL
...|LINUX_2.2_S/390|LINUX_2.3_INTEL
...|LINUX_2.3_S/390|LINUX_2.4_INTEL
...|LINUX_2.4_S/390|LINUX_2.5_INTEL
...|LINUX_2.5_S/390|LINUX_2.6_INTEL
...|LINUX_2.6_INTEL_64-BIT
...|LINUX_2.6_S/390|MACINTOSH
...|MACINTOSH_10.0_PPC|MACINTOSH_10.1_PPC
...|MACINTOSH_10.2_PPC|MACINTOSH_10.3_PPC
...|MACINTOSH_10.4_PPC|NCR_SST
...|NCR_SST_S4I_INTEL|NCR_SST_S4_INTEL
...|NCR_SV|NCR_SV_2X_INTEL
...|NCR_SV_3X_INTEL|NETWARE
...|NETWARE_3_INTEL|NETWARE_4_INTEL
...|NETWARE_5_INTEL|NETWARE_6_INTEL
...|NOKIA_ADMINSUITE|NOKIA_ADMINSUITE_1.0
...|OPENVMS|OPENVMS_5.5_VAX
...|OPENVMS_6.0_ALPHA|OPENVMS_6.0_VAX
...|OPENVMS_6.1_ALPHA|OPENVMS_6.1_VAX
...|OPENVMS_6.2_ALPHA|OPENVMS_6.2_VAX
...|OPENVMS_7.0_ALPHA|OPENVMS_7.0_VAX
...|OPENVMS_7.1_ALPHA|OPENVMS_7.1_VAX
...|OPENVMS_7.2_ALPHA|OPENVMS_7.2_VAX
...|OS/2_16-BIT|OS/2_32-BIT
...|PALM_OS|SCO|SCO_3.2_V5_INTEL
...|SCO_5.2_V5_INTEL|SINIX
...|SINIX_5.42_R4000|SINIX_5.43_R4000
...|SINIX_5.44_R4000|SINIX_5.45_R4000
...|SOLARIS|SOLARIS_10_INTEL
...|SOLARIS_10_SPARC|SOLARIS_2.3_SPARC
...|SOLARIS_2.4_INTEL|SOLARIS_2.4_SPARC
...|SOLARIS_2.5_INTEL|SOLARIS_2.5_SPARC
...|SOLARIS_2.6_INTEL|SOLARIS_2.6_SPARC
...|SOLARIS_7_INTEL|SOLARIS_7_SPARC
...|SOLARIS_8_INTEL|SOLARIS_8_SPARC
...|SOLARIS_9_INTEL|SOLARIS_9_SPARC
...|SUNOS|SUNOS_4.1.4_SPARC
...|UNIX|UNIXWARE|UNIXWARE2.0_INTEL
...|UNIXWARE2.1_INTEL|UNIXWARE7.X_INTEL
...|WINDOWS_16-BIT|WINDOWS_32-BIT
...|WINDOWS_95|WINDOWS_98
...|WINDOWS_ME|WIN_2000|WIN_2000_INTEL
...|WIN_CE|WIN_CE_2.00_MIPS
...|WIN_CE_2.00_SH3|WIN_CE_2.01_MIPS
...|WIN_CE_2.01_SH3|WIN_CE_2.11_ARM
...|WIN_CE_2.11_MIPS|WIN_CE_2.11_SH3
...|WIN_CE_2.11_SH4|WIN_CE_3.00_ARM
...|WIN_CE_3.00_MIPS|WIN_CE_3.00_PPC2002_ARM
...|WIN_CE_3.00_SH3|WIN_CE_3.00_SH4
...|WIN_CE_4.20_MOBILE2003_ARM
...|WIN_LONGHORN_SERVER_INTEL
...|WIN_LONGHORN_SERVER_ITANIUM
...|WIN_LONGHORN_SERVER_X64
...|WIN_NT|WIN_NT_ALPHA|WIN_NT_INTEL
...|WIN_NT_MIPS|WIN_SERVER_2003
...|WIN_SERVER_2003_INTEL
...|WIN_SERVER_2003_ITANIUM
...|WIN_SERVER_2003_X64|WIN_VISTA_INTEL
...|WIN_VISTA_ITANIUM|WIN_VISTA_X64
...|WIN_XP|WIN_XP_INTEL|WIN_XP_ITANIUM
...|WIN_XP_X64}

Remarque : Lorsque vous émettez la commande regproc en mode verbose, la liste des valeurs valides pour votre version actuelle apparaît.

paramètres

Paramètres à transmettre à la procédure lorsqu'elle est exécutée..

chemin

Indique l'un de ces trois cas, en fonction de l'utilisation :

procédure interne

La procédure fait partie intégrante du package du produit. Par conséquent, le chemin attendu est le chemin relatif de la racine du produit au fichier de procédure.

Par exemple, si le produit a été chargé depuis c:\swtest1 (racine du produit) et que les procédures se trouvent dans c:\swtest1\procs, utilisez le code path=PROCS pour localiser la procédure.
Si la procédure se trouve également dans c:\swtest1, utilisez le code path=\ sous Windows et path=./ sous Linux.
(Voir aussi : Barre oblique inverse (Windows) et barre oblique (Linux))

procédure ajoutée

La procédure ne fait pas partie intégrante du package mais est disponible à un autre emplacement sur le gestionnaire. Par conséquent, le chemin doit être le chemin absolu du fichier de procédure sur le gestionnaire.

Par exemple, si le produit a été chargé depuis c:\swtest1 et que la procédure à affecter se trouve dans d:\procpool sur le gestionnaire où la commande est lancée, utilisez le code path=d:\procpool.

procédure externe

La procédure ne fait pas partie intégrante du package et n'est pas disponible sur le gestionnaire où la commande est lancée, mais elle doit être disponible au niveau de tous ces ordinateurs cibles où elle doit ultérieurement être exécutée.

Par conséquent, la procédure doit se trouver au même emplacement que tous les ordinateurs désignés en tant que cibles.

Par exemple, rendez la procédure disponible dans c:\usd_supp\procs au niveau des ordinateurs cibles en question. Utilisez ensuite le code path=c:\usd_supp\procs.

Remarque : Ce paramètre n'est pas obligatoire si l'argument externalProc est codé. Dans ce cas, les informations transmises avec l'argument de fichier serviront à déterminer la procédure à appeler au niveau des systèmes cibles.
Si l'argument externalProc n'est pas codé, ce paramètre demeure obligatoire.

procédure

Spécifie le nom d'une procédure. Son enregistrement sera exécuté.

Requête

Indique le nom d'une requête existante qui décrit les conditions préalables pour l'exécution de cette procédure. Si elles ne sont pas codées, aucune condition préalable n'est définie.

La syntaxe du nom de la requête se présente de la façon suivante :

{nom_requête | (nom_requête signe_séparation nom_domaine)}

Nom_domaine spécifie le nom du domaine dans lequel cette requête a été créée. Le signe_séparation sépare le nom_requête du nom_domaine. Le signe_séparation est défini en même temps que le paramètre sep. Si seul le nom_requête est spécifié, l'appartenance d'une requête à un domaine ne peut être vérifiée.

sep

Spécifie le signe de séparation utilisé avec cette action. Le signe de séparation par défaut est le point ".".

tâche

Spécifie le type de tâche que la procédure d'élément doit effectuer..

Installer

Enregistre un procédure d'installation

Activer

Enregistre un procédure d'activation

Configurer

Enregistre un procédure de configuration

Désinstallation

Enregistre un procédure de désinstallation

type

Spécifie le type de procédure.

Les valeurs valides sont :

exécutable

fichier exécutable (.exe ou .com)

commande

fichier de commande (.cmd ou .bat)

swd

Script du détecteur de logiciels

msi

Fichier de package Microsoft Windows Installer

sxp

Format de compilation SD pour Windows.

pkg

Format de compilation SD pour UNIX.

pif

Product Interchange File : Format de compilation SD pour UNIX.

rpm

Format de compilation Linux RedHat Package Manager

ips

Fichier de script <adms> doté de l'extension .ips

palm

Fichier d'application PALM doté de l'extension .prc

wince

Fichier cab Windows CE doté de l'extension .cab

nokia

Fichier NOKIA 9210 Communicator

usedefaultMsg

(Facultatif) Si l'argument usedefaultMsg est codé, le commentaire associé à la procédure d'élément est utilisé comme le message de job d'utilisateur.

version

Spécifie le version de l'élément.