Starting Z instances

If you use the same directory structure that is used in these examples, and x3270 is installed on your native Linux® system, you can start your ZD&T Personal Edition system with the ./runzpdt script that is provided in /opt/ConfigGuideSample.

To start Z instances, copy the ./runzpdt script from /opt/ConfigGuideSample to the directory where you have kept all ADCD volumes and devmap, and run the script from the non-root user ID (ibmsys1). Then, ensure the environment variables shown in the example below are defined before you run the script.

For example, you can copy the ./runzpdt script to the /home/ibmsys1/volumes directory, and run the script as follows.
export PATH=/usr/z1090/bin:$PATH
export LD_LIBRARY_PATH=/usr/z1090/bin:$LD_LIBRARY_PATH
export MANPATH=/usr/z1090/man:$MANPATH
ulimit -c unlimited
ulimit -d unlimited
./runzpdt -d mygenerateddevmap -l cs
The script takes the following options:
./runzpdt -d <devmap name> -l <loadparm option>
Note: IPL the ZD&T z/OS® with the loadparm CS for the first time.

If x3270 is not installed on your native Linux, and you use other terminal emulators, such as IBM® Personal Communication, open the terminal emulator and configure it by specifying the IP (Linux machine IP) and port (3270) before you run the ./runzpdt command.

If you want to IPL the ZD&T manually, complete the following steps:
  1. Switch to the non-root user ID (ibmsys1).
  2. Change the path to /home/ibmsys1/volumes where you kept your devmap.
  3. Set the environment variables by using the following command. 
    export PATH=/usr/z1090/bin:$PATH
export LD_LIBRARY_PATH=/usr/z1090/bin:$LD_LIBRARY_PATH
export MANPATH=/usr/z1090/man:$MANPATH
ulimit -c unlimited
ulimit -d unlimited
  4. Enter the following command to start ZD&T Personal Edition.
    awsstart <devmap> --clean
  5. Open the terminal emulator, and provide the IP of your Linux machine. Then, set the port as 3270 if the automatic network configuration is not used, or 23/3270 if the automatic network configuration is used.

    Then, the terminal emulator screen is displayed, and the device #0700 is listed. If you open another terminal emulator, the device #701 is listed.

  6. Enter the IPL command: 
    ipl 0a80 parm 0a82<loadparm option>

    For example, ipl 0a80 parm 0a82CS

  7. Wait for a couple of seconds, the terminal emulator with #700 is switched to the master console. If the IPL process is successful, the terminal emulator with #701 is switched to the login screen.

For more information, see ADCD z/OS V2R4 December Edition of 2020.

The ipl statement contains three pieces of information. 0a80 is the device address of the SYSRES volume, which is a bootable z/OS volume. The parameter string 0A82xx specifies the 4-digit device address of the IODF volume that holds IPL configuration files, and the LOADPARM. The suffix identifies the LOADxx member that is used to start z/OS.

In case the connection to master console is lost, or the master console is not displayed after you issue awsstart command, issue the following commands in the Linux machine where you issued the awsstart command by using the non-root user ID.
oprmsg 'VARY CN(*),ACTIVATE'
oprmsg 'vary 0700,console'