Running in batch mode

The batch conversion requires a profile data set that contains ddnames and data set names for the input and output files. The sample JCL shown in Figure 1 refers to the profile data set. The ISPDTLC invocation syntax specifies all of the required options for the conversion.

Change the data set names shown in both the profile and the JCL as required for your location.

Figure 1. Sample JCL for Batch conversion

//your jobcard here
//CONVERT  EXEC PGM=IKJEFT01,DYNAMNBR=50
//SYSPRINT DD SYSOUT=*
//SYSPROC  DD  DISP=SHR,DSN=your.exec.dataset
//SYSEXEC  DD  DISP=SHR,DSN=ISP.SISPEXEC
//STEPLIB  DD  DISP=SHR,DSN=ISP.SISPLOAD
//         DD  DISP=SHR,DSN=ISP.SISPLPA
//ISPLLIB  DD  DISP=SHR,DSN=ISP.SISPLOAD
//         DD  DISP=SHR,DSN=ISP.SISPLPA
//ISPMLIB  DD  DISP=SHR,DSN=ISP.SISPMENU
//ISPPLIB  DD  DISP=SHR,DSN=ISP.SISPPENU
//ISPTLIB  DD  DISP=SHR,DSN=your.profile.dataset
//         DD  DISP=SHR,DSN=ISP.SISPTENU
//ISPSLIB  DD  DISP=SHR,DSN=ISP.SISPSENU
//ISPTABL  DD  DISP=OLD,DSN=your.profile.dataset
//ISPPROF  DD  DISP=OLD,DSN=your.profile.dataset
//ISPLOG   DD  DISP=OLD,DSN=your.log.dataset
//ISPLIST  DD  DISP=OLD,DSN=your.list.dataset
//SYSTSPRT DD  SYSOUT=*
//SYSTSIN  DD  *
  PROFILE PREFIX(USERAA)
  ISPSTART CMD(CONVACTB)

The CONVACTB EXEC (written in REXX) is:

'ISPDTLC ISPMENU (DISK KEYLAPPL=ISR MSGSUPP CUAATTR CUASUPP PLEB MCOMMENT
    NOSTATS NOACTBAR PROFILE=your.gml.dataset(profile)' ;

This EXEC should be placed on your.exec.dataset.

Note:

If you are recompiling the English version of the panels, you must run ISPDTLC two times. The second run is to create the uppercase English version of the panel. The UPPERENG language keyword is specified to create the uppercase panel version. A different profile is also used with a different panel library defined to DTLPAN.
```
'ISPDTLC ISPMENU (DISK KEYLAPPL=ISR MSGSUPP CUAATTR CUASUPP PLEB MCOMMENT
    UPPERENG NOSTATS NOACTBAR PROFILE=your.gml.dataset(profileu)' ;
```
If you are recompiling DBCS versions of the panels, you must add the DBCS option to the command syntax. Japanese panels require the KANA option as well.
```
'ISPDTLC ISPFALL (DISK KEYLAPPL=ISR MSGSUPP CUAATTR CUASUPP PLEB MCOMMENT
    JAPANESE DBCS KANA NOSTATS NOACTBAR PROFILE=your.gml.dataset(profile)' ;
```

your.gml.dataset(profile) should include:

DTLGML: your.appl.gml.dataset
DTLGML: ISP.SISPGENU
DTLGML: ISP.SISPGMLI
DTLGML: ISP.SISPSAMP
DTLPAN: your.output.panel.dataset
DTLMSG: your.output.message.dataset
DTLLOG: your.log.dataset

your.gml.dataset(profileu) for creating uppercased English panels should include:

DTLGML: your.appl.gml.dataset
DTLGML: ISP.SISPGENU
DTLGML: ISP.SISPGMLI
DTLGML: ISP.SISPSAMP
DTLPAN: your.output.uppercase.panel.dataset
DTLMSG: your.output.message.dataset
DTLLOG: your.log.dataset

Your updated GML files should be stored in your.appl.gml.dataset. The converted files will be in your.output.panel.dataset or your.output.uppercase.panel.dataset, and the messages generated will be in your.log.dataset.

The log file will contain the results of the conversion processing. Most of the messages generated by ISPDTLC are related to ISPF extensions to the Dialog Tag Language and have been suppressed. The expected message number from compiling the panel source will appear in a comment near the top of the DTL source file for that panel source.