Loading deployment descriptors

Use this procedure to load your deployment descriptors to the z/TPF system with the E-type loader.

About this task

You can use the E-type loader or the image loader to load your deployment descriptors. This procedure is an example of how to load the descriptor files with the E-type loader.

Procedure

On Linux, create an offline loader input file that defines where to find the deployment descriptors on Linux and where to place them on the z/TPF system.
The following example shows the contents of an offline loader file called ddfiles.list:
```
@DEFINE
   SYSID=BSS
@LOADSET DESCRIPT

@FILE
   /home/mydir/bepDrvr.evspec.xml /sys/tpf_pbfiles/tpf-fdes/bepDrvr.evspec.xml
   /home/mydir/bepDrvr.evda.xml /sys/tpf_pbfiles/tpf-fdes/bepDrvr.evda.xml
```

On Linux, generate the OLDR format loader output file by entering the loadtpf command with the input file that you created in step 1 specified.

For example, loadtpf ddfiles.list.

The following messages are displayed. In this example, the files are transferred automatically to the z/TPF system based on a LOADTPF_IP parameter that is specified in the maketpf.cfg file.


MTPF2210I: Configuration file: "/home/mydir/maketpf.cfg"

MTPF2706I: loadtpf: Using loader input file "ddfiles.list".

MTPF2701I: loadtpf: Generating offldr output file.
           Command: "offldr oldr -o /home/mydir/mydir.oldr -l /home/mydir/ddfiles.list 
-r /home/mydir/OLDR.report         "

MTPF2709I: offldr return code: 0
           The following messages were generated:
LOAD0010I Parsing step ended with return code 0.
LOAD0020I Load step ended with return code 0.

MTPF2702I: loadtpf: FTPing offldr output file.
           Command: "echo -e "open 9.57.13.44  \n user ftp ******** \n binary \n epsv4 
\n cd /mytpf \n put /home/mydir/mydir.oldr mydir.oldr \n" | ftp -v -n"
Connected to 9.57.13.44.
220 TPF FTP server (Version 1.01) ready.
331 Guest login ok, type your name as password.
230 Guest login ok, access restrictions apply.
Remote system type is UNIX.
Using binary mode to transfer files.
200 Type set to I.
EPSV/EPRT on IPv4 off.
250 CWD command successful.
local: /home/mydir/mydir.oldr remote: mydir.oldr
227 Entering Passive Mode (9,57,13,44,4,4)
150 Opening BINARY mode data connection for 'mydir.oldr'.
226 Transfer complete.
90090 bytes sent in 00:00 (751.58 KB/s)
221 Goodbye.

MTPF2713I: loadtpf ended, RC=0.

On the z/TPF system, define a path to the directory where the OLDR format output file resides by entering the ZDSMG DEFINE command.

For example, ZDSMG DEFINE CMDEPLOY PATH='/mytpf/mydir.oldr'.

The following messages are displayed:


CSMP0097I 15.16.37 CPU-B SS-BSS  SSU-HPN  IS-01
CSMP0099I 15.16.37 010000-B ZDSMG DEFINE CMDEPLOY PATH='/MYTPF/MYDIR.OLDR'+
CSMP0097I 15.16.37 CPU-B SS-BSS  SSU-HPN  IS-01
DSMG0001I 15.16.37 DDNAME CMDEPLOY         DEFINED+

On the z/TPF system, load the loadset to the system by entering the ZOLDR LOAD command.

For example, ZOLDR LOAD CMDEPLOY.

The following messages are displayed:


CSMP0097I 15.16.41 CPU-B SS-BSS  SSU-HPN  IS-01
CSMP0099I 15.16.41 010000-B ZOLDR LOAD CMDEPLOY+
CSMP0097I 15.16.41 CPU-B SS-BSS  SSU-HPN  IS-01
OLDR1016I 15.16.41 CELA - LOAD REQUEST RECEIVED+
OLDR3000I 15.16.41 CLD0 - LOADSET DESCRIPT HAS BEEN LOADED FROM DDNAME CMDEPLOY+
CSMP0097I 15.16.41 CPU-B SS-BSS  SSU-HPN  IS-01
OLDR3001I 15.16.41 CELL - LOAD FOR DDNAME CMDEPLOY COMPLETED+

On the z/TPF system, activate the loadset by entering the ZOLDR ACTIVATE command.

For example, ZOLDR ACTIVATE DESCRIPT.

The following messages are displayed:


