Notes

• For OS/390, we do not recommend using TSO datasets in CICS. For information on using TSO datasets with QMF in a CICS environment, see the chapter on migration in Installing and Managing QMF for OS/390.
• A QMF Administrator can import a QMF object for another user.
• The queue must contain a single, complete QMF object before the IMPORT command is issued.
• When data is imported, a new form is created. Any existing form in temporary storage is replaced.
• If you are connected to a remote location the tables at the server are read-only restricted. Objects cannot be imported into that database. This restriction does not apply when QMF is running in a CICS/VSE environment.
• When you import into the database and an object already exists with the same name you specify, QMF replaces the object, subject to these conditions:
  • A form can replace only a form.
  • A procedure can replace only a procedure.
  • A query can replace only a query.
  • A table can replace only a similar table object.

    A similar table is one with the same number of columns, and corresponding columns each having the same data type and length. Column names and labels do not have to match.

• When you import into an existing table, the column names and labels remain unchanged. If the table does not exist, a new table is created using the column names and labels in the imported object.
• Objects can be imported to a remote location. Use the QMF CONNECT command to make the remote location your current location first, followed by the IMPORT command.

  If your current location is a DB2 for OS/390 server, you can import to an existing table at a remote location by specifying a three-part name for the table. You cannot import a new table nor any QMF objects this way.

• You cannot replace a comment on a table you don't own or on a remote table using a three-part name.
• Use the IMPORT command sparingly in CICS because it can negatively affect QMF performance for other users.
• The contents of a CICS TD queue are discarded when errors occur during an import. Be sure to use the correct object type for the object currently in the queue. A mismatch will result in an empty queue and no object imported.
• QMF handles CICS TD queues differently than CICS TS queues:

  Transient data queues

  QMF imports the entire transient data queue possibly creating a long delay prior to displaying the object. The entire object must fit into your storage or spill area.

  • An intrapartition TD queue can hold up to 32K rows of data.
  • An extrapartition TD queue can be as large as needed to hold the object.

  Temporary storage queues

  A temporary storage queue can hold up to 32K rows of data. When importing DATA from a CICS TS queue, QMF pauses after approximately 100 rows of data to display the report. You can complete the import by issuing a BOTTOM command. If there is not enough storage to complete the report, use the QMF RESET command to reset the data.