VA FileMan V. 22.0 Programmer Manual Banner


 

Main Chapter Getting Started Manual Advanced User Manual

ScreenMan Forms


ScreenMan Menu Options

The ScreenMan menu options are found on a submenu of the Other Options menu:

Select OPTION: OTHER OPTIONS
Select OTHER OPTION: SCREENMAN
Select SCREENMAN OPTION: ?
 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: 


This section describes the four ScreenMan options.

Edit/Create a Form

The first option, Edit/Create a Form, invokes the Form Editor, the screen-oriented utility for editing and building ScreenMan forms. The Form Editor is described in detail in the "ScreenMan Form Editor" chapter.

Run a Form

Instead of setting up input variables and making a call to ^DDS, you can use the second option on the ScreenMan menu to run a form shown below:

 
Select SCREENMAN OPTION: RUN A FORM 

MODIFY SCREEN TEMPLATE FOR WHAT FILE: ZZEZ SCREENDOC 


Select FORM: ZZEZ DOC  ZZEZ DOC 

Enter number of first page: 1//   Select ZZEZ SCREENDOC NAME: TURING,ALAN
M.          AL

You are asked to select a file, a form, an initial page, and a record. This option cannot run a form used to a edit a subfile directly.

Delete a Form

You can use the third option on the ScreenMan menu, shown below, to delete a form from the Form file, and any or all of the blocks used on that form from the BLOCK file.

 
Select SCREENMAN OPTION: DELETE A FORM   

MODIFY SCREEN TEMPLATE FOR WHAT FILE: ZZEZ SCREENDOC


Select FORM to delete: ZZTEST DOC  ZZTEST DOC
                         #55      02/16/91  User #14    File #16500


Once you've selected a file and form to delete, a short report is printed that lists all blocks used on the form, as illustrated below:

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


The first column lists the internal entry numbers of the blocks used on the form, and the second column lists the names of the blocks. The last two columns indicate whether the blocks are used on other forms and whether you can delete those blocks from the BLOCK file. Only those blocks that are not used on other forms can be deleted.

You are then asked whether you want to delete the blocks used on the form from the BLOCK file.

Delete all deletable blocks used on form ZZTEST DOC
from the BLOCK file (Y/N)? YES// ?

  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//


If you answer "NO," the form will be deleted from the Form file, but none of the blocks used on the form will be deleted. Note that 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 option described below.

If you answer "YES," you are asked whether you want to delete those blocks without confirmation.

Delete blocks without prompting (Y/N)? NO// ?

  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 will be deleted. If you answer "NO," you will be prompted before any block is deleted. This gives you a chance to delete only specific blocks.

Continue (Y/N)? NO// YES

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!

Purge Unused Blocks

You can use the fourth option on the ScreenMan menu to delete any or all of the unused blocks from the BLOCK file that are associated with a specific file.

Select OPTION: OTHER OPTIONS  
Select OTHER OPTION: SCREENMAN  
Select SCREENMAN OPTION: PURGE UNUSED BLOCKS   

PURGE UNUSED BLOCKS FROM WHAT FILE: ZZEZ SCREENDOC


Once you've selected a file, a short report is printed that lists the blocks that aren't used 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:

    Delete all unused blocks without prompting (Y/N)? NO// 

If you answer "YES," all unused block are deleted. If you answer "NO," you will be prompted before any block is deleted. This gives you a chance to delete only specific blocks.

Continue (Y/N)? NO// YES 

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: March 10, 2007