| Contents: | Main | Chapter | See Also: | Getting Started Manual | Advanced User Manual | |||
The ScreenMan [DDS SCREEN MENU] menu, which is locked with the XUSCREENMAN security key, is found on a submenu of the Other Options [DIOTHER] menu, as shown in Figure 229:
Figure 229: ScreenMan Forms—ScreenMan Menu Options
Select VA FileMan Option: OTHER OPTIONS <Enter> Select Other Options Option: SCREENMAN <Enter> Select ScreenMan Option: ? <Enter> Answer with SCREENMAN OPTION NUMBER, or NAME Choose from: 1 EDIT/CREATE A FORM 2 RUN A FORM 3 DELETE A FORM 4 PURGE UNUSED BLOCKS Select SCREENMAN OPTION:
The following sections describe these four ScreenMan options.
Use the Edit/Create a Form [DDS EDIT/CREATE A FORM] option on the ScreenMan [DDS SCREEN MENU] menu to invoke the Form Editor, the screen-oriented utility for editing and building ScreenMan forms.
REF: The Form Editor is described in detail in the "ScreenMan Form Editor" section.
Instead of setting up input variables and making a call to ^DDS, you can use the Run A Form [DDS RUN A FORM] option on the ScreenMan [DDS SCREEN MENU] menu to run a form, as shown in Figure 230:
Figure 230: ScreenMan Forms—Run a Form Option
Select SCREENMAN OPTION: RUN A FORM <Enter> MODIFY SCREEN TEMPLATE FOR WHAT FILE: ZZEZ SCREENDOC <Enter> Select FORM: ZZEZ DOC <Enter> ZZEZ DOC Enter number of first page: 1// <Enter> Select ZZEZ SCREENDOC NAME: FMUSER,ONE <Enter> M. FM
You are asked to select a:
The Run A Form [DDS RUN A FORM] option cannot run a form used to edit a subfile directly.
You can use the Delete A Form [DDS DELETE A FORM] option on the ScreenMan [DDS SCREEN MENU] menu to delete a form from the FORM (#.403) file, and any or all blocks used on that form from the BLOCK (#.404) file.
Figure 231: ScreenMan Forms—Delete a Form Option
Select SCREENMAN OPTION: DELETE A FORM <Enter>
MODIFY SCREEN TEMPLATE FOR WHAT FILE: ZZEZ SCREENDOC <Enter>
Select FORM to delete: ZZTEST DOC <Enter> ZZTEST DOC
#55 02/16/91 User #14 File #16500
Once you have selected a file and form to delete, a short report is printed that lists all blocks used on the form, as illustrated in Figure 232:
Figure 232: ScreenMan Forms—Delete a Form Option: Report of All Blocks Used on the Form
BLOCKS USED ON FORM "ZZTEST DOC" (IEN #55) Internal Used on Entry Number Block Name Other Forms? Deletable? ------------ ---------- ------------ ---------- 178 ZZTEST DOC HDR1 NO YES 179 ZZTEST DOC1 NO YES 180 ZZTEST DOC2 NO YES 181 ZZTEST DOC3 NO YES 182 ZZTEST DOC HDR3 NO YES
Delete a Form Data (Figure 232):
You are then asked whether you want to delete the blocks used on the form from the BLOCK (#.404) file, as shown in Figure 233:
Figure 233: ScreenMan Forms—Delete a Form Option: Delete Blocks
Delete all deletable blocks used on form ZZTEST DOC
from the BLOCK file (Y/N)? YES// ? <Enter>
Enter 'Y' to delete blocks used on form
ZZTEST DOC from the BLOCK file.
(Only blocks not used on other forms can be deleted.)
Enter 'N' to delete the form but not the blocks.
Delete all deletable blocks used on form ZZTEST DOC
from the BLOCK file (Y/N)? YES// <Enter>
If you answer NO, the form is deleted from the FORM (#.403) file, but none of the blocks used on the form are deleted. If you choose not to delete a block, and that block is not used on any form, the only way to delete the block is to run the Purge Unused Blocks [DDS PURGE UNUSED BLOCKS] option.
If you answer YES, you are asked whether you want to delete those blocks without confirmation.
Figure 234: ScreenMan Forms—Delete a Form Option: Delete Blocks with or without Confirmation
Delete blocks without prompting (Y/N)? NO// ? <Enter>
Enter 'Y' to delete blocks from the BLOCK file
without confirmation.
Enter 'N' to confirm each delete.
Delete blocks without prompting (Y/N)? NO//
If you answer YES, all blocks used on the form that are not used on any form are deleted.
If you answer NO, you are prompted before any block is deleted. This gives you a chance to delete only specific blocks.
Figure 235: ScreenMan Forms—Delete a Form Option: Deleting Blocks without Confirmation
Continue (Y/N)? NO// YES <Enter> Deleting form ZZTEST DOC (IEN #55) ... ZZTEST DOC HDR1 Delete (Y/N)? NO// YES ZZTEST DOC1 Delete (Y/N)? NO// YES ZZTEST DOC2 Delete (Y/N)? NO// YES ZZTEST DOC3 Delete (Y/N)? NO// YES ZZTEST DOC HDR3 Delete (Y/N)? NO// YES DONE!
You can use the Purge Unused Blocks [DDS PURGE UNUSED BLOCKS] option on the ScreenMan [DDS SCREEN MENU] menu to delete any or all unused blocks from the BLOCK (#.404) file that are associated with a specific file.
Figure 236: ScreenMan Forms—Purge Unused Blocks Option
Select OPTION: OTHER OPTIONS <Enter> Select OTHER OPTION: SCREENMAN <Enter> Select SCREENMAN OPTION: PURGE UNUSED BLOCKS <Enter> PURGE UNUSED BLOCKS FROM WHAT FILE: ZZEZ SCREENDOC <Enter>
Once you have selected a file, a short report is printed that lists the blocks that are not used on any forms:
Figure 237: ScreenMan Forms—Purge Unused Blocks Option: Report of Unused Blocks on any Forms
UNUSED BLOCKS ASSOCIATED WITH FILE ZZEZ SCREENDOC (#16500) Internal Entry Number Block Name ------------ ---------- 72 ZZZEE EDIT3 178 ZZTEST DOC1 179 ZZTEST DOC2 180 ZZTEST DOC3 181 ZZTEST DOC HDR3
You are then asked whether to delete the blocks without confirmation:
Figure 238: ScreenMan Forms—Purge Unused Blocks Option: Delete Blocks with or without Confirmation
Delete all unused blocks without prompting (Y/N)? NO// <Enter>
If you answer YES, all unused blocks are deleted.
If you answer NO, you are prompted before any block is deleted. This gives you a chance to delete only specific blocks.
Figure 239: ScreenMan Forms—Purge Unused Blocks Option: Delete Blocks without Confirmation
Continue (Y/N)? NO// YES <Enter> ZZZEE EDIT3 Delete (Y/N)? NO// YES ZZTEST DOC1 Delete (Y/N)? NO// YES ZZTEST DOC2 Delete (Y/N)? NO// YES ZZTEST DOC3 Delete (Y/N)? NO// YES ZZTEST DOC HDR3 Delete (Y/N)? NO// YES DONE!
Reviewed/Updated: May 2026