Documentation Utilities › System Documentation › Print Key Conversion › Print Key Conversion Steps

Print Key Conversion Steps

Using the Convert Print utility is a three-step process:

1. You enter "print conversion mode" by means of the Toolkit command Start Print Conversion (YSTRCVTPRT). The command allows you to nominate up to four print files for conversion; for example:

   YSTRCVTPRT PRTF(QSYSPRT YPRTKEY$)

   Any output to the nominated files will be trapped for conversion. Starting print key conversion mode invokes the i OS command entry program QCMD, thus allowing you to call the commands or programs whose displays you wish to document.

2. You create the print output for the displays that you want illustrated. This can be done by pressing the PRINT key while displaying any screen that is to be illustrated: provided the print file used by the print key is one of the nominated print files.
3. You convert the print output into a text source member by means of the Toolkit command Convert Print (YCVTPRT), for example:

   YCVTPRT PRTF(*ALL) SPLNBR(*ALL) FILE(QTXTSRC) MBR(FRED)

This command would convert all print key output to a spool file member FRED in file QTXTSRC.

The following commands would produce the illustration shown next:

YSTRCVTPRT /* Start print conversion. */

STRPGMMNU /* Call programmer’s menu. */

Type in (for example) "YGO *Y" and press PRINT key.....

YCVTPRT                /* Convert print output to source. */

You may control the characters used to form the frame by using the Toolkit Edit Design Defaults command (YEDTDSNDFT).