sd_acmd : commandes administratives de l'agent › Format COF (fichier de commande de conteneur)

Format COF (fichier de commande de conteneur)

Le fichier de commande de conteneur COF (.cof) comporte les sections suivantes :

Langue
	codepage=
Conteneur
	Name=
	Password=
	Type=
	Transaction=
	OrderedBy=
	CreationTime=
	ManagerAddress=
	ResultDirectory=
	NumberOfJobs=
	NumberOfLibraries=
	BackgroundProcess=
	ShowProgress=
	Status=
	StatusMessage=
	CompletionTime=
	Secure=
	Validate=
	Hash=
	Nom_Utilisateur=
	DomainName=
	Job_1
	Library_1

Langue

codepage=

Ce paramètre est facultatif.
Si le paramètre codepage n'est pas spécifié, SecureContainer est défini sur 3.
Les valeurs admises sont les suivantes :
1=ANSI
2=OEM
3=UTF8 ou
toute autre page de code prise en charge par le système actuel, par exemple 850.

Conteneur

Name=

Nom du conteneur, pour les journaux et la sortie.
Par défaut, le nom correspond au nom du fichier COF.

Password=

Le mot de passe sert à protéger le fichier COF.
Ce paramètre est facultatif. Si elle est donnée, la valeur sera chiffrée lors de l'exécution de la commande SecureContainer.
Le paramètre peut également être fourni à l'aide de la commande SecureContainer avec l'argument facultatif -p:. Dans ce cas, la valeur de la commande remplace celle définie ici.

Type=

Ce paramètre indique le type du conteneur.
Les valeurs valides sont :
0 Aucune liaison
1 Réservé
2 Lot

Valeur par défaut : 0

Transaction=

Ce paramètre indique si la transaction est utilisée pour les jobs du conteneur. Il n'est applicable qu'aux conteneurs de traitement par lot Software Management (SM).
Les valeurs valides sont :
0 False (non-utilisation)
1 True (utilisation)

Valeur par défaut : 0

OrderedBy=

Ce paramètre est facultatif. Il définit un nom de compte, par exemple DomaineX\UtilisateurY.
Par défaut : utilisateur exécutant actuellement la commande SecureContainer.

CreationTime=

(Facultatif) Indique la date et l'heure de création du conteneur, au format AAAA-MM-JJ-hh:mm, où AAAA représente l'année, MM le mois, JJ le jour, hh les heures et mm les minutes.

ManagerAddress=

(Facultatif) Indique l'adresse du gestionnaire de domaines. Si aucune valeur n'est donnée, la valeur par défaut est prise de “currentmanageraddress” dans la configuration commune.
Ce paramètre remplace la macro $csa.

ResultDirectory=

Ce paramètre est facultatif et fournit le chemin complet du répertoire de sortie.
Il peut être écrasé par la valeur du paramètre du répertoire de sortie lors de l'exécution d'ExecuteContainer à partir de la ligne de commande.

NumberOfJobs=

Ce paramètre est obligatoire. Il définit le nombre de sections Job qui suivent dans le fichier COF.
La valeur par défaut est 1.
Remarque : Si la valeur est 1, alors il ne doit y avoir qu'une seule section Job : Job_1. Si la valeur est 2, il doit y avoir deux sections : Job_1 et Job_2, et ainsi de suite.

NumberOfLibraries=

Ce paramètre est obligatoire. Il indique le nombre de sections Library qui suivent dans le fichier COF.
La valeur par défaut est 1.
Remarque : Si la valeur est 1, alors il ne doit y avoir qu'une seule section Library : Library_1. Si la valeur est 2, il doit y avoir deux sections : Library_1 et Library_2, et ainsi de suite.

BackgroundProcess=

Ce paramètre indique si les jobs doivent être traités en arrière-plan.
Les valeurs valides sont :
-1 Utiliser la valeur dans la procédure associée
0 Non
1 Oui
La valeur par défaut est -1.
Remarque : La valeur dans la procédure associée est en arrière-plan si la macro $#bg est utilisée. Si aucune macro n'est fournie, la valeur n'est pas en arrière-plan.

ShowProgress=

Ce paramètre indique si la boîte de dialogue de progression doit apparaître.
Les valeurs valides sont :
0 Non
1 Oui
La valeur par défaut est 1.

