AOCUPDT

用途

AOCUPDT 执行多个状态更新功能，包括:

  • 更新资源的 自动化代理程序 状态
  • 标识与 自动化代理程序 状态更改相关联的任何消息以及针对这些消息执行的处理选项:
    • 是否发出消息并将其记录在 NetView 日志中
    • 发出了哪些消息
    • 消息是否作为通知消息发送到本地系统上的通知操作员 (不同于转发到焦点系统)
    • 是否将消息转发到焦点系统

    AOCUPDT 调用 AOCMSG 命令以处理日志和通知消息的处理。

  • 使用资源状态更改来更新 SDF 状态显示
  • 正在更新自动化管理器OB实测状态

语法

读取语法图跳过可视语法图AOCUPDT资源STATUS= 状态RESTYPE=SUBSYSTEMRESTYPE= 类型MSG=571MSG=消息标识( 消息标识, 消息文本)NONE(无， 消息文本)LOG=YESLOG=NOSDF_Options
SDF_Options
读取语法图跳过可视语法图,FPFWD=YES， FPFWD=NO,SDFUPDT=YES， SDFUPDT=NOINFO= 文本RV= ref_dataFROM= 用户标识( 域)USER=(1..240, "用户数据")

参数

资源
对其执行由其他 AOCUPDT 参数指定的状态或信息更新的资源的名称。 此值是必需的，必须首先在 AOCUPDT 调用上指定。 您可以将以下格式用于 资源。
格式 示例
system_name.resource PROD.TSO 或者 PROD.VTAM
system_name.resource/component PROD.TSO/SUBSYS
system_name.resource
/major_component.component		 SYSPLEX.SYSTEM/SAPLEX.CONFIG
资源 TSO 或者 VTAM

system_name 变量缺省为 AOFSYSNAME。

如果未在树中定义资源名称，那么需要指定 组件 。 在 SDF 面板中使用 BODY/CELL 语句时会发生此情况。 如果 组件 本身未在树中唯一定义，那么必须指定 major_component 以标识所需的 组件。 有关 组件 和 major_component的更多详细信息，请参阅 状态显示设施定义 。

状态
指定资源的 automation agent 状态的新值。

当您使用此参数来更改状态时，除非另有编码，否则某些其他 AOCUPDT 参数将执行缺省操作。 这些参数包括:

  • MSG
  • FPFWD
  • SDFUPDT

如果指定 STATUS 以更改状态，但不指定上面列出的任何参数 (因此使用参数缺省值) ，那么会发生以下情况:

  • SA z/OS 发出消息 AOF571I resource_name SUBSYSTEM STATUS FOR JOB jobname IS status - text ，并将消息记录在 NetView 日志中。
  • 指定的状态更改将反映在 SDF 状态面板中。

要更改 MSG ， FPFWD 和 SDFUPDT 参数所执行的值或操作，或者要阻止使用这些参数，必须指定这些参数和期望值。

如果使用长度大于 8 个字符的状态值，那么状态值将截断为长度为 8 个字符。

类型
标识 resource 参数的资源类型。 您可以指定自己选择的资源类型，但 SYSTEM 除外，后者仅保留供内部使用。 缺省值为 SUBSYSTEM。
类型
您自己选择的资源类型。
子系统
资源类型 SUBSYSTEM。
FPFWD
确定是否将指定的状态从本地系统 (发出 AOCUPDT 的系统) 发送到焦点系统。
是
状态为 "已发送"。 这是缺省值。
否
未发送状态。
注: 要将状态转发到焦点系统，必须已配置自动化网络并将自动化网络定义到 SA z/OS。 详情请参阅 IBM Z System Automation 《用户指南》。
SDFUPDT
确定指定的状态更改是否也反映在 SDF 状态显示中。
是
状态更改将反映在 SDF 状态显示中。 如果指定了 STATUS ，那么这是缺省值。
否
状态更改不会反映在 SDF 状态显示中。 如果未指定 STATUS ，那么这是缺省值。
MSG
此参数标识与 STATUS 参数指定的状态更改相关联的消息。 发出此消息是为了记录发生状态更改的时间。 仅当同时指定了 STATUS 参数时，此参数才适用。

缺省值为 571 ，即 SA z/OS 状态更改消息 AOF571I的消息标识， resource_name SUBSYSTEM STATUS for JOB jobname IS status-text。

可以使用以下格式指定此参数值:
消息标识
标识消息标识的数字部分。 例如， 571 指定 SA z/OS 消息 AOF571I。
(message_id)
完整的消息标识，包括消息前缀和消息号，括在括号中，例如 (AOF123)。
(message_id ， msgtext)
完整的消息标识，包括消息前缀和消息号，以及要替换消息文本中的消息变量的消息文本。 此整个规范括在括号中，例如 (123,AA,BB,CC)。 消息文本中不允许使用引号。

