Additional information about the panel input fields follows:
- Member Name
- If the member name is left blank or entered as a member pattern,
a member list is displayed. You can select one or more members to
be converted from the member list.
- DTL Source data set - n
- You can specify up to three additional DTL source libraries on
the invocation panel. See Additional DTL source files for
more information.
- Panel data set
- If no panel output is required, you can specify NULLFILE or DUMMY
in place of the panel output file name.
- Message data set
- if no message output is required, you can specify NULLFILE or
DUMMY in place of the message output file name.
- Log data set
- The log file name is optional. If it is not specified and the
messages are to be written to disk, log output is written to the ISPF
log file. If the log file is a PDS, a member name must be provided.
You may specify an asterisk to tell the conversion utility to use
the input GML source file member name as the output log file member
name. However, if the input GML member is in the special DTLLST file
list format (discussed in Conversion utility general information)
then a separate log file member is created for each source member
converted.
- List data set
- The list file name is optional. If it is not specified, list output
is written to the ISPF list file. If the list file is a PDS, a member
name must be provided. You may specify an asterisk to tell the conversion
utility to use the input DTL source file member name as the output
list file member name. However, if the input GML member is in the
special DTLLST file list format (discussed in Conversion utility general information) then a separate list file member
is created for each source member converted.
- SCRIPT data set
- The SCRIPT file name is optional. If a SCRIPT output file is requested,
it must be a PDS file. Member names for the SCRIPT file are the same
as the panel file.
- Tables data set
- The Tables file name is optional. If a tables file name is provided,
it must be an 80-byte fixed-length PDS file. When a tables file is
provided, keylist and command table output is placed in this file.
- Keylist Application ID
- The optional Keylist Application ID is used when the APPLID attribute
is omitted on the HELP, PANEL, KEYL, or CMDTBL tags. This is the equivalent
of the ID provided by the KEYAPPL option described in Conversion utility syntax.
- Conversion status message interval
- When the conversion utility is running in interactive mode and
the "Place ISPDTLC Messages in log file" option is selected and
the "List Source Convert Messages" option is deselected, a status
message containing the name of the current DTL source file member
being converted is displayed in the long message area. This message
provides a conversion status when you are converting multiple members
using the DTLLST format member option. See Converting multiple panels for more information about the
DTLLST syntax. The default message interval value is 1 which displays
the message for each member processed. This value can be set to 0
to suppress the message (which is useful when running in GUI mode)
or to a value that refreshes the message after a specified number
of members have been converted.
- DISPLAY(W) option check interval
-
When the conversion utility is running in test mode and either
the DISPLAY or DISPLAYW option is selected, the converted panel is
displayed for visual verification. A panel is displayed periodically
after the converted panel has been displayed to enable the user to
control the DISPLAY or DISPLAYW function.
The "DISPLAY(W)
option check interval" option on the invocation panel controls
the frequency of the DISPLAY or DISPLAYW control function panel appearance.
The default value is 1, so that the control function panel is displayed
after each converted panel display. The control panel enables you
to continue using the same display interval, cancel the DISPLAY or
DISPLAYW option, or change the control panel display interval.
All files specified must be preallocated.
When the log or list file is a PDS file and the member name is
not an asterisk, all of the conversion results are placed in the specified
member. If the file name or member name is changed, the pending log
or list information is written to the previously specified member
and a new log or list is generated beginning with the next conversion.
When the conversion utility ends, pending log and list files are written.
The log and list files can be either fixed length or variable length,
with or without printer control. When the file is allocated with print
control specified, the conversion utility output begins in column
2; column 1 is blank. When print control is not specified, the conversion
utility output begins in column 1.