Preparing to use the CICSPlex SM API

In each MVS™ image that contains a CMAS where you plan to run the CICSPlex® SM API, ensure that the following required modules reside in the proper location. These modules are supplied in the SYS1.CICSTS31.CPSM.SEYUAUTH library.

EYU9AB00
In an authorized library in either the MVS linklist or the STEPLIB concatenation of the application that calls the API. EYU9AB00 is the API batch interface module.
EYU9XESV
In an authorized library in either the MVS linklist or the CMAS STEPLIB concatenation. EYU9XESV is the API security exit module.

In addition, any application that calls the API must be link-edited with one of the following stub routine modules, regardless of what programming language is used:

EYU9ABSI
For batch, TSO, or NetView® programs. EYU9ABSI is supplied in the SYS1.CICSTS31.CPSM.SEYUAUTH library.
EYU9AMSI
For application programs running in CICS®. EYU9AMSI is supplied in the SYS1.CICSTS31.CPSM.SEYULOAD library.

Installing the REXX function package

The REXX run-time interface to the API is supplied as a function package and host command environment. The interface consists of a single load module that contains two entry points:

EYU9AR00
The function package
EYU9AR01
The host command

EYU9AR00 is supplied in the SYS1.CICSTS31.CPSM.SEYUAUTH library with an alias of IRXFLOC.

For a REXX program to access the function package, the module EYU9AR00, along with its alternate entry point, EYU9AR01, and its alias, IRXFLOC, must reside in an authorized library in one of these places:

For a REXX program to access the function package from NetView, the EYU9AR00 module must also be aliased to DSIRXLFP and placed in an authorized library in either the MVS linklist or the STEPLIB concatenation for the NetView system.

Note:
Users of the CICSPlex SM run-time interface are subject to the normal CICSPlex SM API security checks. See the information in the CICS RACF® Security Guide.

The following members contain SMP/E user modification control statements that you can use to move the necessary API load modules to the SYS1.CICSTS31.CPSM.SEYULINK library. These members are supplied in CICSTS31.CPSM.SEYUSAMP.

Member Load module
EYU$UM11 EYU9AR00
EYU$UM12 EYU9AB00
EYU$UM13 EYU9XESV

If you use the IRXFLOC or DSIRXLFP aliases to provide access to the REXX function package, they must be placed ahead of any other IRXFLOC or DSIRXLFP modules in the STEPLIB (or MVS linklist) concatenation.

If you do not want to use the aliases for the REXX function package, you must modify your REXX parameter modules (IRXPARMS, IRXTSPRM, and IRXISPRM). If you do this, the following is recommended:

As the last step in installing the REXX function package, you must:

For more information about REXX function packages and host commands, see the TSO/E Version 2 REXX/MVS Reference book.

[[ Contents Previous Page | Next Page Index ]]