IMPORT and EXPORT

Use the IMPORT and EXPORT commands to import and export commands for the currently selected study between the UIE ISPF front end and an external z/OS data set.

IMPORT and EXPORT command are issued only from the UIE ISPF main menu and affect only the currently selected study.

Related topic

Command-and-syntax-reference

Using these commands, you can export UIE commands from the active study, make a large number of changes to them with a full-function editor, and then import them back into the currently selected study. You might use this procedure to develop a number of APPL commands to group your applications together and then import them into a study.

You can also use the IMPORT command to import Visualizer commands that have been translated into their UIE equivalents by the MVCMDCV program supplied with UIE.

Syntax

EXPORT DSNAME <FLAT or ASIS>

or

IMPORT <APPEND or REPLACE>

Syntax explanations

  • DSNAME is a standard formatted data set name.
  • FLAT—Adding FLAT to the EXPORT command causes the EXPORT command to flatten out any multi-line commands into a single output command line. This is the default for the EXPORT command.
  • ASIS—Adding ASIS to the command causes the exported command lines to appear exactly as they appear in the UIE ISPF front-end.
  • APPEND—APPEND is the default for the IMPORT command. Using APPEND in the IMPORT command causes anything that is in an external z/OS data set to be appended onto the bottom of the currently selected study commands. If you are importing from an empty, but otherwise valid data set, this command does nothing. The data in the input data set is broken up into segments small enough to fit within the 72 character command width limitation of the UIE ISPF front-end. If any of the segments in the external data set are longer than 72 characters, the import fails.
  • REPLACE—Adding REPLACE to the command causes all of the existing commands in the study to be replaced by the contents of the external data set. If the data set is empty, but otherwise valid, all the existing commands in the study are replaced with a single comment line. The data in the input data set will be broken up into segments small enough to fit within the 72 character command width limitation of the UIE ISPF front-end. If any of the segments in the external data set are longer than 72 characters, the import fails.

Rules

  • The IMPORT and EXPORT commands use the standard TSO format for DSNAME. That is, ‘X.Y.Z’ is used exactly as it appears, while X.Y.Z becomes 'USRPREF.X.Y.Z'.
  • The output data set is always recreated as RECFM=VB LRECL=8196 BLKSIZE=0. The input data set can be any sequential data set or a member of a partitioned data set.

Important

You cannot import or export data across different locales.

Examples

  • EXPORT ‘BMC.UIE.COMMANDS’

    In this example, all commands in the current UIE study are exported to the data set ‘BMC.UIE.COMMANDS’. If this data set does not exist, it will be created.

  • IMPORT ‘BMC.UIE.COMMANDS’ REPLACE

    In this example, all commands in the data set, ‘BMC.UIE.COMMANDS’ are imported into the current UIE study and will REPLACE any commands that are currently in the UIE study.

  • EXPORT SIMPLE SIMPLE

    This example exports the study SIMPLE as 'USRPREF.SIMPLE' for editing.

  • IMPORT 'USRPREF.SIMPLE.EDITED' REPLACE

    This example overlays the current study with the contents of data set 'USRPREF.SIMPLE.EDITED'.

 

Tip: For faster searching, add an asterisk to the end of your partial query. Example: cert*