-env

类别

属性

描述

指定以逗号分隔的作业提交环境变量列表，以控制传播到执行主机。

• 指定没有其他变量的 none 以提交没有提交环境变量的作业。 提交作业时，将除去所有环境变量。
• 指定不带值的变量名称，以使用其缺省值传播环境变量。
• 使用值指定变量名称以传播具有指定值的环境变量，从而覆盖缺省值。 指定的值可以是新值，也可以引用现有环境变量的值 (除非您正在提交作业包)。 例如：

  在 UNIX 中， fullpath=/tmp/:$filename 将 /tmp/ 附加到 filename 环境变量的开头，并将此新值分配给 fullpath 环境变量。 使用冒号 (:) 来分隔多个环境变量。

  在 Windows 中， fullpath=\Temp\:%filename% 将 \Temp\ 附加到 filename 环境变量的开头，并将此新值分配给 fullpath 环境变量。 使用分号 (;) 来分隔多个环境变量。

  提交作业的 shell 将解析引号。

• 在列表开头指定 all 以将所有现有提交环境变量传播到执行主机。 您还可以将值分配给特定环境变量。

  例如， -env "all, var1=value1, var2=value2" 使用所有环境变量提交作业，但使用 var1 和 var2 环境变量的指定值提交作业。

• 使用 all 关键字时，请将 ~ 添加到变量名称的开头，并且不会将环境变量传播到执行主机。

环境变量名称不能包含以下单词和符号: "none" ， "all" ，逗号 (,) ，波浪号 (~) ，等号 (=) ，双引号 (") 和单引号 (')。

变量值可以包含波浪号 (~) 和逗号 (,)。 但是，如果值包含逗号 (,) ，那么必须将整个值括在单引号中。 例如：

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

esub 可以通过将 -env 环境变量写入由 LSB_SUB_MODIFY_FILE 或 LSF_SUB4_SUB_ENV_VARS 环境变量指定的文件来更改这些环境变量。 如果同时指定了两个环境变量，那么 LSF_SUB_MODIFY_FILE 将生效。

如果未将 -env 与 bsub一起指定，那么缺省值为 -env "all" (即，使用缺省值提交所有环境变量)。

对于 UNIX 和 Linux， -env 选项的整个自变量最多可以包含 4094 个字符，对于 Windows ，最多可以包含 255 个字符。

如果 -env 与 -L冲突，那么 -L 的值生效。

以下环境变量不会传播到执行主机，因为它们仅在提交主机中使用:

• HOME ， LS_JOBPID ， LSB_ACCT_MAP ， LSB_EXIT_PRE_ABORT ， LSB_EXIT_REUE ， 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_TRAPSIGS ， LSB_X_JOB_SSH
• 有关非交互式作业的环境变量: TERM ， TERMCAP
• 特定于 Windows 的环境变量 :COMPUTERNAME ， COMSPEC ， NTRESKIT ， OS2LIBPATH， PROCESSOR_ARCHITECTURE ， PROCESSOR_IDENTIFIER ， PROCESSOR_LEVEL ，PROCESSOR_修订版， SYSTEMDRIVE ， SYSTEMROOT ， TEMP 和 TMP

以下环境变量不会对执行主机生效 :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