检索元素

您可以选择使用 Developer for z/OS®从 CA Endevor SCM 中检索单个 Endevor 元素或多个 Endevor 元素。 您可以将检索到的元素直接放入数据集中（可通过远程系统资源管理器视图访问）或 MVS 子项目中。 使用 Endevor RAM 定制操作菜单检索元素，或者抽取到数据集或 MVS 子项目调用 CA Endevor SCM RETRIEVE ELEMENT 操作。

• 使用 Endevor RAM 定制操作。
  大多数 CA Endevor SCM 操作通过 Endevor RAM 定制操作菜单提供。 执行以下步骤以通过使用定制操作菜单来抽取单个元素。
  1. 在 " CARMA 存储库 " 视图中，浏览容器以查找要检索的元素。
  2. 右键单击要检索的目标元素，然后单击 定制 > 检索元素。
     “检索元素”窗口将打开。
  3. 使用 " 检索元素 " 窗口来指定 CA Endevor RETRIEVE ELEMENT 操作所需的参数。

     Element name:CA Endevor 操作的目标元素的名称。

     Through element name:CA Endevor 操作的最后一个目标元素的名称

     Element version (1-99): 要为 CA Endevor 操作指定的 ELEMENT VERSION 参数。

     Element level (0-99): 要为 CA Endevor 操作指定的 ELEMENT LEVEL 参数。

     ENVIRONMENT NAME、SYSTEM NAME、SUBSYSTEM NAME、TYPE NAME 和 STAGE ID 参数是根据您选择的并且已指定的元素自动确定的。

     Environment name: 目标元素所在的 CA Endevor SCM 中的 ENVIRONMENT NAME 。 有效环境名值显示在菜单中。

     System name: 目标元素所在的 CA Endevor SCM 中的 SYSTEM NAME 。 有效系统名称值显示在菜单中。

     Subsystem name: 目标元素所在的 CA Endevor SCM 中的 SUBSYSTEM NAME 。 有效子系统名称值显示在菜单中。

     Type name: 目标元素所在的 CA Endevor SCM 中的 TYPE 。 有效类型值显示在菜单中。

     Stage id: 要为 CA Endevor 操作指定的 STAGE ID 参数

     Target data set name: 包含要作为 CA Endevor RETRIEVE ELEMENT 操作目标的成员的数据集。 使用浏览按钮以浏览主机系统来选择数据集。 Target PDS member name 是可选的。 如果填写了 Target PDS member name 字段，那么目标元素名称将用作 Target PDS member name。

     Target PDS member name: 要作为 CA Endevor RETRIEVE ELEMENT 操作的目标的远程成员的名称。

     Change control id: 要用作 CA Endevor 操作的参数的 CCID 。

     Comment: 要用作 CA Endevor 操作的参数的 comment 。

     Replace member: 选中复选框以启用 CA Endevor REPLACE MEMBER 参数

     Signout: 选中此复选框以启用 CA Endevor SIGNOUT 参数

     Expand includes: 选中复选框以启用 CA Endevor EXPAND INCLUDES 参数

     Override signout: 选择复选框以启用 CA Endevor OVERRIDE SIGNOUT 参数。

     Search map: 选中复选框以启用 CA Endevor SEARCH MAP 参数

     Where CCID type: 要为 CA Endevor 操作指定的 WHERE CCID TYPE 参数。 有效值显示在菜单中。

     1st where CCID value: 要为 CA Endevor 操作指定的 1ST WHERE CCID VALUE 参数。

     2nd through 8th where CCID values: 要为 CA Endevor 操作指定的 2ND THROUGH 8TH WHERE CCID VALUES 参数。

     1st where processor group value: 要为 CA Endevor 操作指定的参数 1ST WHERE PROCESSOR GROUP VALUE

     2nd through 8th processor group values: 要为 CA Endevor 操作指定的 2ND THROUGH 8TH PROCESSOR GROUP VALUES 参数

     Submit as batch job: 从菜单中选择提交作业的方式。

  4. 指定完所有参数后，单击 确定。
     将在元素上调用 CA Endevor RETRIEVE ELEMENT 操作。
• 抽取到 z/OS 项目。
  要检索元素并将其放入 IBM® z/OS 项目中，可以使用 抽取到 > 远程项目 操作。 将元素抽取到远程项目将检索该元素并将其放在 z/OS 项目和 MVS 子项目中。 您可以从向导创建 z/OS 项目和 MVS 子项目 (如果不存在)。
  1. 在 " CARMA 存储库 " 视图中，连接到 CA Endevor SCM RAM 并浏览到要抽取到 z/OS 项目的元素。
     注: 如果所有元素都具有相同类型，那么可以选择多个元素。
  2. 右键单击 " CARMA 存储库 " 视图中的元素，然后单击 抽取到 > 远程项目。
     此操作将打开“抽取至远程 z/OS 项目”向导。 有关此 CARMA 向导的更多信息，请参阅 ../../com.ibm.etools.carma.doc/tasks/extracttozosproject.html。
  3. 完成抽取向导后，将显示 " 检索元素 " 窗口以提示您输入完成 CA Endevor RETRIEVE ELEMENT 操作所需的参数。 输入所需参数。 可以通过从 以批处理方式提交 菜单中选择方法，以批处理方式提交 RETRIEVE ELEMENT 操作。
  4. 输入所有必需参数后，单击 确定。
     将对该元素调用 CA Endevor RETRIEVE ELEMENT 操作。 该元素将添加到 MVS 子项目中，并且可以在 " z/OS 项目 " 视图中查看。
• 抽取到数据集。
  通过使用 抽取到 > 目标 DataSet 选项，可以在整个 CA Endevor SCM 中的不同位置抽取多个元素。 要检索的所有元素必须具有相同的 RETRIEVE ELEMENT 参数。 此操作将对所有选定成员调用 CA Endevor RETRIEVE ELEMENT 操作，并将其放入指定的目标数据集中。
  1. 在 " CARMA 存储库 " 视图中，连接到 CA Endevor SCM RAM ，然后浏览到要抽取到 z/OS 项目的元素。
  2. 选择要添加到 CA Endevor SCM 的成员。 按住 SHIFT 键以选择多个相邻成员。 按住 CTRL 键以选择多个单独的非连续成员。
     限制: 如果您正在使用版本低于 9.0的 CA Endevor RAM ，那么不支持 抽取到 > 目标 DataSet 操作。
  3. 右键单击其中一个所选成员，然后单击 抽取到 > 目标 DataSet。
     “检索元素”窗口将打开。
  4. 使用 " 检索元素 " 窗口来指定 CA Endevor RETRIEVE ELEMENT 操作所需的参数。 可以通过从 以批处理方式提交 菜单中选择方法，以批处理方式提交 RETRIEVE ELEMENT 操作。
  5. 指定所有必需参数后，单击 确定。
     将调用 CA Endevor RETRIEVE ELEMENT 操作，并将所选元素添加到指定的远程数据集。