Setting up the IMSplex environment

By switching the default host command to IMSSPOC and issuing the ADDRESS command, you can set up the IMSplex environment. After you set the default host command to IMSSPOC, IMSSPOC executes subsequent host commands issued by the REXX program that is running.

After you set the default host command to IMSSPOC, IMSSPOC executes subsequent host commands issued by the REXX program that is running. You can switch to other host commands by using the ADDRESS command with other hosts. For example:

ADDRESS TSO
ADDRESS MVS
ADDRESS ISPEXEC

You can then issue commands that are specific to those environments.

Note: If you issue commands other than the subcommands described here in the REXX environment, they are sent to OM for processing.

IMS subcommand

The IMS subcommand establishes the name of the IMSplex. You must issue the IMS subcommand to establish the IMSplex name before any other commands can be issued. A prefix of CSL is automatically added to the name that you specify.

ROUTE subcommand

Use the ROUTE subcommand to set the name of the command processors. The command processors are the specific systems that will execute subsequent IMS commands. If you do not specify a command processor:

the previous routing value is removed
commands are routed to all members of the IMSplex. This is the default.

If * is specified, the command is routed to all registered command processing clients in the IMSplex. If % is specified, the command is routed to only one command processing client in the IMSplex that is registered for the command and that has MASTER capability. The Operations Manager chooses the command processing client.

The ROUTE subcommand is optional.

CART subcommand

Use the Command and Response Token (CART) subcommand to set the name of the command and response token. This 16-character text string token is used to retrieve the command response.

You must issue the CART subcommand before you can issue any IMS commands.

WAIT subcommand

Use the WAIT subcommand to provide a timeout value to OM. The time value must be in the form MMM:SS or ssss. The maximum value you can specify is 999:59. The WAIT subcommand is optional.