临时修订用户指定的软件包组件

在线编辑

所列示的临时修订控制文件组件是整个临时修订包的一部分，并且与特定文件无关。

摘要

描述临时修订包。此摘要限制为 38 字节。

描述

包含正在安装的临时修订包的详细描述。

APARREF

指定包含与此临时修订关联的一个或多个 APAR 编号的文件的位置。此组件是必需的。该文件的每一行必须分别包含一个 APAR 号。

E2E_PREREQ

列出作为正在安装的临时修订软件包的先决条件的临时修订的临时修订标签名称。使用此文件会导致 emgr 检查是否安装了临时修订 PREREQ 标签。如果未安装先决条件，那么 emgr 会异常中止临时修订软件包的安装。您还可以使用此文件来指定 XREQ 临时修订标签。如果指定的临时修订已安装，那么指定 XREQ 临时修订标签会导致 emgr 不安装临时修订软件包。受支持的临时修订标签的最大数目为 32。您可以通过以下方式来指定要检查的临时修订标签。

使用 -g 标志指定文件位置。例如，要指定临时修订 prereq.epkg，请输入以下命令:
```
# epkg -g /tmp/efixprereq.epkg myefix
```
为扩展的选项使用交互方式下的 -v 标志，然后当出现 epkg 的提示时输入以下文件位置。例如，要指定 interim_fixprereq.epkg，当出现提示时，输入以下命令：
```
Enter the location for the supersede file or "." to skip.
   -> /tmp/interim_fixprereq.epkg
```
将临时修订控制文件中的 E2E_PREREQ 属性设置为临时修订先决条件文件的本地文件位置。例如，要指定 interim_fixprereq.epkg，请按如下所示设置该属性：
```
E2E_PREREQ=/tmp/interim_fixprereq.epkg
```

临时修订先决条件文件条目的格式如下 (其中 RequisiteType 是 PREREQ 或 XREQ):

EfixLabel RequisiteType

注释以“#”符号开头，并且忽略前导空格。例如：

oldefix1 PREREQ  # Make sure oldefix1 is already installed
oldefix4 XREQ    # Make sure oldefix4 is NOT installed

注: 此功能在临时修订管理的原始发行版中不受支持。您应该更新到最新级别的临时修订管理以启用此功能。要更新临时修订管理，请将 bos.rte.install 更新到最新级别。

PKGLOCKS

除了那些基于文件所有权自动锁定的软件包外，还列出应由 emgr 锁定的软件包。应该指定软件包的名称、软件包锁操作（ALWAYS 或 IFINST）以及软件包文件类型。 ALWAYS 表示始终尝试锁定此软件包，如果未能锁定此软件包，那么将导致临时修订安装失败。 IFINST 表示仅当安装了此软件包时才尝试锁定此软件包，如果未能锁定 已安装的 软件包，那么将导致临时修订安装失败。受支持的临时修订标签的最大数目为 32。可以指定软件包按照以下方式锁定。

使用 -l 标志指定文件位置。例如，要指定 pkglock.epkg，请输入以下命令：
```
# epkg -l /tmp/pkglock.epkg myefix
```
为扩展的选项使用交互方式下的 -v 标志，然后当出现 epkg 的提示时输入以下文件位置。例如，要指定 pkglock.epkg，当出现提示时，输入以下命令：
```
Enter the location for the supersede file or "." to skip.
   -> /tmp/pkglock.epkg
```
将临时修订控制文件中的 PKGLOCKS 属性设置为要锁定的软件包的本地文件位置。例如，要指定 pkglock.epkg，请按如下所示设置属性：
```
PKGLOCKS=/tmp/pkglock.epkg
```

临时修订软件包锁定文件条目的格式如下所示:

PackageName PackageAction PackageType

注释以“#”符号开头，并且忽略前导空格。在以下示例中，在安装期间 emgr 将总是试图锁定 bos.rte.lvm 并在除去时解锁。 emgr 将锁定 bos.games (如果 (并且仅当) 已安装) ，并在卸下时将其解锁 (如果已锁定)。

bos.rte.lvm ALWAYS installp
bos.games   IFINST installp

注: 此功能在临时修订管理的原始发行版中不受支持。您应该更新到最新级别的临时修订管理以启用此功能。要更新临时修订管理，请将 bos.rte.install 更新到最新级别。

PRE_INSTALL

在安装预览之后且在安装任何临时修订文件之前运行。 pre_install 脚本中的故障导致临时修订软件包安装异常中止。该脚本对执行任何预装检查或工作很有用。因为 emgr 命令不会对预装失败调用故障清除过程，所以该脚本会在退出之前执行（脚本相关的）故障清除。此组件是可选的。

POST_INSTALL

在成功安装所有临时修订文件后运行。 post_install 脚本中的故障导致安装失败，并导致临时修订管理器运行故障清除过程。此组件是可选的。有关 post_install 脚本的更多信息，请参阅安装和管理临时修订包。

