z/OS ISPF Planning and Customizing
Previous topic | Next topic | Contents | Contact z/OS | Library | PDF


Running interactively

z/OS ISPF Planning and Customizing
GC19-3623-00

To run interactively, invoke the conversion utility from any command line by entering:
ISPDTLC

Figure 1 shows the first screen of the ISPDTLC invocation panel with the default data set names and with the required options selected.

Figure 1. First ISPDTLC screen
 ┌─────────────────────────────────────────────────────────────────────────────┐
 │   Menu  Utilities  Commands  Language  Options  Help                        │
 │ ──────────────────────────────────────────────────────────────────────────  │
 │            ISPF Dialog Tag Language Conversion Utility - 5.5                │
 │                                                                             │
 │ Click here:   Go to DTL input names 5-16        Reset DTL input names 2-16  │
 │ Enter requested information:          Current Language: ENGLISH             │
 │                                                                More:     +  │
 │ Member name . . . . . . . .           (Blank or pattern for member list)    │
 │ DTL Source data set - 1 . . 'USERID.GML'                                    │
 │ DTL Source data set - 2 . .                                                 │
 │ DTL Source data set - 3 . .                                                 │
 │ DTL Source data set - 4 . .                                                 │
 │ Panel data set  . . . . . . 'USERID.PANELS'                                 │
 │ Message data set  . . . . . 'USERID.MSGS'                                   │
 │ Log data set  . . . . . . .                                                 │
 │   Log File Member name  . .           (Required when log file is a PDS)     │
 │ List data set . . . . . . .                                                 │
 │   List File Member name . .           (Required when list file is a PDS)    │
 │ SCRIPT data set . . . . . .                                                 │
 │ Command ===>                                                                │
 │  F1=Help        F2=Split       F3=Exit        F7=Backward    F8=Forward     │
 │  F9=Swap       F10=Actions    F12=Cancel                                    │
 └─────────────────────────────────────────────────────────────────────────────┘

The member name ISPMENU will cause all of the panels with the Menu action bar item to be converted.

When the interactive panel is displayed, change the data set names shown as required for your installation. Fill in the name of your input and output files where indicated. The first DTL source file should contain any local panel modifications. The second DTL source file contains the product panel source. The third DTL source file contains the conversion list member ISPMENU.
Note: The current language selection appears on all screens. A different language can be selected from the action bar.

After typing in your file names, scroll to the next screen (Figure 2).

Figure 2. Second ISPDTLC screen
 ┌─────────────────────────────────────────────────────────────────────────────┐
 │   Menu  Utilities  Commands  Language  Options  Help                        │
 │ ──────────────────────────────────────────────────────────────────────────  │
 │            ISPF Dialog Tag Language Conversion Utility - 5.5                │
 │                                                                             │
 │ Click here:   Go to DTL input names 5-16        Reset DTL input names 2-16  │
 │ Enter requested information:          Current Language: ENGLISH             │
 │                                                                More:   - +  │
 │ SCRIPT data set . . . . . .                                                 │
 │ Tables data set . . . . . .                                                 │
 │ Keylist Application ID  . .           (Up to 4 characters)                  │
 │ Enter "/" to select option                                                  │
 │ /  Replace Panel/Message/Script/Keylist/Command Members                     │
 │ /  Preprocess Panel Output                                                  │
 │    Place ISPDTLC Messages in log file                                       │
 │    Suppress Messages (ISPDTLC formatting)                                   │
 │    Suppress Messages (CUA exceptions)                                       │
 │ /  Use CUA Panel Attributes                                                 │
 │ /  Generate Statistics on Panel/Message/Script Members                      │
 │    Generate List file                                                       │
 │ Command ===>                                                                │
 │  F1=Help        F2=Split       F3=Exit        F7=Backward    F8=Forward     │
 │  F9=Swap       F10=Actions    F12=Cancel                                    │
 └─────────────────────────────────────────────────────────────────────────────┘
Note: To reduce the amount of screen output you can select options Suppress Messages (ISPDTLC formatting) and Suppress Messages (CUA exceptions).

Enter ISR as the Keylist Application ID and select the options as shown. Scroll to the next screen (Figure 3).

