Previous Topic: Anticipate Subsetting UsageNext Topic: Minimize Host Encyclopedia Contention

Managing an Environment for Subsetting › Check Out a Subset to a CSE

Check Out a Subset to a CSE

You can check out subsets that are created on the Host Encyclopedia to a Client Server Encyclopedia (CSE), where they can be subsetted again or checked out by a user through the Checkout Client or the Toolset. An advantage of extracting a model to a CSE is that checkouts and updates are cheaper between a CSE and the Toolset than between the Host Encyclopedia and the Toolset.

After a user checks out the extracted subset from the CSE to the workstation, that user use the Update But Do No Check In command multiple times before issuing the Update and Check In command. After the Update and Check In command is issued, you can apply these updates to the parent model on the Host Encyclopedia, which checks in the model. Then, you can delete the child model, which would be in read-only status.

To download a subset with the extract option

  1. From the Main Menu, select Host Encyclopedia Functions, Subset Management, Download or enter 1.4.13.
  2. Complete the Download Subset panel as follows:
    1. Identify the model containing the subset and the subset to download. To download all objects in the model, enter ALL as the subset name.
    2. Enter the model schema for Software version. If you do not know, enter 1.3.5 from the Main Menu to display the Model Statistics panel, where the last entry is model release.
    3. Accept the default transaction file name to use userid.IEF.TRAN as the name of the data set to be created at download or enter a different name, where your TSO userid is automatically used as the prefix.
    4. Change the default Extract option to Yes to create a child model on a CSE.
    5. Enter the Child Encyclopedia ID. If you do not know what it is, bring up the Coordination Client, and select Encyclopedia, Actions Open, select the target encyclopedia from the list and press Detail. The data in the ID field is the Child ency ID.
    6. Enter as the Child model name the name to assign to the subset or model to be downloaded.
    7. Enter the codepage.

      For a listing of supported codepages, see the Client Server Encyclopedia User Guide.

      Note: If you do not know what it should be, bring up the Encyclopedia Client and detail an existing model using the same language. The codepage is displayed as Language Code. This is the identifier for the language (for example, English, French, Japanese) on the destination platform (for example, Windows), here the platform where the encyclopedia resides.

    h. Accept online as the execution mode or change to batch.

If you select batch, update JCL.

  1. Press Enter to begin download processing. The “IEF OK” message indicates the successful completion.
  2. Verify that the server install directory for the destination CSE does not contain a LOAD.TRN file that you want to preserve. If it does, consider creating a personal directory as the destination for the LOAD.TRN file or rename the existing file to avoid overwriting it.
  3. Use FTP or another file transfer utility to transfer userid.ief.tran from the Host Encyclopedia to the server install directory; name the file to be transferred LOAD.TRN.

    For example, issue the ftp command on the server, from the input subdirectory:

    ftp <input Host IP address>
    Name (input Host IP Address): <logon userid at server>
    Password: <logon password at server>
    ftp>cd '<userid on Host>.ief'
    ftp> bin
    ftp> get tran load.trn
    ftp> quit

  4. Load the model that is created by the extract into the CSE. From the directory where LOAD.TRN resides, enter the following: UPLOAD -u userid -t LOAD.