Previous Topic: Automatically Extracting a ModelNext Topic: Generating a New Model


Manually Extracting a Model

When you manually extract a model, you create an extract file from the source encyclopedia and transfer the extract file to the destination encyclopedia.

To download a file when the source encyclopedia is a CSE

At the prompt, issue the download command with these parameters:

download -u userid -m model [-s subset] -e childency ID [-c childmodel name] [-n count] [-d directory] [-i requestor code page] -t extract
userid

Defines a userid that must have authorization to download models.

model

Defines the model name. Enclose the model name in double quotes when it contains embedded spaces, as in "model name".

s

(Optional) Defines the subset name. Enclose it in double quotes when contains embedded spaces, as in "subset name".

e

Defines is the child encyclopedia ID.

c

(Optional) Defines the child model name if you want it to change it from the parent model name. Enclose child model name in double quotes, when it contains embedded spaces, as in "child model name".

n

(Optional) Defines the number of downgrades to report.

Default: 100.

d

(Optional) Defines the directory name of the destination directory for the extract.trn file.

Default: the current directory.

i

Defines the requestor code page of the destination CSE. To determine this value, see Supported Code Pages Values in the National Language Support chapter.

Default: 0 for no translation.

t

Defines the type of download, an extract.

Example

download -u john -m "my model" -e 111 -c "my child model" -s subset1 -n 50 -t extract

Builds the extract.trn file for the user name ID john, from the model that is named my model, names the child model my child model, and the subset subset1. This build report 50 downgrades.

To create a download file when the parent model is on a Host Encyclopedia

When the parent model is on a Host Encyclopedia, to create the download file, userid.IEF.TRAN, using option 1.3.15 (Download Model) or 1.4.13 (Download Subset), use the following command:

%IEFDOWN MODEL ('full model name') SUBSET('subset name') SOFTWARE('schema') EXTRACT CPID('destination code page of CSE') CHILDENCYID('destination encyclopedia ID') CHILDMODEL('child model name')

Note: For information about extracting a subset from the Host Encyclopedia, see the Host Encyclopedia Subsetting User Guide.

To move the extract file to destination encyclopedia

Follow these steps:

  1. Rename the file to load.trn
  2. Before uploading, run trnrpt –t load to generate a report to detail downgrades.

To load the child model into the encyclopedia

From the server install directory, issue an upload command to load the child model into the encyclopedia, using these parameters:

upload -u userid -t load [-d directory]
userid

Defines a userid that must have authorization to download models.

t

Defines the type of upload

d

(Optional) Defines the directory name of the destination directory for the extract.trn file.

Default: the current directory.

Example

upload -u john -t load

Uploads the child model to the encyclopedia using user ID john