Creating started tasks for the Model development environment

After you configure the Model development environment, you can run the Model development environment as a z/OS® started task.

Before you begin

Install or migrate to ML for IBM z/OS version 3.2.0. For more information about the instructions, see Roadmap for installing and configuring ML for z/OS Core Roadmap for installing and configuring ML for z/OS Enterprise, or Migrating ML for IBM z/OS to Enterprise edition v3.2.0.

About this task

You can create the started task to manage the Model development environment by customizing the ALNJHSV sample JCL job.

Note:

You can globally replace:

<core_install_dir> with the MLz Core installation directory. The default value is /usr/lpp/IBM/aln/v3r2/core.
<ent_install_dir> with the MLz Enterprise installation directory. The default value is /usr/lpp/IBM/aln/v3r2/ent.
<java_install_dir> with the IBM Java 17 or Java 21 installation directory.
<aie_install_dir> with the IBM Z Deep Neural Network Library (zDNN) installation directory.
- The default directory for z/OS V2.5 is: /usr/lpp/IBM/aie
- The default directory for z/OS V3.1 or higher is: /usr/lpp/aie

Procedure

Locate the following files in the $IML_INSTALL_DIR/alnsamp/started-task-samples directory on the z/OS system where MLz runs:
- ALNJHSV (sample JCL job)
- JHSVSTRT-STDPARM.template (sample MVS™ data set content)
- JHSVSTOP-STDPARM.template (sample MVS data set content)
- stdenvs-STDENV.template (sample z/OS Unix text file content)
Copy ALNJHSV into a data set in the PROCLIB concatenation, such as SYS1.PROCLIB, and customize them on basis of the system environment.
Define a new MVS data set that the ddname STDPARM uses.
1. Create member JHSVSTRT for ALNJHSV by copying the following lines from the JHSVSTRT-STDPARM.template:
```
PGM <core_install_dir>/iml-zostools/bin/bash
<ent_install_dir>/imlpython/bin/model-dev-environment.sh start
 
```
2. Create member JHSVSTOP for ALNJHSV by copying the following lines from JHSVSTOP-STDPARM.template:
```
PGM <core_install_dir>/iml-zostools/bin/bash
<ent_install_dir>/imlpython/bin/model-dev-environment.sh stop
 
```

Create a new z/OS Unix text file stdenvs that ddname STDENV uses.

Copy the following lines from stdenvs-STDENV.template:


IML_INSTALL_DIR=<core_install_dir>
IML_INSTALL_ENT_DIR=<ent_install_dir>
IML_HOME=/my/iml-home
IML_JOBNAME_PREFIX=ALN
SPARK_HOME=<core_install_dir>/spark
JAVA_HOME=<java_install_dir>
WLP_INSTALL_DIR=/usr/lpp/liberty_zos/current
AIE_INSTALL_DIR=<aie_install_dir>
PATH=<core_install_dir>/iml-zostools/bin:/bin:<java_install_dir>/bin:<core_install_dir>/spark/bin:<core_install_dir>/spark/sbin:<core_install_dir>/nodejs/bin:<ent_install_dir>/pyz/pyz-313/bin
LIBPATH=/lib:/usr/lib:/usr/lib/java_runtime:<core_install_dir>/iml-services/utils:<core_install_dir>/spark/lib:<java_install_dir>/bin/classic:<java_install_dir>/bin/j9vm:<ent_install_dir>/pyz/pyz-313/lib:<aie_install_dir>/zdnn/lib
_BPXK_AUTOCVT=ON
_BPX_BATCH_UMASK=0022
IBM_JAVA_OPTIONS=-Dfile.encoding=UTF-8 -Dibm.racfkeystore.trustchaincheck=false
_TAG_REDIR_ERR=txt
_TAG_REDIR_IN=txt
_TAG_REDIR_OUT=txt
_BPX_SHAREAS=NO
_CEE_RUNOPTS=FILETAG(AUTOCVT,AUTOTAG) POSIX(ON)

Set all environment variables on basis of the z/OS system environment and the MLz installation. For more information, see Configuring user ID for setting up Machine Learning for IBM z/OS Enterprise Edition.

Note:

You can use the STDENV file for all the MLz started tasks.

Run the following commands to define a RACF® profile for the new ALNJHSV started tasks and assign <mlz_setup_userid> as the owner:
```
RDEFINE STARTED ALNJHSV.* STDATA(USER(<mlz_setup_userid>) GROUP(<mlz_group>))

SETROPTS RACLIST(STARTED) REFRESH
 
```
Run started task ALNJHSV to start the Model development environment
For example:
```
/S ALNJHSV
```
Optional: Run the following command to run the ALNJHSV started task to stop the Model development environment:
```
/S ALNJHSV,OPTION=’ JHSVSTOP’
```
Note:
The OPTION value is case-sensitive, you must run the command in the System Display and Search Facility system command extension to retain the lowercase of the input.