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.