How HCD processes system commands

Applying action code c on a selected system in the CPC Image List invokes the Process System Command dialog. Here you can enter a system command that you want to be processed on the target system or on all systems belonging to the same sysplex. The sample dialog in Figure 1 shows the entered system command d ios,config.

The entered command must either be an MVS system command, if the target system is of type MVS, or a CP command, if the target system is of type VM. For target VM systems, command routing to other systems in the sysplex is not supported. However, HCD does not perform any verification or validation on the command syntax, but sends the entered string to the target system(s) to be executed there.

Figure 1. Process System Command

┌─────────────────────── Process System Command ────────────────────────┐
│                                                                       │
│                                                                       │
│ Specify a system command. It will be executed on the selected target  │
│ system. Press ENTER to continue.                                      │
│                                                                       │
│ System . . : TRX1                                                     │
│ Sysplex  . : TRX1PLEX                                                 │
│                                                                       │
│ Command  . . d ios,config___________________________________________  │
│                                                                       │
│ Do you want the specified command being                               │
│ executed on all systems in the sysplex ?   1   1.  Yes                │
│                                                2.  No                 │
│                                                                       │
└───────────────────────────────────────────────────────────────────────┘

When you press Enter, HCD redisplays the CPC Image List where column Activation Status now shows Executing for all systems where the command is processed. When you press Enter again, the Activation Status changes to Messages.

Now select action View messages (action code m ) to display the message(s) resulting from the system command as it had processed on the remote system. An example of a returned message list for the d ios,config command is shown in Figure 2.

Figure 2. Process System Command - returned messages

┌─────────────────────────────── Message List ────────────────────────────────┐
│   Save  Query  Help                                                         │
│ --------------------------------------------------------------------------  │
│                                                                  Row 1 of 8 │
│ Command ===> ___________________________________________ Scroll ===> PAGE   │
│                                                                             │
│ Select one or more messages, then press Enter. To refresh the list, press   │
│ ENTER without selections made. To reply to a WTOR message, use the REPLY    │
│ command.                                                                    │
│                                                                             │
│ System name: TRX1                                                           │
│                                                                             │
│ / Message Text                                                              │
│ _  IOS506I 17.59.32 I/O CONFIG DATA 776                                     │
│ #  ACTIVE IODF DATA SET = SYS1.IODF01                                       │
│ #  CONFIGURATION ID = MVSVM          EDT ID = 00                            │
│ #  TOKEN:  PROCESSOR DATE     TIME     DESCRIPTION                          │
│ #   SOURCE: R35      11-12-13 09:42:28 SYS4     IODF71                      │
│ #  ACTIVE CSS:  2    SUBCHANNEL SETS CONFIGURED: 0, 1, 2                    │
│ #  CHANNEL MEASUREMENT BLOCK FACILITY IS ACTIVE                             │
│ #  LOCAL SYSTEM NAME (LSYSTEM): R35                                         │
│ ***************************** Bottom of data ****************************** │
│                                                                             │
└─────────────────────────────────────────────────────────────────────────────┘