Activating the IOAVERFY utility

A sample job can be found in the IOAVERFY member in the IOA JCL library.

IOAVERFY may also be activated by specifying any of its commands in the PARM field of the JCL EXEC statement. In that case, only a single command may be specified and the utility's SYSIN file is ignored. IOAVERFY may also be invoked from another program by passing it a command that conforms to the format of a PARM passed via the JCL EXEC statement. For example

The VERIFY ENQ function verifies the locking of IOA and Control-M files from a multi-systems environment.

To verify the locking (ENQ) mechanism

1. Submit the IOAVERFY job in all systems that share the same IOA and Control-M files. Ensure that the job names of the jobs are all different since they must all run concurrently.
2. Wait for the following question, prompting whether to start the test:

   VRFJ43I VERIFY ENQ: START CONTROL-M ENQ TEST? L(IST), Q(UIT)

   This question is issued by the jobs for each of the systems. You must wait for this message to be issued in all the LPARS participating in the test.

3. Once the above message is issued in all the LPARS participating in the test, reply L (List LPARs) to each one, to determine whether the utility is able to detect all the other systems on which IOAVERFY ENQ test jobs were submitted. When an LPAR is missing from the list, the operator must check that the job is actually running during the test. When the LPAR list received in response indicates that all the requested LPARs are participating, reply Q to terminate (but the Q reply must only be used after the list was successfully produced in all the LPARS participating in the test).
4. Verify that the list produced from each and every system has entries for all the others systems. A system that is not in the list, and the job with IOAVERFY was running on it, has a problem with the ENQ related definition.