CSMP0097I 15.17.02 CPU-B SS-BSS  SSU-HPN  IS-01
CSMP0099I 15.17.02 010000-B ZOLDR ACTIVATE DESCRIPT+
CSMP0097I 15.17.02 CPU-B SS-BSS  SSU-HPN  IS-01
OLDR1016I 15.17.02 CELA - ACTIVATE REQUEST RECEIVED+
CSMP0097I 15.17.02 CPU-B SS-BSS  SSU-HPN  IS-01
OLDR2036I 15.17.02 ACTIVATE OF LOADSET DESCRIPT SCHEDULED
 FOR CPU B +
CSMP0097I 15.17.02 CPU-B SS-BSS  SSU-HPN  IS-01
OLDR2036I 15.17.02 ACTIVATE OF LOADSET DESCRIPT SCHEDULED
 FOR CPU C +
CSMP0097I 15.17.02 CPU-B SS-BSS  SSU-HPN  IS-01
OLDR2036I 15.17.02 ACTIVATE OF LOADSET DESCRIPT SCHEDULED
 FOR CPU D +
   :
   :
CSMP0097I 15.17.02 CPU-B SS-BSS  SSU-HPN  IS-01
OLDR2036I 15.17.02 ACTIVATE OF LOADSET DESCRIPT SCHEDULED
 FOR CPU 6 +
CSMP0097I 15.17.02 CPU-B SS-BSS  SSU-HPN  IS-01
CYC10007I 15.17.02 POOL TYPE SST DEVICE DEVA COUNTS     1100 IN USE
FIRST TIME THE DIRECTORY IS BEING USED SINCE LAST REALLOCATION+
CSMP0097I 15.17.02 CPU-B SS-BSS  SSU-HPN  IS-01
OLDR2015I 15.17.02 CEL2 - LOADSET DESCRIPT ASSIGNED ACTIVATION
                   NUMBER 1 ON CPU B+
CSMP0097I 15.17.02 CPU-B SS-BSS  SSU-HPN  IS-01
OLDR2043I 15.17.02 ACTIVATE OF LOADSET DESCRIPT COMPLETED
 FOR CPU B  AS REQUESTED BY CPU B+
CSMP0097I 15.17.10 CPU-B SS-BSS  SSU-HPN  IS-01
OLDR2043I 15.17.10 ACTIVATE OF LOADSET DESCRIPT COMPLETED
 FOR CPU C  AS REQUESTED BY CPU B+
CSMP0097I 15.17.10 CPU-B SS-BSS  SSU-HPN  IS-01
OLDR2043I 15.17.10 ACTIVATE OF LOADSET DESCRIPT COMPLETED
 FOR CPU D  AS REQUESTED BY CPU B+
   :
   :
CSMP0097I 15.17.10 CPU-B SS-BSS  SSU-HPN  IS-01
OLDR2043I 15.17.10 ACTIVATE OF LOADSET DESCRIPT COMPLETED
 FOR CPU 6  AS REQUESTED BY CPU B+

On the z/TPF system, remove the data definition name that was previously defined by entering the ZDSMG RELEASE command.

For example, ZDSMG RELEASE CMDEPLOY.

The following messages are displayed:


CSMP0097I 15.17.45 CPU-B SS-BSS  SSU-HPN  IS-01
CSMP0099I 15.17.45 010000-B ZDSMG RELEASE CMDEPLOY+
CSMP0097I 15.17.45 CPU-B SS-BSS  SSU-HPN  IS-01
DSMG0014I 15.17.45 DDNAME CMDEPLOY         RELEASED+

Results

All deployment descriptors that are specified in the loader input file are loaded to the /sys/tpf_pbfiles/tpf-fdes directory on the z/TPF system. Additionally, any deployment descriptor that is listed in the common deployment configuration file with the automatic deployment indicator set to YES is automatically deployed.

What to do next

To deploy any deployment descriptors that were not defined to automatically deploy, enter the ZMDES command with the DEPLOY parameter specified.

You can display all deployment descriptors that are currently deployed by entering ZMDES DISPLAY. For example:


CSMP0097I 15.29.17 CPU-B SS-BSS  SSU-HPN  IS-01
CSMP0099I 15.29.17 010000-B ZMDES DISP+
CSMP0097I 15.29.17 CPU-B SS-BSS  SSU-HPN  IS-01 _
MDES0016I 15.29.17 DISPLAY OF ALL DEPLOYMENT DESCRIPTORS FOR PROCESSOR B
IN-MEMORY    FILE
 STATUS     STATUS    FILE NAME
DEPLOYED   DEPLOYED   /sys/tpf_pbfiles/tpf-fdes/bepDrvr.evspec.xml
DEPLOYED   DEPLOYED   /sys/tpf_pbfiles/tpf-fdes/bepDrvr.evda.xml
END OF DISPL