Skip to Content

Batch method for Message Advisor ISPF

This section describes how to build Message Advisor commands in an ISPF environment and how to submit them in batch.

Warning

Note

The Message Advisor base commands DEQUEUE, DISPLAY, REQUEUE, and UNLOAD can be built by using the structured data entry panels of the Message Advisor ISPF interface, or they can be built by using a data set editing facility such as ISPF.

Other Message Advisor commands and all Message Advisor QPF commands ( QPF_ACTION, QPF_LIST, and QPF_OPTIONS) must be built by using ISPF or a similar data set editing facility. Because the Message Advisor interface contains a direct interface to ISPF edit, these commands can be built without exiting the Message Advisor interface.

You may want to build several command sets and execute them as one Message Advisor request. By using multiple command sets within a single request, you can accomplish multiple tasks with one request. For example, you can unload, dequeue, and requeue all messages as a single task with one request containing multiple command sets.

If you are building a request by using a data set editing facility, you can also assign conditional steps to one or more command sets within the request. Conditional steps are used to specify that a command set will not be executed unless a previous command set is executed successfully or that it will be executed only if a previous command set is unsuccessful.

When a command set or a Message Advisor request is built, it can be submitted through a TSO batch job or it can be executed through the Message Advisor ISPF interface panels. Through the interface panels, you can execute the command set or a Message Advisor request in foreground or background.

To build and execute a command set or Message Advisor request by using the batch method, perform the following tasks:

  • Allocate a request library.

    You may want to allocate a separate library for your command set, such as bmcnode.MAQ.REQUEST.

  • Build a command set or a Message Advisor request from a sample.

    Although a command set or a Message Advisor request can be built by typing the desired commands, subcommands, keywords, and parameters, this topic emphasizes by using the sample command sets provided by BMC Software. By using these samples, you will minimize errors and reduce the time that is required to build a command set. One or more sample command sets are provided for most Message Advisor commands.

  • Assign conditional steps to a request.

    This is an optional task that lets you specify that a command set within a request will not be executed unless a previous command set is executed successfully or that it will be executed only if a previous command set is unsuccessful.

  • Execute a command set or a Message Advisor request.
Warning

Note

A batch request can consist of multiple command sets. If a batch request contains multiple command sets, the command sets are processed as they are read. The Message Advisor Server terminates when it reaches the end of the SYSIN data set.

This section contains the following topics:

Related topic

Building-and-executing-a-command-set-in-your-request-library


 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*

Message Advisor for IMS 1.8