Rules Structure

The following tables describe the structures of the Maintain Messages in the TSO Broadcast Dataset solution rules, as well as the following KOA script:

• Read Broadcast Messages From a File and Trigger a Rule to Save the Messages

  Table 73 Command to Clear or Set Broadcast Messages Rule Structure

  Item	Description
  Title	Command to Clear or Set Broadcast Messages
  Name	BRODCAST
  Table	TSO
  Command	One of the following user-defined commands: BRODCAST CLEAR BRODCAST SET [dsn] BRODCAST [HELP]
  Command Description	BRODCAST CLEAR Deletes all the messages from the notices section of SYS1.BRODCAST BRODCAST SET [dsn] Saves all messages from dataset dsn in the notices section of SYS1.BRODCAST. If dsn is not specified, a default dataset name is used. All previous notice messages are deleted. BRODCAST [HELP] Displays the syntax of command BRODCAST on the console.
  Basic Scheduling Parameters	Always schedule this rule.
  Runtime Scheduling Parameters	No special considerations.
  Global Variables	None.
  Rule Logic	If the command parameter is HELP, the command syntax is displayed on the console. If the command parameter is CLEAR or SET, the rule issues MVS command SEND LIST in command-response mode. For each response message, the rule extracts the message number and deletes the broadcast message by issuing MVS command SEND msgno,DELETE. If the command parameter is SET, the rule starts KOA script BRODCAST, with either the default or the specified dataset name parameter. (The KOA script reads messages from the specified dataset, and for each message, triggers an additional rule to set the broadcast message.) After the KOA script finishes, the rule issues a message indicating whether the broadcast dataset has been updated. For any other command parameter, the rule issues an error message.
  Rule Actions	If the command parameter is HELP, displays command syntax on the console. If the command parameter is CLEAR or SET, the rule issues MVS command SEND LIST in command-response mode. For each response message, the rule extracts the message number and deletes the broadcast message by issuing MVS command SEND msgno,DELETE. If the command parameter is SET, starts KOA script BRODCAST, with either the default or the specified dataset name parameter. (The KOA script reads messages from the specified dataset, and for each message, triggers an additional rule to set the broadcast message.) After the KOA script finishes, the rule issues a message indicating whether the broadcast dataset has been updated. For any other command parameter, the rule issues an error message.
  Activating the Rule	Once scheduled, the rule remains active until deleted from Control-O. The rule is triggered by each BRODCAST operator command.
  Recommended Mode or Category	During the testing period, the rule activate the rule in LOG mode. Once you are satisfied with the results of the rule, change the mode to PROD to avoid log messages for the rule. The SolveWare category for this rule is 2—some customization is required before implementation.
  Customization	The default name of the dataset in which the broadcast messages were edited is specified in the first DO SET statement of the rule (variable name %%BRODCAST_DSN). Set this variable according to site requirements.

  Table 74 Set a Given Broadcast Message in SYS1.BRODCAST Rule Structure

  Item	Description
  Title	Set a Given Broadcast Message in SYS1.BRODCAST
  Name	CTM2821
  Table	TSO
  Message	CTM282I BR=text-of-brodcast-message
  Message Description	The message is issued by KOA script BRODCAST and contains the text of the message to be saved in the broadcast dataset.
  Basic Scheduling Parameters	Always schedule this rule.
  Runtime Scheduling Parameters	No special considerations.
  Global Variables	None.
  Rule Logic	Extract the text of the message and issue MVS command SEND ‘text’,ALL,SAVE.
  Rule Actions	Extracts the text of the message. Issues MVS command SEND ‘text’,ALL,SAVE.
  Activating the Rule	Once scheduled, the rule remains active until deleted from Control-O.
  Recommended Mode or Category	During the testing period, activate the rule in LOG mode. Once you are satisfied with the results of the rule, change the mode to PROD to avoid log messages for the rule. The SolveWare category for this rule is 1—little or no customization is required before implementation.

  Table 75 Read Broadcast Messages from a File and Trigger a Rule to Save the Messages Script Structure

  Item	Description
  Title	Read Broadcast Messages from a File and Trigger a Rule to Save the Messages
  Name	BRODCAST
  KOA Script Description	This KOA script is invoked by rule BRODCAST. The rule passes to the script a parameter that identifies the dataset containing the text of the broadcast messages. The KOA script allocates and opens the dataset. Each record is read by the script and the text is issued as a WTO message by using a SHOUT command. This triggers rule CTM282I, which issues the corresponding MVS SEND command to save the messages. The script then closes and frees the dataset.
  Activating the KOA Script	The KOA script is activated by rule BRODCAST in this solution.
  Parameters	%A1 Name of the dataset that contains the messages. It must be a sequential dataset.
  Global Variables	None.
  KOA Script Logic	The KOA script allocates and opens the dataset passed as a parameter. Each record is read and the text is issued as a WTO message using a SHOUT command. This triggers rule CTM282I, which issues the corresponding MVS SEND command to save the messages. The dataset is finally closed and freed. No logon to a VTAM application is performed by this script.
  Recommended Mode or Category	During the testing period, the script can run with the TRACE ON option. When you are satisfied with the results, change this statement to TRACE OFF to avoid unnecessary tracing. The SolveWare category for this KOA script is 1—no customization (or minimal) is required before implementation.