File maintenance utility commands

The section covers the following topics:

Command format

The basic format of a CICS BAC file maintenance utility input command is as follows:

COMMAND NAME Parameter1(value1),Parameter2(value2),...,Parametern(valuen)

The rules for coding commands are as follows:

The above rules are explained in further detail, as appropriate, in the description of each command. The commands provided by CICS BAC are:

Syntax notation for file maintenance utility commands

The syntax for each file maintenance utility input command is presented in the form of a diagram, commonly referred to as a railroad diagram. The syntax, which is interpreted by following the dashed lines and arrows from left to right, and top to bottom, is described in the following table.

Symbol Meaning
>>-----A-----><
A required parameter that you must provide.
>>-----A-----><  
     +-B-+	     
     +-C-+	
A set of alternative parameters, one of which you must provide
     +-A-+	     
 >>----------->< 
     +-B-+	     
     +-C-+	
A set of optional parameters, where A is the default. You may provide only one of these options.
>>----------->< 
     +-A-+      
     +-B-+
A set of optional parameters. None are required, and there is no default. You may provide only one of these.
>>-- Name +-><

Name:
>>--A----B---->
Denotes a named section provided elsewhere in the command syntax.
Punctuation and upper case characters
Code exactly as documented.
Lowercase, italicized characters
Requires you to code your own text to replace these fields.
Generic character usage

The command syntax for the file maintenance utility supports the use of a generic character, which you can use in the following commands:

The generic character is an * (asterisk), where an * matches none or one or more characters. Thus * by itself means all names, so to remove all the files from an application group, use REMOVEFILES(*). Operand ab* matches anything beginning with the characters ab, such as abc, abcde, and so on.

Omitting parameters from commands

Except for the REPLACE parameter on an ADD resource command and the ADDIFNEW parameter on an UPDATE resource command, none of the other parameters have defaults. If you omit a parameter from an ADD resource or UPDATE resource command, the file maintenance utility takes the value for a missing parameter as follows:

The following sections describe all the commands that you can use to maintain a CICS BAC VSAM control file using the file maintenance utility in a batch job.