PRE_REMOVE

在移除预览之后以及在移除操作期间以及在故障清除过程的第一阶段中移除任何临时修订文件之前运行。 pre_remove 脚本中的失败会导致给定操作失败。对于故障清除过程， emgr 命令将 EMGR_UNDO 全局环境变量设置为 1。如果需要， EMGR_UNDO 变量用于执行不同的除去操作，而不是执行故障清除。此组件是可选的。

POST_REMOVE

在移除操作和故障清除过程中移除临时修订个文件之后运行。后除去脚本中的失败会导致给定操作失败。对于故障清除过程， emgr 命令将 EMGR_UNDO 全局环境变量设置为 1。 EMGR_UNDO 变量用于执行不同的除去操作，而不是执行故障清除 (如果需要)。此组件是可选的。

重新引导

指示此临时修订是否需要执行重新引导操作。可以使用该变量指定以下重新引导方案之一：

重新引导不是必需的。
重新引导是必需的，该引导映像将会重建。
重新引导是必需的，该引导映像将不会重新引导。

可以指定在以下方式中想要那些重新引导方案。

用 -r 标志指定重新引导方案。该标志的自变量是 n（重新引导不是必需的）、y（重新引导是必需的，并且引导映像将要重建）以及 o（重新引导是必需的，但引导映像不会重建）。例如，以下命令指定重新引导是不需要的：
```
# epkg -r n
```

为扩展的选项使用交互方式下的 -v 标志，然后当出现 epkg 提示时选择需要的重新引导方案。例如：

Select reboot policy for this efix package:
   1) Reboot is NOT required.
   2) Reboot is required. The boot image will be rebuilt.
   3) Reboot is required. The boot image will NOT be rebuilt.

将临时修订控制文件中的 REBOOT 和 BUILD_BOOT_IMAGE 属性设置为所需的重新引导方案的相应值。例如，要指定重新引导是不必需的，请按如下所示设置属性：
```
REBOOT=no
BUILD_BOOT_IMAGE=no
```
要指定重新引导是必需的并且引导映像将重建，请按如下所示设置属性：
```
REBOOT=yes
BUILD_BOOT_IMAGE=yes
```
要指定重新引导是必需的并且引导映像将不重建，请按如下所示设置属性：
```
REBOOT=yes
BUILD_BOOT_IMAGE=no
```
注意：
1. 此功能在临时修订管理的原始发行版中不受支持。您应该更新到最新级别的临时修订管理以启用此功能。要更新临时修订管理，请将 bos.rte.install 更新到最新级别。

PREREQ

包含 installp 先决条件。此组件是可选的。

该文件每行有一个先决条件。
先决条件条目的格式如下所示：
```
Fileset Min Level Max Level Type
```
文件集

必需 installp 文件集的名称。

Min Level

必需文件集的最小级别。指定 NONE 表示没有最小级别。

Max Level

必需文件集的最大级别。 NONE 表示没有最大级别。

类型

支持以下类型：PREREQ 和 IFREQ。 PREREQ 是缺省类型并且要求必需文件集符合所有标准。仅当已安装 IFREQ 时才会要求必需文件集符合所有标准。

忽略空白行或以 # 开始的行，如以下示例中所示：

# Require that abc.xyz is installed at any level:
  abc.xyz NONE NONE      
# Require that bos.rte.lvm is installed at level 5.1.0.10 or above:
  bos.rte.lvm 5.1.0.10 NONE
# Require bos.mp be between 5.1.0.0 and 5.1.0.40 if it is installed:
  bos.mp 5.1.0.0 5.1.0.40 IFREQ

SUPERSEDE

指定安装 epkg 时要取代的临时修订或临时修订的临时修订标签名称。使用此文件将导致 emgr 在安装临时修订软件包之前除去此文件中指定的任何临时修订标签 (如果已安装)。未能除去已安装的被取代临时修订将中止临时修订软件包的安装。支持的最大被取代标签数是 32。可以按照以下方式指定取代的文件。

使用 -S 标志指定文件位置。例如，要指定 susperseded.epkg，请输入以下命令：
```
# epkg -S /tmp/superseded.epkg myefix
```
为扩展的选项使用交互方式下的 -v 标志，然后当出现 epkg 的提示时输入以下文件位置。例如，要指定 susperseded.epkg，当出现提示时，请输入以下命令：
```
Enter the location for the supersede file or "." to skip.
   -> /tmp/superseded.epkg
```
将临时修订控制文件中的 SUPERSEDE 属性设置为被取代文件的本地文件位置。例如，要指定 susperseded.epkg，请按如下所示设置属性：
```
SUPERSEDE=/tmp/superseded.epkg
```

被取代文件列表的格式为每行一个要被取代的临时修订标签。注释以“#”符号开头，并且忽略前导空格。例如：

# Requisites for efix myefix3
myefix1
myefix2

临时修订 用户指定的软件包组件

临时修订用户指定的软件包组件