[Search for users] [Overall Top Noters] [List of all Conferences] [Download this site]

Conference koolit::vms_curriculum

Title:VMS Curriculum
Moderator:SUPER::MARSH
Created:Thu Nov 01 1990
Last Modified:Sun Aug 25 1996
Last Successful Update:Fri Jun 06 1997
Number of topics:185
Total number of notes:2026

24.0. "VMS FOR ADVANCED APPLICATION USERS - CHAPTER REV" by HARDY::REGNELL (Smile!--Payback is a MOTHER!) Tue Nov 27 1990 13:02

    
    WRITING MORE COMPLEX COMMAND PROCEDURES
    
T.RTitleUserPersonal
Name
DateLines
24.1draft ready for reviewHARDY::BUNNELLMon Dec 10 1990 08:564
    A draft of this module is available for review in:
    	super::es$review:[ra0294]ra0294_chap_5_profile.ps
    
    Hannah
24.2Reading, UK - first passUKEDU::SHONEKeith Shone @RKA 830-4074Thu Dec 13 1990 10:3352
    I found the flow of this chapter OK.
    My nits, typos and other observations are below.

    NOTE: These are my feelings etc. not of the UK as a whole.

    I comment on typos etc on instructor pages as well as customer pages.
    Instructors deserve to have unambiguous, correctly spelled and
    technically accurate information too! :-)
    
Page	Observation
----    -----------

1-4	Bullet 5: Typo: differnet -> different

1-5a	Penultimate line: Typo: interative -> interactive

1-7	I encourage those writing command procedures to 
	place each qualifier on a separate line thus:

	$ ACCOUNTING -
			/FULL -
			/TYPE=LOGFAIL-
			/SINCE=YESTERDAY
	$ DIRECTORY  -
			/MODIFIED -
			/SINCE=YESTERDAY -
		SYS$SYSROOT:[000000...]
	$ !

	It eases maintenance - unsure what it does for 
	performance :-)

1-17	No figure 1-1

1-27	Callouts 6 & 7: The space ahead of "Fred" in callout 6 is 
	not reproduced in callout 7 - there is no space at
	the end of the prompt either.

1-33a	Line 2: in the command -> in command

1-34	No Figure 1-2

	Example: Just a nit but good programming practice 
	suggests we shouldn't hard code constants like 0 but
	use symbolic constants instead

	e.g.:	$ Warning = 0
		  .    .    .
		  .    .    .
		$ IF $SEVERITY .EQ. Warning THEN GOSUB WARNMSG

	Improves readability at the expense of another symbol...