H The Facility Batch utility (FACBATCH) is used to submit a batch job for 3 each CMS library that meets the selection criteria.
' Software Version: FACBATCH Version X0.1
H Activates the FACBATCH utility. The FACBATCH utility is run from DCL. H Submits a batch job against each CMS library that meets the selection criteria.
,FACBATCH library-spec command-file
Command Qualifiers Defaults /AFTER None. /HOLD None. /[NO]LOG /NOLOG /OUTPUT_DIR /OUTPUT_DIR=sys$login /POST_JOBNAME None. /PREFIX_JOBNAME None. /PROCESS /PROCESS=flagfree /P4 None. /P5 None. /P6 None. /P7 None. /P8 None. /QUEUE /QUEUE=sys$batch
| LIB_SPEC: | library-spec |
| COMMAND_FILE: | command-file |
G The FACBATCH utility is used to submit a job to a batch queue for each E CMS library that meets the selection criteria. The job submitted for E each library will consist of a user written procedure that will have E specific information passed to it. The information will be passed to 4 the user written procedure via the P1-P8 parameters.
library-spec
G Specifies the CMS library that is to be acted on. This specification F can contain wildcards, but it must be a valid CMS library directory J specification (i.e. VMS$:[YELLOW_TEST.CMS]). An example of a wildcarded J specification would be: VMS$:[Y*.CMS]. This specification would process / all libraries that start with the letter "Y".command-file
I Specifies the name of the user written command procedure that is to be ? submitted for each library that meets the selection criteria.
/AFTER=time
D Requests that the job be held until after a specific time. If the ? specified time has already been passed, the job is processed G immediately.Time can be specified as either an absolute time or as a D combination of absolute and delta times. See the VMS DCL CONCEPTS < MANUAL for complete information on specifying time values./HOLD
B Controls whether or not the job is made available for immediate H processing. The /HOLD qualifier holds the job until it is released by @ the /NOHOLD qualifier or by the /RELEASE qualifier of the SET QUEUE/ENTRY command./[NO]LOG
A Specifies that the user wants to see messages from the utility 9 pertaining to the libraries being processed or skipped.OUTPUT_DIR=directory
I Specifies where the log files are to be put. The default is to put all the log files in SYS$LOGIN. '/POST_JOBNAME=character-string
H This qualifier is much like the /PREFIX_JOBNAME qualifer, except that I the character string entered for this qualifier is appended to the job name. )/PREFIX_JOBNAME=character-string
B Specifies the ascii character string that is to be place at the I beginning of the job name. By default the job name will be the name of 9 the CMS facility that is being process. In the case of D VMS$:[YELLOW_TEST.CMS], the job name would be "YELLOW_TEST". If a : prefix of "ABC_" is entered, then the job name would be "ABC_YELLOW_TEST".-/PROCESS=(attribute[,attribute,...])
I The PROCESS qualifier is used to define the selection criteria for the B libraries that are to be processed. Some libraries have special J attributes associated with them, VMSCMS$NO_PROPAGATE.FLAG is an example H of an attribute. This attribute indicates that this library is not to J have any code propagation performed within it. The process qualifier is D used to selectively process or skip libraries marked with certain 3 attributes. The list of acceptable attributes is:J
3- [NO]ALL - process all libraries no matter what attribute it may have;
- [NO]ARCHIVEDFACILITY - process all archived libraries :
- [NO]FLAGFREE - process libraries with not attributes=
- [NO]NOPROPAGATE - process libraries marked no propagate
/P4=text ··· /P8=text
H All the /Pn qualifiers accept alphanumeric strings. These strings can F be quoted strings containing spaces, or simpe one word strings. The G data accepted for each parameter qualifier is passed directly to the F procedure submitted. If a user enters /P4=TEST on the command line, J then the user would be able to do a "SHOW SYMBOL P4" command within the 0 procedure submitted and see the string "TEST"./QUEUE=queue-name
F Identifies the batch queue on which the job is entered. The default queue is SYS$BATCH.
| ` | Contents |