Status=

Ce paramètre indique le statut d'exécution du conteneur.
Les valeurs valides (FRA-) sont les suivantes :
0 OK
1 Au moins un job a échoué.
2 Non traité.
3 COF en cours.
4 Redémarrage lancé.
5 Déconnexion lancée.
6 Pas de fichier COF.
7 Erreur générale lors de la lecture du fichier COF : le fichier a peut-être été modifié.
8 Le mot de passe fourni n'est pas valide.
9 Le fichier COF n'est pas sécurisé.
OUT : signifie que la valeur du paramètre est écrite dans le fichier *.crf, dans le répertoire de résultats indiqué.

StatusMessage=

Ce paramètre fournit un texte de statut, tel qu'un message natif du système d'exploitation.
La valeur de ce paramètre correspond à celle du paramètre Status.
OUT : signifie que la valeur du paramètre est écrite dans le fichier *.crf, dans le répertoire de résultats indiqué.

CompletionTime=

Ce paramètre indique l'heure d'achèvement du traitement du conteneur de jobs.
Ce paramètre est au format AAAA-MM-JJ hh:mm (année-mois-jour heures:minutes), par exemple 2001-04-09 15:34:52.
OUT : signifie que la valeur du paramètre est écrite dans le fichier *.crf, dans le répertoire de résultats indiqué.

Secure=

L'exécution de la commande sd_acmd SecureContainer attribue la valeur 1 à ce paramètre.
OUT : signifie que la valeur du paramètre est écrite dans le fichier *.crf, dans le répertoire de résultats indiqué.

Validate=

Valeur chiffrée utilisée pour la validation du mot de passe du fichier COF. Cette valeur est créée par la commande sd_acmd ExecuteContainer, puis supprimée quand le traitement est fini.

Hash=

Uniquement valide en association avec -v. Impose la modification à la configuration en cas d'échec de la commande SDPing.

Nom_Utilisateur=

Ce paramètre est inséré lors de l'exécution de la commande ExecuteContainer. Il indique l'utilisateur actuellement connecté.

DomainName=

Ce paramètre est inséré lors de l'exécution de la commande ExecuteContainer. Il indique, le cas échéant, le domaine auquel l'utilisateur actuel est connecté.

Job_n

Pour plus d'informations, reportez-vous à la description de la section Job.

Library_n

Pour plus d'informations, reportez-vous à la description de la section Library.

Exemples de fichiers COF

Les fichiers COF des exemples ci-dessous sont les plus petits possible et utilisent tous les paramètres par défaut.

Fichier COF pour l'utilisation d'une bibliothèque réseau

[Container]
NumberOfJobs=1
NumberOfLibraries=1

[Library_1]
Type=1
Path=\\MON_SERVEUR\SDLIB

[Job_1]
SoftwareName=SuperOffice pour Win2000
SoftwareVersion=7.1 FRA (I386)
ProcedureName=InstallSO

Fichier COF pour l'utilisation d'une bibliothèque sur CD

[Container]
NumberOfJobs=1
NumberOfLibraries=1

[Library_1]
Type=2
Path=Lib
Label=001229_1045

[Job_1]
SoftwareName=SuperOffice pour Win2000
SoftwareVersion=7.1 FRA (I386)
ProcedureName=InstallSO

Remarque : Un fichier modèle, template.cof, figure dans le répertoire CONF (%SDROOT%\ASM\CONF pour un environnement Windows, $SDROOT/asm/conf pour UNIX).Remarque : Les fichiers COF peuvent comporter plusieurs sections Job et Library. Dans ce cas, les sections supplémentaires sont intitulées Job_2, Library_2, etc.

Important : Si vous utilisez un éditeur de texte pour créer le fichier COF, vous devez choisir le codage approprié pour l'enregistrer. Autrement dit, vous devez vérifier si la page de codes actuelle de votre ordinateur accepte tous les caractères que vous avez utilisés. Si ce n'est pas le cas, sélectionnez en un adéquat à l'aide du paramètre codepage=

Par exemple, si vous utilisez des trémas allemands, vous devez sélectionnez UTF-8 (si codepage 3 est utilisé).

Si le paramètre codepage n'est pas spécifié, SecureContainer est défini sur 3.