Free software BY Computer Sciences Corporation This software is furnished for free and may be used and copied as desired. This software or any other copies thereof may be provided or otherwise made available to any other person. No title to and ownership of the software is hereby transferred or allowed. The information in this software is subject to change without notice and should not be construed as a commitment by COMPUTER SCIENCES CORP. COMPUTER SCIENCES CORP. assumes no responsibility for the use or reliability of this software on any equipment whatsoever. Computer Sciences Corp. 200 Sparkman Drive Huntsville, AL 35805 (205)876-8293 Program: UPDATE Author: W. Lewis Harmon Date: 17-APR-1990 Description: Update is a useful program that will allow you to organize FORTRAN programs into a structured order. Update is especially useful when dealing with large FORTRAN programs. Update will also break-out all of the modules in the source code to individual files. Update allows you to insert, replace or extract routines in a FORTRAN source files using the various qualifiers listed below: /UPDATE - Requests that UPDATE modify the source file using the update file specified. It will either replace an existing routine or insert a new routine using the routines in the update file. This qualifier must be present to update the source file. UPDATE will prompt for an update file spec if one is not given. /EXTRACT=[(routine-name,routine-name...)] - Indicates that the specified routines are to be extracted from the source and placed into a new file. The extraction list is optional but update will prompt for routine names if none are present. Default output is of filename sourcefile-spec with a type of UPD. UPDATE with no qualifiers defaults to /EXTRACT. The /SPLIT qualifier can also be used. If /SPLIT is present, then UPDATER will put each extracted routine into a separate file whose name is routine-name.FOR. If /SPLIT is present, /OUTPUT has no effect. /OUTPUT=outputfile-spec - Specifies the file specification of the output file. The outputfile-spec is required with this qualifier. If the file type is omitted in the file spec, it defaults to type .UPD. If /OUTPUT is omitted the output file created is of name sourcefile-spec with a type of UPD. /SORT - Specifies that the source file is to be alphabetized by routine name. Default output is a higher version of the sourcefile-spec. /SPLIT - Indicates that ALL routines are to be extracted from the source and split into individual files. Each routine will be written to a file whose name is routine-name.FOR. The /OUTPUT qualifier has no effect. /STRIP - This qualifier instructs UPDATER to strip any characters located in columns 73-80. Only valid if used in conjunction with the /REMOVE qualifier. If this qualifier is not present, UPDATER assumes a record length of 80 characters when REMOVING trailing blanks. /REMOVE - This qualifier instructs UPDATER to strip trailing blanks from any characters located in columns 73-80 and then to strip off any trailing blanks from each record before writing to the output file. If this qualifier is not present, UPDATER assumes a record length of 80 characters ( if there are characters in 73-80, they are left on the record). /EXTEND - This qualifier instructs UPDATER that the files involved can contain FORTRAN extended records ( FORTRAN statements that are longer than 72 columns). These statements can be no longer than 132 columns. UPDATER will still strip off any trailing blanks from each record before writing to the output file. Program: ZAP Author: W. Lewis Harmon Date: 17-APR-1990 Description: Zap enables a user to delete a number of jobs in a queue with one command. GROUP/WORLD/SYSPRV/ etc. privilege is required to delete another users' job. Batch, printer, terminal, and generic queues are supported. Zap has the following format: $ZAP /QUE=que_name /USER=username [/PROCESS=process_name] [/CONFIRM] [/GENERIC_DELETE] ZAP allows the deletion of a number of jobs in a que with one simple command using the following qualifiers: /QUEUE = que_name - This qualifier specifies the queue from which the jobs will be deleted. /QUEUE is required. If not present, the user will be prompted for a queue name. Wildcards are permitted. /USERNAME= username - Specifies the name of the user under which the jobs were submitted (ie. the person who submitted the jobs). /USERNAME is required. If not present, the user will be prompted for a username. /PROCESS_NAME = process_name - Specifies the name of the jobs to be deleted. This qualifier can act as a wildcard. See EXAMPLES for details. If /PROCESS_NAME qualifier is omitted all entries will be deleted that match the queuename and username input values. /JOB_NAME = process_name - Specifies the name of the jobs to be deleted. This qualifier can act as a wildcard. See EXAMPLES for details. If /JOB_NAME qualifier is omitted all entries will be deleted that match the queuename and username input values. /JOB_NAME and /PROCESS_NAME are synonymous. /CONFIRM - Controls whether a request is issued before each individual DELETE operation to confirm that the operation should be performed on those jobs matching the specified username and queue. /GENERIC_DELETE - Controls whether ZAP will automatically search the target execution queues into which a generic queue feeds. If the queue name specified is not a generic queue, /GENERIC_DELETE will have no effect. If /GENERIC_DELETE is not present, then only the queues specified will be searched. Default is /NOGENERIC_DELETE.