活动

作用

您可以使用 ACTIVMSG 命令通过更改应用程序的 SA z/OS 状态来响应来自应用程序的 ACTIVE 和 UP 消息。 ACTIVMSG 调用 ISSUEACT 命令还会针对 ACTIVE 或 UP 消息的标识以及应用程序的新状态发出自动化策略中定义的命令和应答。 通常，从 NetView 自动化表调用 ACTIVMSG。

语法

读取语法图跳过可视语法图ACTIVMSGUP=NOUP=YESJOBNAME= 作业名MSGTYPE= typeEHKVAR=YESEHKVAR=NOREPLY=NOREPLY=YESPASSES=NOPASSES=YESCODE1= code1CODE2= code2CODE3= code3PID= 编号ASID= ASID

参数

启动
此参数用于区分 ACTIVE 消息和 UP 消息。 ACTIVE 消息指示与应用程序关联的作业正在工作，但尚未可供使用。 UP 消息指示与应用程序关联的作业可供使用。
否
如果您正在响应应用程序 ACTIVE 消息，那么应使用 NO。 如果应用程序尚未处于 ACTIVE 状态，那么会将其置于 ACTIVE 状态。 缺省值为 UP=NO。
是
如果您正在响应应用程序 UP 消息，那么应该使用 YES。 如果应用程序尚未处于 UP 状态，那么会将其置于 UP 状态。 如果应用程序是瞬态作业，那么它将处于 RUNNING 状态。
作业名
消息所针对的作业的名称。 如果未指定，那么将从消息的作业名字段中获取作业名。 如果要从 CLIST 调用 ACTIVMSG ，那么必须为作业名提供值。
MSGTYPE
此参数用于在 自动化控制文件中搜索 子系统/msgtype-对的命令和应答条目，其中 subsystem 是派生自作业名的子系统名称。

发生匹配时，将发出与条目关联的命令。 这是对与 ENTRY-TYPE 对 子系统/ACTIVE (如果 UP=NO) 和 子系统/UP (如果 UP=YES) 相关联的条目的补充。

如果未指定参数 MSGTYPE ，那么将调用 ACTIVMSG 的消息的消息标识作为缺省值。

EHKVAR
此参数确定是否将解析的消息文本的标记存储在任务全局变量 EHKVAR0 到 EHKVAR9 和 EHKVART 中。
是
触发消息的标记将分配给任务全局变量 EHKVARn。
否
没有要分配给任务全局变量 EHKVARn的值。
应答
此参数确定是否对已调用 ACTIVMSG 的消息发出定义的应答。
是
将在由 ACTIVMSG 处理的消息的自动化策略中发出定义的应答。 如果消息是 WTOR ，那么将采用 REPLY=YES 作为缺省值，否则缺省值为 REPLY=NO。
否
未针对正在由 ACTIVMSG 处理的 WTOR 发出定义的应答。
通过
指定是否使用传递来发出已在自动化策略中定义的命令和/或应答。
是
P评估 = 是传递到 ISSUEACT 命令。
否
将P评估 = 否传递到 ISSUEACT 命令。
CODE1 =code1 CODE2 =code2 CODE3 =code3
这些参数将传递到 ISSUEACT 命令，在该命令中，这些参数用于通过代码条目选择定义的命令和应答。
进程标识
资源的进程标识。 它与 ASID 一起唯一地标识资源。
ASID
与资源关联的 ASID。 它与 PID 一起唯一地标识资源。

限制和限制

  • 如果 ACTIVMSG 由删除操作程序消息驱动，那么不会对此消息执行任何操作。
  • 仅当应用程序的相关次资源的启动标志允许自动化时，才会发出已定义的命令和应答以响应消息或状态更改。
  • 如果为触发消息定义了命令或应答，那么 ISSUEACT 会自动捕获触发消息 (请参阅 ISSUEACT (ISSUECMD ， ISSUEREP))。 如果没有，那么 ACTIVMSG 将捕获缺省严重性为 NORMAL 的触发消息。 可以使用伪消息标识 CAPMSGS 下的代码定义来覆盖缺省严重性。 在 CODE2下，为具有 SYSTEMMSG=YES 的消息指定 MVSESA ，或以其他方式指定子系统的作业名。 使用的严重性是代码定义表中匹配的第一行的 "返回值" 内容。 不考虑 CODE3 。 为避免消息捕获，请将 "返回的值" 设置为 *IGNORE*。

使用量

通常应该从 NetView 自动化表调用 ACTIVMSG 命令。

建议对所有 IEF403I (作业已启动) 消息使用 ACTIVMSG。

如果对 WTOR 调用了 ACTIVMSG 并且未对其进行回复，那么将调用 OUTREP 以跟踪 WTOR。

如果要对通用消息调用 ACTIVMSG ，那么应在调用 ACTIVMSG 之前使用 ING$QRY NetView 自动化表 函数来筛选消息。 有关更多信息，请参阅 ING$QRY 。

ACTIVMSG 应该在发出消息的子系统的工作操作员上运行。 否则， ACTIVMSG 命令将以异步方式运行至调用过程。 这意味着当调用过程重新获得控制时，受影响子系统的状态可能尚未更改。

通过 ACTIVMSG 触发的所有命令和应答都有权访问名为 AOFMSAFE 的 SAFE ，该 SAFE 存储导致 ACTIVMSG 调用的消息。

任务全局变量

EHKVAR0 到 EHKVAR9 和 EHKVART
When defining the commands in the automation control file to be issued by command ACTIVMSG, the variables &EHKVAR0 through &EHKVAR9 and &EHKVART can be used to be substituted by the tokens of the parsed message that has driven ACTIVMSG. &EHKVAR0 will be substituted by the message ID, &EHKVAR1 by the first token of the message text after the message ID, &EHKVAR2 with the second token and so forth. &EHKVART will be substituted by the trailing message text after the 9th token.

示例

以下示例显示如何从 NetView 自动化表调用 ACTIVMSG:

IF MSGID = 'IEF403I' & TOKEN(2) = SVJOB & DOMAINID = %AOFDOM% 
   & ATF('ING$QRY APPL,,JOB='VALUE(SVJOB)) ^= ''
THEN
EXEC(CMD('ACTIVMSG JOBNAME=' SVJOB)
ROUTE(ONE %AOFOPGSSOPER%));