AOCMSG 命令将信息文本值替换为信息变量 &1 至 &9 中的信息变量，这些信息变量位于信息库中的固定信息文本中。 NetView 信息库中的固定信息文本。 有关此命令的工作方式的详细信息，请参阅 AOCMSG 。 根据 AOCUPDT 调用上指定的消息标识和消息文本，某些消息变量预设为特定值:

  • 变量 &1 始终设置为 AOFRUPDT，即 AOCUPDT 命令处理器所在的自动化程序的名称。
  • 如果省略了消息文本，那么将预设以下消息变量:
    变量
    设置
    &1
    AOFRUPDT
    &2
    时间
    &3
    system_name.resource
    &4
    资源类型
    &5
    子系统名称
    &6
    子系统作业名
    &7
    状态
  • 如果提供了消息文本，并且 message_id 编号为 571 ，那么将预设以下消息变量:
    变量
    设置
    &1
    AOFRUPDT
    &2
    时间
    &3
    system_name.resource
    &4
    资源类型
    &5
    子系统名称
    &6
    子系统作业名
    &7
    状态

    Variables &8 and &9 can be assigned values from the 消息文本 portion of this parameter.

  • 如果提供了消息文本并且 message_id 编号不是 571 ，那么将预设以下消息变量:
    变量
    设置
    &1
    AOFRUPDT
    &2
    时间
    &3
    system_name.resource
    &4
    资源类型

    Variables &5 through &9 can be assigned values from the 消息文本 portion of this parameter.

无
未通知操作员已进行更新。 文本字符串 resource CE resource_name STATUS UPDATED TO status_value 将写入 SDF。
(NONE ，msgtext)
未通知操作员已进行更新。 文本字符串 msgtext 将写入 SDF。
LOG
指定是否将跟踪消息写入 NetView 日志。 消息具有以下格式 :AOFRUPDT: system_name resource_name resource_type ， STATUS=status。 此规范可被全局变量 AOF_AAO_AOCUPDT_LOGGING 覆盖。 缺省值可以由同一全局变量指定。 如果未指定任何内容，那么缺省值为 YES。 更多信息，请参阅 IBM Z System Automation Customizing and Programming 中的附录 "全局变量"。
注意
在 SDF 状态描述符的详细信息面板中显示的 SDF INFO 属性。 可以是长度不超过 80 个字符的任何字母数字字符。
RV
自卫队状态描述符的引用值。 最大长度为 40 个字符。
起始
用户标识 (操作员任务) 以及 (可选) 状态更新发起方的域标识。 缺省值为发出任务和本地域标识。
用户
与资源关联的用户数据。 数据存储在用空格初始化的 240 字节区域中。 该参数接受两个值:
  1. 缺省为 1 的偏移量指定存储后续数据的区域中的位置。
  2. 由定界符括起的用户数据。 定界符可以是数据中未出现的任何大于 x '40' 的可打印字符。
当偏移量加上数据长度超过最大大小时， SDF 会截断数据。

限制和限制

AOCUPDT 具有以下限制:

  • 应仅从自动化过程发出 AOCUPDT。
  • 出现在消息文本中的括号必须正确配对和平衡。
  • 使用 AOCUPDT 来更改资源状态 仅 更改状态。 如果通过诸如 ACTIVMSG 或 TERMMSG 之类的命令处理状态更改，那么它不会启动发生的任何关联状态更改处理。 此外，自动化状态保持不变。 例如，如果该资源涉及到 STARTUP ，并且该资源的状态通过 AOCUPDT 更改为 UP ，那么此过程不会受影响，因为自动化状态不会更改为 IDLE。
  • AOCUPDT 根据新状态捕获具有缺省严重性的状态更改消息:
    • 如果状态为 "正在中断" ， "已中断" 或 "已停止" ，那么为 "严重"
    • 如果状态为 "正在异常终止" ， "已停止" 或 "不活动" ，那么重要
    • 异常 (如果状态为 STARTED2， CTLDOWN 或移动)
    • 在所有其他情况下正常

    可以使用伪消息标识 CAPMSGS 下的代码定义来覆盖缺省严重性。 在 CODE2下，为具有 SYSTEMMSG=YES 的消息指定 MVSESA ，或以其他方式指定子系统的作业名。 使用的严重性是代码定义表中匹配的第一行的 "返回值" 内容。 不考虑 CODE3 。 为避免消息捕获，请将 "返回的值" 设置为 *IGNORE*。

返回码

0
AOCUPDT 已正常处理。
4
已执行所有请求的操作。 但是，系统检测到要更改的某些数据与 AOCUPDT 调用上指定的已修改数据相同。
8
检测到不正确的关键字规范并将其忽略。 正常处理所有其他关键字。
12 个月
在 AOCUPDT 调用上未指定任何函数关键字。 已标识资源，但未指定要对该资源执行的操作。
16
当指定的资源类型 (RESTYPE 值) 为 SUBSYSTEM 且系统名称为运行 AOCUPDT 的系统时，找不到指定的 资源 。
20
resource 名称长度超过允许的长度。 当指定的 RESTYPE 值为 SUBSYSTEM 时，资源名称不能超过 11 个字符。
99
发生超时或其他错误。

用途

使用 AOCUPDT 更改资源状态时，会将状态更改消息发送给定义为接收消息的通知操作员。 无论是否启用或禁用资源的自动化标志 (设置为 "是" 或 "否") ，都会发生状态更改通知。 要禁止在发生状态更改时发送消息，请指定 MSG=NONE 以及 STATUS 参数。