REXX External Assembler API › How You Make Programs Accessible

How You Make Programs Accessible

REXX external interface programs must be made accessible to CA NetMaster. 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.

Some programs must also be registered with NetMaster REXX.

How you register a program depends on the use of the program:

• If a program is called as an external PROCEDURE or FUNCTION, use 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 called as an external subcommand handler, use the RXCTL DEFINE command:

  RXCTL DEFINE SUBCMD=envname LOADMOD=modname
  

• A program that has been defined using one of the previous methods can use the IRXSUBCM facility to add another program to the subcommand table.
• Programs called using ADDRESS LINK and ADDRESS ATTACH do not need registration.