Process Macros › WTOR Macro

WTOR Macro

The WTOR macro sends a WTOR message to all local system consoles and waits for the reply.

Parameters: WTOR Macro

WTOR Text

Specifies the WTOR message to send.

Reply Match Text

Specifies the replies to look for. You can specify up to five reply text versions (rules), each setting a specific value for the macro return code. Specify enough text to positively identify each version. You can use the asterisk (*) as the wildcard character in the reply text.

R/Code

Specifies the value to set for the return code if a reply satisfying the rule in the Reply Match Text field is received. Use different values to differentiate between the different replies. The macro return code thus indicates the type of reply received.

Store Actual Reply Text in Variable Name

Specifies the name of the variable in which to put the received reply.

Wait Time

Specifies the number of seconds to wait for a reply that satisfies one of the rules in the Reply Match Text field. If the specified time expires, the WTOR message is canceled and the return code is set to the value specified in the Wait Time Expiry Return Code field.

Wait Time Expiry Return Code

Specifies the value to set for the return code if no valid reply is received within the specified time.

Example: WTOR Macro

In the following example, you want to find out whether one of five specified users has logged on to a console.

 PROD----- Automation Services : WTOR Issue MACRO Parameter Definition ---------
 Command ===                                                     Function=BROWSE

 .- WTOR Text To Be Issued ----------------------------------------------------.
 |                                                                             |
 | WTOR Text... WHAT IS YOUR USER ID?                                          |
 |                                                                             |
 ’-----------------------------------------------------------------------------’
 .- Response Text Analysis ----------------------------------------------------.
 |                                                                             |
 |             Reply Match Text                                R/Code          |
 |             USER01                                          10              |
 |             USER02                                          20              |
 |             USER03                                          30              |
 |             USER04                                          40              |
 |             USER05                                          50              |
 |                                                                             |
 |             Store Actual Reply Text in Variable Name  REPLYTEXT             |
 |                                                                             |
 |             Wait Time 120   Wait Time Expiry Return Code 32                 |
 ’-----------------------------------------------------------------------------’

  F1=Help      F2=Split     F3=Exit
                            F9=Swap