RSEAPI, RSE API server started task

Customize the HUH.#CUST.PROCLIB(RSEAPI) sample started task member, as described within the member, and copy it to SYS1.PROCLIB. As shown in the following code sample, provide this information:
  • The home directory where RSE API is installed, default /usr/lpp/IBM/rseapi.
  • The location of the configuration files, default /etc/zexpl
Figure 1. RSEAPI: started task
//*
//* RSE API
//*
//RSEAPI   PROC HOME='/usr/lpp/IBM/rseapi',
//            APICFG='/etc/zexpl',
//            RSECFG='',
//            SRVNUM='1',
//            SECURE='true'
//*
//         EXPORT SYMLIST=*
//         SET QUOTE=''''
//         SET HOME=&QUOTE.&HOME.&QUOTE.
//         SET RSECFG=&QUOTE.&RSECFG.&QUOTE.
//         SET APICFG=&QUOTE.&APICFG.&QUOTE.
//         SET SRVNUM=&SRVNUM.
//         SET SECURE=&QUOTE.&SECURE.&QUOTE.
//*
//RSEAPI   EXEC PGM=BPXBATCH,REGION=0M,TIME=NOLIMIT,
//            PARM='PGM &HOME./tomcat.base/start.sh'
//STDOUT   DD SYSOUT=*
//STDERR   DD SYSOUT=*
//STDENV   DD *,SYMBOLS=JCLONLY
_BPXK_AUTOCVT=ON
CATALINA_RUN=run
RSEAPI_CFG=&APICFG
RSE_CFG=&RSECFG
SERVER_NUM=&SRVNUM
SECURE_SERVER=&SECURE
//         PEND
//*
Note:
  • For more information about the startup parameters, see Operator commands.
  • The sample JCL is initially named HUH.SHUHSAMP(HUHSTC) and is renamed to HUH.#CUST.PROCLIB(RSEAPI) in Customization setup.
  • Limit the length of the job name to 7 characters or fewer. If an 8-character name is used, the modify and stop operator commands fail with message “IEE342I MODIFY REJECTED-TASK BUSY”. This behavior is caused by the z/OS® UNIX design for child processes.