Migration Information › Migrate from r11.7 to r11.8 › Update Rules and Execs for OPSDEV Function Changes

Update Rules and Execs for OPSDEV Function Changes

The CA OPS/MVS OPSDEV function has been updated with additional device statuses returned in Word 3 and Word 14. This function includes a new U status for returning devices with a status of unavailable. If your automation rules or execs use the OPSDEV function and query status information in either Word 3 or Word 14, you may need to update your rules, execs, or both.

To update your automation for OPSDEV changes

1. Search for occurrences of OPSDEV in your rules and execs to determine whether any of those rules and execs are using the OPSDEV function and are examining the returned contents of either Word 3 or Word 14.
2. If a rule or exec is examining the returned values in Word 3, add to the rule or exec the new UNAVAIL status value as necessary.
   • When OFFLINE devices are also UNAVAILABLE, Word 3 will now contain the status value of UNAVAIL instead of OFFLINE.
   • When OFFLINE devices are available, Word 3 will contain the status value of OFFLINE as before.
   • When ONLINE devices are available, Word 3 will contain the status value of ONLINE as before.

   Example: If you examine Word 3 to find all OFFLINE devices, you will need to update your rule or exec to look for a value of UNAVAIL as well as a value of OFFLINE. Or, you can use the F status on the OPSDEV function call to filter the devices returned to OFFLINE devices only, which will also include UNAVAILABLE devices.

   Note: The UNAVAILABLE tape device status was introduced at z/OS 1.10 and is currently only valid for tape devices. Therefore, Word 3 will only contain the UNAVAIL value on systems running z/OS 1.10 or higher as no tape device can be in UNAVAILABLE status unless the system is running at least z/OS 1.10.

3. If a rule or exec is examining the returned values in Word 14, add to the rule or exec the new AFH (auto-switch devices assigned to a foreign host) status value as necessary.
   • When an auto-switch tape device is assigned to a foreign host, Word 14 will now contain the value of AFH instead of AUTS (auto-switch tape devices).
   • When ONLINE and OFFLINE auto-switch tape devices are not assigned to a foreign host, Word 14 will contain the value of AUTS as before.
   • When tape devices are not auto-switchable, Word 14 will contain the value of NAUT as before.
   • For all other devices, Word 14 will contain the N/A character string as before.

   Example: If you are examining Word 14 to find all auto-switch devices, you will need to update your rule or exec to look for a status value of AFH as well as a status value of AUTS.