Template Export Utility panel

The Template Export Utility panel provides a means of exporting templates to external XML templates.

Panel and field definitions

Figure 1. Template Export Utility entry panel

  Process   Options   Help
 ──────────────────────────────────────────────────────────────────────────────
 File Manager           Template Export Utility
 Command ===>                                                                  

 Template:
    Data set name . 'FMN.IMP.EXAMPLE'                             
    Member  . . . .          (Blank or pattern for member list)
    Filter  . . . .                                                

 Export Data set:
    Data set name . 'FMN.XML.EXAMPLE'                             
    Member mask . .         

 Processing Options:
    Enter "/" to select option            Enter "/" to select option
       Batch execution                       Replace members
       Advanced member selection          /  Copybook and criteria only
       Skip member list                      Stats On

(Template) Data set name (required)

A fully qualified or generic data set name that is used to identify the data set where the template(s) to be exported reside

Member

You can enter a member name, or pattern, or leave blank. If you select advanced member selection, then this name constitutes the first name on the member range panel.

Filter

Enter up to 4 member names or patterns that are used as a filter for the template selection list that is displayed. The filter name is created as a copybook name for File Manager Base component and IMS™ templates. For IMS™ views and criteria it is treated as an originating template. Any other type of template is skipped if a filter is specified.

(Export Data set) Data set name (Required)

A fully qualified or generic data set name that is used to identify the XML template data set where the exported XML templates are stored.

Member mask

This is a rename mask and allows the exported templates to be stored under an alternative name.

Specify a pattern to rename members in the output partitioned data set based on the member names in the input partitioned data set. A member name pattern can consist of any characters that are valid in a member name and two special pattern characters: the asterisk (*) and the percent sign (%).

*: A place-holding character that means multiple characters with no change. Only one asterisk should appear in the mask. Any subsequent asterisk characters are treated as percent signs. For example, if you enter ABC* the renamed members all begin with ABC followed by the remainder of the old member name.
%: A place-holding character that means a single character with no change. As many percent symbols as necessary may appear anywhere in a member name. For example, if you enter %%%A*M the first three characters of the renamed members remain unchanged, the fourth character is replaced with the letter A, and the remainder of the old member name are unchanged.

Batch execution

Allows you to edit batch JCL to run the function in batch.

Advanced member selection

Allows you to specify a range of members to be selected, rather than a specific or generic member name.

Skip member list

Runs without showing the member selection list. This option bypasses the member list panel and processes all the qualifying members.

Replace members

Replaces like-named members in an output partitioned data set.

Copybook and criteria only

Restrict the output XML to only the copybook and criteria tags.

Stats On

Always update or create ISPF statistics for exported members.

Figure 2. Template Member Selection export member list

  Process   Options   Help
 ──────────────────────────────────────────────────────────────────────────────
  File Manager            Template Member Selection          Row 00001 of 00002
 Command ===>                                                       Scroll CSR 

 Input data set  FMN.IMP.EXAMPLE
 Export data set FMN.XML.EXAMPLE

        Name     Prompt   Type Created    Updated             Lang   Ver Descr _
        *        *        *    *          *                   *      *   *    
        CONVT1            DB2  2012/09/19 2012/09/19 11:40:56 NONE     3
        DJ1E              IMS  2012/09/19 2012/09/19 10:44:11 COBOL    3
 ****  End of data  ****

Sel

Prefix area. You can enter the following prefix commands:

B: Performs an ISPF BROWSE command against the member. The member is displayed using the ISPF Browse panel, not the File Manager Browse panel.
E: Invoke template editing.
S: Select for template update.
U: Invoke the template source definition edit and update process for the template.

Name

Name of the member.

Prompt

Status values relevant to the action being performed.

Created

The date the template was created.

Updated

For templates, this is the last changed date. For IMS™ views and extract criteria, this is the last time this was updated from its originating template

Lang

The original language of the copybooks from which the fields in the template were derived.

Ver

The version or level of the template.

Description

(To view, scroll right with the Right function key, F11.) The first line of the description that can be entered using the DESCRIBE command during template editing.

Figure 3. Scrolling right on the member list

  Process   Options   Help
 ──────────────────────────────────────────────────────────────────────────────
  File Manager            Template Member Selection          Row 00001 of 00002
 Command ===>                                                       Scroll CSR 

 Input data set  FMN.IMP.EXAMPLE
 Export data set FMN.XML.EXAMPLE

 -      Name     SSID Owner    Object name        DBD data set                 _
        *        *    *        *                  *                          
        CONVT1   DFB2 DSN8810  EMP
        DJ1E                                      FMIMS.XTEST.DBDLIB(DJ1E)
 ****  End of data  ****

SSID: Subsystem ID for Db2® template
Owner Db2®: Object owner for Db2® template
Object name: Db2® object name for Db2® template
DBD data set: DBD data set name for IMS™ template, view or criteria set

Figure 4. Scrolling further right on the member list

  Process   Options   Help
 ──────────────────────────────────────────────────────────────────────────────
  File Manager            Template Member Selection          Row 00001 of 00002
 Command ===>                                                       Scroll CSR 

 Input data set  FMN.IMP.EXAMPLE
 Export data set FMN.XML.EXAMPLE

 -      Name     Template data set (Views and Criteria)
        *        *                                                 
        CONVT1
        DJ1E
 ****  End of data  ****

Template data set: Originating template data set for IMS™ view or criteria set.