IF

The IF command conditionally processes the EXEC, START, or STOP command that follows it on the same command input.

IF is especially useful when you want to use the same members of the rhilev.RKANPAR library to control copies of OMEGAMON® for IMS that run with different IMS systems. By using the IF command, you can reduce the maintenance effort in certain environments.

Format

IF <IMSID=cccc>          Then <EXEC  ...>
   <SMFID=cccc>               <P     ...>
   <CPUID=cccccccccccc>       <S     ...>
   <IMSTYPE=ccc>              <START ...>
                              <STOP  ...>

Test values and their descriptions

IF permits you to test several different values to determine whether the command that follows the THEN keyword will run.

The following table shows the various IF test values that you can specify.

Table 1. IF parameter values
Parameter Value Description
CPUID cccccccccccc The 12-character hardware CPUID of the machine. (See the title line on the first page of a dump.)
cccccc The 6-character hardware CPU serial number of the machine. It is available from the RMF CPU report.

For a multiprocessor, OMEGAMON for IMS compares the CPUID with all those within the multiprocessing complex.
IMSID cccc IMS ID of the IMS or DBCTL system you are measuring.
SMFID cccc SMF ID of the z/OS® system that you you are executing upon. This information is in SYS1.PARMLIB(SMFPRMnn).
IMSTYPE CTL

DBC

 Determines the set of interface commands that are executed, depending on whether the IMS environment is a DB/DC (CTL) or a DBCTL (DBC) environment.

If the test is successful, OMEGAMON for IMS issues the normal messages for the conditionally processed command. If the test fails because of an invalid value in the command, OMEGAMON for IMS issues a message that indicates this outcome.

The IF keyword supports your testing several different values to determine whether the command that follows its THEN keyword runs.

Output

The output of the IF command depends upon the success of its tests.