REXX External Assembler API › Make Programs Accessible to CA NetMaster

Make Programs Accessible to CA NetMaster

REXX external interface programs must be made accessible to CA NetMaster. This means that they must be in a STEP/JOB library or in the LINKLIST or LPA libraries.

CA NetMaster requires APF authorization. Because all libraries in the STEP/JOB library concatenation must be APF-authorized, this means that these external programs must be placed in an APF-authorized library.

Placing modules in an APF-authorized library is normally restricted by installation security configuration. Having placed the programs in an appropriate library, the programs must (in most cases) also be registered with NetMaster REXX.

Depending on the use of the program, this can be done as follows:

• If a program is to be called as an external PROCEDURE or FUNCTION by using the RXCTL DEFINE command:

  RXCTL DEFINE FUNCTION=funcname [ LOADMOD=modname ]
  

  (If the LOADMOD operand is omitted, the function or procedure name is also the load module name).

• If a program is to be called as an external subcommand handler by using the RXCTL DEFINE command:

  RXCTL DEFINE SUBCMD=envname LOADMOD=modname
  

• A program that has been defined using one of the above methods may use the IRXSUBCM facility to add another program to the subcommand table. In this case no additional registration is required.
• Programs called using ADDRESS LINK and ADDRESS ATTACH do not need registration (But of course, they must be in an accessible library).