IPCS primary command — invoke an IPCS subcommand, CLIST, or REXX exec

Use the IPCS primary command to invoke an IPCS subcommand, CLIST, or REXX exec from any of the panels of the IPCS dialog. The subcommand, CLIST, or REXX exec is entered exactly as though it was being invoked under IPCS in line mode. If the subcommand, CLIST, or REXX exec sends a report to the terminal, you view the report using the dump display reporter panel.

Note: Do not use the IPCS primary command to invoke a CLIST that contains a combination of a TSO/E CLIST function, such as SYSOUTTRAP, and an authorized TSO/E command, such as LISTD. Such a CLIST should be invoked only in IPCS line or batch mode or in a TSO/E environment.

Syntax

  IPCS     { subcommand }
  IP       { clist      }
           { rexx-exec  }

Parameters
subcommand

Specifies the IPCS subcommand to be run.

clist

Specifies the CLIST to be run.

rexx-exec

Specifies the REXX exec to be run.
Usage notes
- The IPCS primary command can be used in all options except TUTORIAL.
- There are two special symbols, CURSOR and X, that are accepted in the BROWSE option on the storage panel. These symbols are associated with a location in a dump and are used in the same manner as other symbols, such as the CVT and TCB symbols. These symbols affect how the subcommand, CLIST, or REXX exec processes.
  - CURSOR indicates the word of storage at which you position the cursor. By placing the cursor in the selection field preceding a word of storage or by placing the cursor under a word of storage, you can reference the word of storage. CURSOR is not in effect if the position of the cursor does not identify a word of storage or if you leave the storage panel.
  - X indicates the starting address of the data displayed on the storage panel. X remains in effect even if you leave the storage panel.
- If before entering this command you were processing the overriding dump source (as noted on the entry panel of the Browse option), IPCS will not process that dump source but will instead process the current default dump source.
Example 1: Change the SETDEF default parameters.
- Action
```
COMMAND ===> ipcs setdef print
```
- Result
  While in the BROWSE option, this command invokes the SETDEF subcommand to override the existing message routing default parameters.
Example 2: Locate a module and display its storage.
- Action
```
COMMAND ===> ipcs findmod iefbr14 noverify
```
- Result
  While in the BROWSE option on the storage panel, FINDMOD locates module IEFBR14, modifies X (the current address), and scrolls the storage containing the module into view.
Example 3: Display an array.
- Action
```
COMMAND ===> ipcs list x unsigned dim(5)
```
- Result
  While in the BROWSE option on the storage panel, LIST displays an array of 5 unsigned numbers whose first entry occupies the current address, X. The unsigned operand translates the numbers to decimal and displays the numbers on the dump display reporter panel.