Started tasks for the ISPF daemon

Customize the sample started task members SBLZSAMP(BLZISPFD) and SBLZSAMP(BLZISPFS) for starting and stopping the ISPF daemon.

The ISPF daemon has two started task procedures: one to start the daemon and one to stop the daemon in the system procedure library defined by your JES subsystem. In the following instructions, the IBM default procedure library, SYS1.PROCLIB, is used.

Customize the sample started task members hlq.SBLZSAMP(BLZISPFD) and hlq.SBLZSAMP(BLZISPFS), as described within the members, and copy them to SYS1.PROCLIB. These instructions assume PROCLIB member names of BLZISPFD to start the daemon and BLZISPFS to stop the daemon have been created; however, you can use any names. Ensure that the PROCLIB members match the started task definitions in the BLZRACFT job in hlq.SBLZSAMP that you have already submitted.

As shown in the code sample that follows, you must provide:
  1. The ISPF daemon port. The default port is 4152.
  2. The home directory where Engineering Workflow Management , is installed. The default directory is /usr/lpp/jazz/v7.1.0.
  3. The location of the configuration files. The default location is /etc/jazz710/ccm.
  4. The location of the directory for the temporary files. The default location is /tmp.
//*                                                          
//* ISPF DAEMON - Start                                      
//*                                                          
//BLZISPFD PROC PORT=4152,                                   
//             HOME='/usr/lpp/jazz/v7.1.0',                  
//             CNFG='/etc/jazz710/ccm',                      
//             WORK='/tmp'                                   
//BLZISPFD EXEC PGM=BPXBATSL,REGION=0M,TIME=NOLIMIT,         
//             PARM='PGM &HOME./ispfclient/bin/ispfdmn.sh &PORT &CNFG &WORK'
//STDOUT  DD   SYSOUT=*                                      
//STDERR  DD   SYSOUT=*                                      
//        PEND                                               
//*
Notes:
  1. Refer to ISPF daemon START (S) command for additional information.
  2. To ensure that the ISPF daemon shuts down cleanly at system shutdown time, the BLZISPFS started task should be used. You should add this started task to your system shutdown procedures.
The maximum length for the PARM variable is 100 characters, which might cause problems if you use custom directory names. To bypass this problem, you can either:
  • Use symbolic links
    Symbolic links can be used as shorthand for a long directory name. The following sample z/OS UNIX command defines a symbolic link (/usr/lpp/jazz) to another directory (/long/directory/name/usr/lpp/jazz).
    ln -s /long/directory/name/usr/lpp/jazz /usr/lpp/jazz
  • Use STDIN

    When the PARM field is empty, BPXBATSL starts a z/OS UNIX shell and runs the shell script provided by STDIN. STDIN must be a z/OS UNIX file (allocated as ORDONLY). Using STDIN disables the use of variables for the PROC parameters. The shell executes the shell logon scripts /etc/profile and $HOME/.profile.

    To use this method, you must update the startup JCL to contain code similar to the following sample:
    //*
    //* ISPF DAEMON - USING STDIN
    //*
    //BLZISPFD PROC CNFG='/etc/jazz710'
    //*
    //RSE EXEC PGM=BPXBATSL,REGION=0M,TIME=NOLIMIT
    //STDOUT DD SYSOUT=*
    //STDERR DD SYSOUT=*
    //STDIN DD PATHOPTS=(ORDONLY),PATH='&CNFG./ispfdmn.stdin.sh' 
    // PEND 
    //*
    You must also create the shell script (/etc/jazz/ispfdmn.stdin.sh in this example) to start the ISPF daemon. The content of this script should contain code similar to the following sample:
    /long/directory/name/usr/lpp/jazz/v7.1.0/ispfclient/bin/ispfdmn.sh 4197 /etc/jazz/ccm