-env

Contrôle la propagation des variables d'environnement de soumission de travail spécifiées vers les hôtes d'exécution.

Catégories

Propriétés

Syntaxe

bsub -env "none" | "all, [~nom_var[, ~nom_var] ... ] [nom_var=valeur_var[, nom_var=valeur_var] ... ]" | "nom_var[=valeur_var] [, nom_var[=valeur_var] ... ]"

Descriptif

Spécifiez une liste séparée par des virgules de variables d'environnement de soumission de travail pour contrôler la propagation vers les hôtes d'exécution.

  • Spécifiez none sans autre variable pour soumettre des travaux sans variable d'environnement de soumission. Toutes les variables d'environnement sont supprimées lors de la soumission du travail.
  • Indiquez le nom de la variable sans valeur pour propager la variable d'environnement avec sa valeur par défaut.
  • Spécifiez le nom de la variable avec une valeur pour propager la variable d'environnement avec la valeur spécifiée afin de remplacer la valeur par défaut. La valeur spécifiée peut être une nouvelle valeur ou indiquer la valeur d'une variable d'environnement existante (sauf si vous soumettez des lots de travaux). Par exemple :

    Sous UNIX, fullpath=/tmp/:$filename ajoute /tmp/ au début de la variable d'environnement filename et affecte cette nouvelle valeur à la variable d'environnement fullpath . Utilisez le signe deux-points (:) pour séparer plusieurs variables d'environnement.

    Sous Windows, fullpath=\Temp\:%filename% ajoute \Temp\ au début de la variable d'environnement filename et affecte cette nouvelle valeur à la variable d'environnement fullpath . Utilisez un point-virgule (;) pour séparer plusieurs variables d'environnement.

    Le shell sous lequel vous avez soumis le travail analyse les guillemets.

  • Indiquez all au début de la liste pour propager toutes les variables d'environnement de soumission existantes aux hôtes d'exécution. Vous pouvez également affecter des valeurs à des variables d'environnement spécifiques.

    Par exemple, -env "all, var1=value1, var2=value2" soumet des travaux avec toutes les variables d'environnement, mais avec les valeurs spécifiées pour les variables d'environnement var1 et var2 .

  • Lorsque vous utilisez le mot clé all , ajoutez ~ au début du nom de la variable et la variable d'environnement n'est pas propagée aux hôtes d'exécution.

Les noms de variable d'environnement ne peuvent pas contenir les mots et symboles suivants: "none", "all", virgule (,), tilde (~), signe égal (=), guillemets (") et apostrophe (').

La valeur de la variable peut contenir un tilde (~) et une virgule (,). Toutefois, si la valeur contient une virgule (,), la valeur entière doit être placée entre apostrophes. Par exemple :

bsub -env "TEST='A, B' "

Un esub peut modifier les variables d'environnement -env en les écrivant dans le fichier spécifié par les variables d'environnement LSB_SUB_MODIFY_FILE ou LSF_SUB4_SUB_ENV_VARS . Si les deux variables d'environnement sont spécifiées, LSF_SUB_MODIFY_FILE prend effet.

Lorsque -env n'est pas spécifié avec bsub, la valeur par défaut est -env "all" (c'est-à-dire que toutes les variables d'environnement sont soumises avec les valeurs par défaut).

L'argument complet de l'option -env peut contenir jusqu'à 4094 caractères pour UNIX et Linux, ou jusqu'à 255 caractères pour Windows.

Si -env est en conflit avec -L, la valeur de -L prend effet.

Les variables d'environnement suivantes ne sont pas propagées aux hôtes d'exécution car elles ne sont utilisées que dans l'hôte de soumission:

  • HOME, LS_JOBPID, LSB_ACCT_MAP, LSB_EXIT_PRE_ABORT, LSB_EXIT_REQUEUE, LSB_EVENT_ATTRIB, LSB_HOSTS, LSB_INTERACTIVE, LSB_INTERACTIVE_SSH, LSB_INTERACTIVE_TTY, LSB_JOBFILENAME, LSB_JOBGROUP, LSB_JOBID, LSB_JOBNAME, LSB_JOB_STARTER, LSB_QUEUE, LSB_RESTART, LSB_RESTART, LSB_TRAP_SIGS, LSB_hostname
  • Variables d'environnement relatives aux travaux non interactifs: TERM, TERMCAP
  • Variables d'environnement spécifiques à Windows: COMPUTERNAME, COMSPEC, NTRESKIT, OS2LIBPATH, PROCESSOR_ARCHITECTURE, PROCESSOR_IDENTIFIER, PROCESSOR_LEVEL, PROCESSOR_REVISION, SYSTEMDRIVE, SYSTEMROOT, TEMP, TMP

Les variables d'environnement suivantes ne prennent pas effet sur les hôtes d'exécution: LSB_DEFAULTPROJECT, LSB_DEFAULT_JOBGROUP, LSB_TSJOB_ENVNAME, LSB_TSJOB_PASSWD, LSF_DISPLAY_ALL_TSC, LSF_JOB_SECURITY_LABEL, LSB_DEFAULT_USERGROUP, LSB_DEFAULT_RESREQ, LSB_DEFAULTQUEUE, BSUB_CHK_RESREQ, LSB_UNIXGROUP, LSB_JOB_CWD