You are here :: Home :: Documentation :: DtlSpawn User's Guide :: Installation

DtlSpawn - User's Guide

Previous | Contents

• Chapter 2: Installation and Configuration
  • 2.1 z/OS Installation
  • 2.2 z/OS Customization

Chapter 2: Installation and Configuration

This chapter explains how install the DtlSpawn utility.

Note: DtlSpawn is also included in the Co:Z Co-Processing Toolkit for z/OS. This section only applies to installation of DtlSpawn without the Co:Z Toolkit.

For questions and support, please visit the Dovetailed Technologies z/OS Forum

2.1 z/OS Installation

1. Download the distribution .pax file to your workstation and this file (in binary) to your z/OS system.
• If you are uploading using FTP, use the following comands (substituting your own dataset high-level qualifier)
  
ftp myzos.myco.com (login with your hostname, userid and password)
ftp> bin
ftp> quote site cyl
ftp> quote site pri=1
ftp> quote site recfm=fb
ftp> quote site lrecl=80
ftp> put dtlspawn-1.0.0.pax 'HLQ.DTLSPAWN.PAX'
ftp> quit

• If you are using Personal Communications, then use the following command.  
  Be sure that you are first logged into the host and within READY mode (outside ISPF).  
  Change the session string ("A:") to the one you are using and the destination dataset HLQ. 
  
send dtlspawn-1.0.0.pax A:'HLQ.DTLSPAWN.PAX' recfm(f) lrecl(80) space(1,1) cylinders
2. From a z/OS Unix shell, change to the directory under which you want to create the DtlSpawn temporary installation directory and unload the PAX dataset.  (This will create a new subdirectory called "dtlspawn").
cd /tmp
pax -rvf "//'HLQ.DTLSPAWN.PAX'"
3. The dtlspawn directory contains the loadmodule and sample jcl for running DtlSpawn.
   The loadmodule must be copied to a z/OS PDSE and the sample jcl to a PDS. For example:
cd /tmp/dtlspawn
cp -X loadmodules/* "//'HLQ.DTLSPAWN.LOADLIB'"
cp sampjcl/* "//'HLQ.DTLSPAWN.SAMPJCL'"

2.2 z/OS Customization

The DtlSpawn sample JCL contains two members which must be customized for your installation:

DTLSPAWN

A sample proc to run DtlSpawn which must be customized with the name of your load module library

RUNSPAWN

A sample job which demonstrates running DtlSpawn