Figure 3. Third ISPDTLC screen
 ┌─────────────────────────────────────────────────────────────────────────────┐
 │   Menu  Utilities  Commands  Language  Options  Help                        │
 │ ──────────────────────────────────────────────────────────────────────────  │
 │            ISPF Dialog Tag Language Conversion Utility - 5.5                │
 │                                                                             │
 │ Click here:   Go to DTL input names 5-16        Reset DTL input names 2-16  │
 │ Enter requested information:          Current Language: ENGLISH             │
 │                                                                More:   - +  │
 │    Generate List file                                                       │
 │    Generate List file with ENTITY substitution                              │
 │    Generate Script file                                                     │
 │ /  Replace Log File Members                                                 │
 │ /  Replace List File Members                                                │
 │    List Source Convert Messages                                             │
 │    Use Expanded Log Message Format                                          │
 │    Allow DBCS                                                               │
 │    Specify KANA                                                             │
 │    Specify NOKANA                                                           │
 │ /  Create panels with Action bars                                           │
 │ /  Create panels with GUI mode display controls                             │
 │ Command ===>                                                                │
 │  F1=Help        F2=Split       F3=Exit        F7=Backward    F8=Forward     │
 │  F9=Swap       F10=Actions    F12=Cancel                                    │
 └─────────────────────────────────────────────────────────────────────────────┘

Scroll to the next screen (Figure 4).

Figure 4. Fourth ISPDTLC screen
 ┌─────────────────────────────────────────────────────────────────────────────┐
 │   Menu  Utilities  Commands  Language  Options  Help                        │
 │ ──────────────────────────────────────────────────────────────────────────  │
 │            ISPF Dialog Tag Language Conversion Utility - 5.5                │
 │                                                                             │
 │ Click here:   Go to DTL input names 5-16        Reset DTL input names 2-16  │
 │ Enter requested information:          Current Language: ENGLISH             │
 │                                                                More:   - +  │
 │ /  Create panels with GUI mode display controls                             │
 │ /  Add ISPDTLC version / timestamp to panels and messages                   │
 │    Combine scrollable areas into panel )BODY section                        │
 │    Display converted panels                                                 │
 │    Display converted panels in a window                                     │
 │    Bypass data set name validation (after first cycle)                      │
 │ /  Enable graphic character display                                         │
 │    Use field names in place of Z variables                                  │
 │    Align DBCS prompt text with entry field                                  │
 │    Preserve leading ENTITY blanks when "space" is not specified             │
 │    Process multiple line comment blocks                                     │
 │    Scroll member list to last selected member                               │
 │ Command ===>                                                                │
 │  F1=Help        F2=Split       F3=Exit        F7=Backward    F8=Forward     │
 │  F9=Swap       F10=Actions    F12=Cancel                                    │
 └─────────────────────────────────────────────────────────────────────────────┘

Scroll to the last screen (Figure 5).

Figure 5. Fifth ISPDTLC screen
 ┌─────────────────────────────────────────────────────────────────────────────┐
 │   Menu  Utilities  Commands  Language  Options  Help                        │
 │ ──────────────────────────────────────────────────────────────────────────  │
 │ ISPCP01    ISPF Dialog Tag Language Conversion Utility - 5.5                │
 │                                                                             │
 │ Click here:   Go to DTL input names 5-16        Reset DTL input names 2-16  │
 │ Enter requested information:          Current Language: ENGLISH             │
 │                                                                More:   -    │
 │    Bypass data set name validation (after first cycle)                      │
 │ /  Enable graphic character display                                         │
 │    Use field names in place of Z variables                                  │
 │    Align DBCS prompt text with entry field                                  │
 │    Preserve leading ENTITY blanks when "space" is not specified             │
 │    Process multiple line comment blocks                                     │
 │    Scroll member list to last selected member                               │
 │    Generate accessible character string                                     │
 │    Display additional DTL source data set list                              │
 │                                                                             │
 │ Conversion status message interval . . . 1    (0 - 999)                     │
 │ DISPLAY(W) option check interval . . . . 1    (1 - 99)                      │
 │ Command ===>                                                                │
 │  F1=Help        F2=Split       F3=Exit        F7=Backward    F8=Forward     │
 │  F9=Swap       F10=Actions    F12=Cancel                                    │
 └─────────────────────────────────────────────────────────────────────────────┘
Note: ISPF product panels require that the options "Preserve leading ENTITY blanks when "space" is not specified" and "Process multiple line comment blocks" be selected as shown in the figures here.

If a double byte language conversion is in process, the DBCS and KANA options might be required.

If you are recompiling the English version of the panels, a second conversion should be made for the uppercased English panels. You will need to enter a different output panel library name and select the UPPERENG language from the action bar. All of the other panel information and options should be the same as the first conversion.

Go to the previous page Go to the next page




Copyright IBM Corporation 1990, 2014