Accessing resource tables from a new release

You can access the most up-to-date CICSPlex® SM resource tables by running an existing program under a new release of the API.

Note: To take full advantage of a new CICSPlex SM function (such as Business Application Services), however, you would have to modify an existing program or create a new one.
To run an existing API program under a new release of CICSPlex SM:
  • Make sure the following are available to your program:
    • The runtime module for the new release (EYU9AB00 from the new release's SEYUAUTH library)
    • A CMAS that is running the new release
  • Change the VERSION value on the CONNECT command to reflect the new release of CICSPlex SM and relink-edit the program using the stub module supplied in the new release.
  • Review the possible effects of any changes to the CICSPlex SM resource tables.

    Attributes may be added to a resource table in a new release, which could affect your program's references to that table. And with the addition or modification of attributes, the length of a given resource table may change from one release to another. The resource table copy books that are distributed with the new release are a good source of information about such changes.

    Note: If there is no requirement to take advantage of the new function in the release it is possible to continue to run an existing API program unaltered, provided the VERSION value on the CONNECT command reflects the link-edit level used.

    If your program receives RESPONSE and REASON values of INVALIDPARM LENGTH when you run it under a new release of CICSPlex SM, the table length may have increased and your data buffer may not be long enough to accommodate the new resource table records.

  • If you are using customized views of resource tables, you are advised to check that the names of any new resource tables do not duplicate the names of your customized views, as this could affect your processing. For further details, see Building a customized resource table record.

    For a complete list of new and changed resource tables in a given release, see CICSPlex SM resource tables.



eyup1ai.html | Timestamp icon Last updated: Sunday, 4 June 2017