Executing and deleting commands with FILEMGMT

Executing commands

Commands are executed on the appropriate commands screen.

To invoke the Execute Commands screen:

Issue the COMmands command (or press F6) from a screen that supports the command.
Select the commands you want to execute and press F6.

Note: Before you execute commands in Active mode that were previously executed in Inactive mode, run DDGEN against the file. Running DDGEN ensures that the dictionary file definition reflects the current status of the Model 204 file.

Execute Commands screen

Press the F6 (COMmands) key from any screen that supports the command. FILEMGMT displays the Execute Commands screen:

If you entered a file name on the primary screen, only the commands staged for that file are displayed.
If you did not enter a file name on the primary screen, the commands for all the files staged under your user ID are displayed.

The following Execute Commands screen shows all the files staged under a user ID.

FILEMGMT Execute Commands Line 1 of 8 REPORT Use: OUTFILE ACTIVE _ Immediate _ Delayed INACTIVE _ Use: ________ X ProcFile: FMOUTPUT Password: _ Filename: ABC DECREASE 03/31/2005 _ Filename: ABC INCREASE 03/31/2005 Password: Inactive _ Record: ABC REDEFINE 03/31/2005 _ Field: EMPLOYEE FIRST NAME REDEFINE 03/31/2005 _ Field: EMPLOYEE ID REDEFINE 03/31/2005 _ Field: EMPLOYEE INITIAL REDEFINE 03/31/2005 _ Field: EMPLOYEE LAST NAME REDEFINE 03/31/2005 ===> 1=HELp 2= 3=QUIt 4= 5=REPort 6=EXEcute 7= 8= 9= 10= 11=DELcmds 12=

FILEMGMT displays the names of files and their records, field groups, and fields. For each item, FILEMGMT displays the current or most recently executed command. To the right of the command, FILEMGMT displays the command status — for example, whether the command is pending, was executed successfully, or could not be executed because of an error condition or privilege violation. All the items that have been selected for execution at least once display a status. To the right of the status, FILEMGMT displays the date the command was requested.

FILEMGMT prompts you only for items that are currently staged by displaying an underscore character (_) in the prefix area to the left of the item name.

If a requested operation affects a set of records, field groups, or fields (for example, a file creation or record definition), FILEMGMT displays a prefix prompt only for the highest order of entity type. For example, file creation is a single operation, affecting the file and all of its records, field groups, and fields. Typing X in the file prefix area and pressing F6 confirms the file creation and automatically submits for execution all the Model 204 commands constructed for this file and its entries.

Execution options

The dictionary administrator determines the default execution option and the available options. Execution options determine how and when FILEMGMT executes the commands on the Execute Commands screen.

If your system supports more than one mode, you can override the default by specifying the option you want on the ACTIVE or INACTIVE line of the Execute Commands screen. Your choice affects only the items you select for the current session. The default option is restored for subsequent sessions.

FILEMGMT provides the following options:

Option	Function
Active Immediate	Commands for selected items are executed immediately after FILEMGMT verifies that you have the necessary privileges to execute the commands.
Active Delayed	Commands for selected items are flagged as pending after FILEMGMT verifies that you have the necessary privileges to execute the commands. FILEMGMT executes the commands at a later time in batch mode. Refer to the appropriate section of the Rocket Model 204 Installation Guide for your operating system for more information.
Inactive USE File	Commands for selected items are written to a `Model 204` directed output (USE) file. Your run must contain one of these print statements: OUT`xxxx` file DD statement in the JCL option (z/OS and z/VSE) `DEFINE PRINTER` statement in the `Model 204` CCAIN data stream (z/VM) If no name is specified, FILEMGMT uses the default file, `OUTFILE`. If `OUTFILE` is used, it must be defined with the option `DISP=MOD`.
Inactive Procedure File	Commands for selected items are written to a specified procedure file. The procedure file name has the format: FIM.acct.date.time Where: `acct` is your login account name. `date` is the current date (`MMDDYY`). `time` is the current time (`HHMMSS`).

Follow these guidelines when determining execution options:

If you select the ACTIVE option, FILEMGMT checks all necessary passwords and privileges. These must be correct before FILEMGMT actually executes the command. If your login account password or the file password is invalid for a particular command, FILEMGMT reports an error condition on the line containing the file name.
If the default is INACTIVE, and both USE and procedure files are available, the two options have Xs in the prefix area. Delete one of the Xs before you execute commands in the INACTIVE mode.
INACTIVE option does not generate passwords for OPEN statements.
INACTIVE option is required if you are recreating or copying a file from an earlier Model 204 release and choose to retain the file format of the earlier release.

The Execute Commands screen displays all the execution options supported by your system, and lets you change (and refine) the option you selected on the File Definition - Organization screen. The option you select on the Execute Commands screen applies to all the commands you select from the screen before you press the F6 (EXEcute) key.

FILEMGMT displays or prompts you for the following information:

Prompt Response

REPORT Use

Type the name of a directed output (USE) file to which FILEMGMT is to write a printable report. The report has the same format as the Execute Commands screen, except that the REPORT line shows the user account name and the current date and time.

If you select this option, your run must contain one of these print statements:

OUTxxxx file DD statement in the JCL option (z/OS and z/VSE)
DEFINE PRINTER statement in the Model 204 CCAIN data stream (z/VM)

Note: Of the four command options described below and in the preceding Execution Options section, the screen prompts only for those that were selected by the DBA on the Dictionary Administration File Management Facility screen.

ACTIVE Commands can be executed in immediate or delayed mode.

Immediate Commands are executed as soon as you issue the EXEcute command on the Execute Commands screen and FILEMGMT confirms your privileges. FILEMGMT displays X if this is the default for your system. You can type X to select this option if no X is displayed.

Delayed Commands are ready for execution. They are assigned a status of pending and can be subsequently executed in batch mode. FILEMGMT displays X if this is the default for your system. You can type X to select this option if no X is displayed.

INACTIVE Commands can be written to a Model 204 directed output (USE) file or stored in a procedure.

Use Commands are written to the USE file specified to the right of the Use prompt. The necessary print statements are the same as for the REPORT Use prompt. Select this option by typing X to the left of the prompt.

ProcFile Commands are written to the procedure file specified to the right of the ProcFile prompt. The format for the procedure file name is described in the Execution options section. Select this option by typing X to the left of the prompt.

Password If you selected the ProcFile option, enter the password (if any) associated with the procedure file. Type a valid password for the file (1-10 characters containing no spaces, commas, or colons).

Filename

FILEMGMT displays the name of the file that you entered on the primary screen, or displays the names of all files staged under your user ID.

If the file is currently staged (for example, for a file creation), you can select the file by typing X in the prefix area to the left of the file name. The absence of a prefix prompt means that the file is no longer staged for a command.

FILEMGMT displays on the same line as the file name:

FILEMGMT command requested for the file.
See Commands generated from FILEMGMT for a listing of the commands.
Status of the command.
A status preceded by an asterisk (*) indicates that the command cannot be executed until you provide FILEMGMT with more information. Any other status indicator shows the results of the most recent execution attempt. A blank status indicates the command was never selected for execution.

Status	Meaning
CmdGen'd	Commands were generated in INACTIVE mode.
EXEC PENDING	You executed a command in ACTIVE Immediate mode and were restarted or the system crashed before the command was completed. To recover, run `DDGEN` to ensure your dictionary is synchronized, and reissue the command.
FilePriv	The operation failed because you have insufficient file privileges.
Fistat	The file is physically or logically inconsistent. (See Restarts.)
M204.nnnn	The operation failed because of an incorrect password or some other error condition. `nnnn` indicates the `Model 204` error message number.
OpenError	FILEMGMT was unable to open the file.
Pending	The command was selected but is not yet executed. Pending status occurs in ACTIVE DELAYED mode.
PrevExecuted	The command for a field was previously executed as part of a different record or field group.
*REC DEFN REQD	The record must be completely defined before the command for the record can be executed.
SizeError	The available space is insufficient for an `INCREASE` command.
*SIZING REQD	The file was staged for `CREATE`, but sizing information was not provided.
Successful	The command was executed successfully.
UserPriv	You attempted to execute a `CREATE` command and do not have superuser privileges. The date (MM/DD/YY) the command was requested. If the command status is the result of an error or incomplete execution, an asterisk appears in front of the date.

Password If required, type a valid password for the file (1-10 characters containing no spaces, commas, or colons). FILEMGMT indicates on the same line whether the file is active or inactive. Active or Inactive indicates the mode in which the commands for this file were last executed. If you re-execute the commands, you can change the execution mode by selecting another option at the top area of the screen. For more information, see the discussion of execution options, above.

Record FILEMGMT displays the name of a record, Field group field group, or field for which a command Field has been generated. The command, status, and execution date are displayed on the same line. For more information about the line, see the Filename prompt, above.

Execute Commands screen commands

To issue a command, press a PF key or type a command name at the prompt (===>) and press Enter.

Key	Command	Meaning
F1	HELp	Displays Help text for the Execute Commands screen.
F3	QUIt	Exits from the Execute Commands screen and returns to the primary screen. Commands that were executed by pressing F6 cannot be backed out by using QUIt.
F5	REPort	Writes a report of the commands to the OUT`xxxx` file. The OUT`xxxx` file is the file specified in response to the REPORT Use prompt.
F6	EXEcute	Executes, sets as pending, or writes to a file for later execution the commands that you selected on the Execute Commands screen. The execution mode depends on the ACTIVE or INACTIVE selection. The Execute Commands screen is redisplayed after you press F6 to show the updated status of all commands.
F7	BACkward	Scrolls backward one screen. If you type `BAC` at the prompt (===>), followed by a number, FILEMGMT scrolls backward the specified number of lines.
F8	FORward	Scrolls forward one screen. If you type `FOR` at the prompt (===>), followed by a number, FILEMGMT scrolls forward the specified number of lines.
F11	DELcmds	Takes you to the Delete Commands screen.

Commands generated from FILEMGMT

The following tables list the commands that FILEMGMT generates for each entity, the screens from which the commands are generated, and the actions that the commands perform.

File commands

Command	Generated from...	Action
CREATE	File Definition screens File Size Definition screen File Copy screen	Status is SIZING REQD; command cannot be executed until sizing is performed. Creates a physical file and links a file definition to the file. Status is SIZING REQD; command cannot be executed until sizing is performed. Sizing is required in order to link a data set name to the physical file.
RECREATE	File Definition screens File Size Definition screen	Recreates the physical file and links a file definition to the file. Recreates the physical file and links a file definition to the file.
INCREASE	File Size Definition screen Increase/Decrease screen	Resets Table B and Table D sizes. Resets Table B and Table D sizes.
DECREASE	File Size Definition screen Increase/Decrease screen	Resets Table B and Table D sizes Resets Table B and Table D sizes.
INC DSN	Increase/Decrease screen	Adds data sets for the file.
RESET	File Size Definition screen File Parameter Reset screen	Resets file sizing parameters for an existing file. Resets file organization and security parameters.
SECURE	Primary screen	Secures `Model 204` password.
DESECURE	Primary screen	Desecures `Model 204` password.
INITIALIZE	File Initialize screen	Initializes the file.
DELETE	File Delete screen	Deletes file references from the dictionary.

Field commands

Command	Generated from...	Action
DEFINE	Field Name List screen Field Attributes screen Field Copy screen, if fields are selected for copying Record Copy screen File Size Definition screen, if the file is to be recreated	Defines the field with default attributes. Defines the field. Defines the field. Defines the field. Defines the field.
REDEFINE	Field Attributes screen	Redefines the field.
DELETE	Field Attributes screen	Deletes the field from `Model 204` and the dictionary.
RENAME	Field Attributes screen	Renames the field.
R/R	Field Attributes screen	Redefines and renames the field.

Record commands

Command	Generated from...	Action
DEFINE	Record Name List screen Record Definition screen Field Definition screen, if the file has no records defined File Recreate screen, if the field is sorted, hashed, or has record security, and no record has been explicitly defined File Copy screen, if records are selected for copying File Copy screen, if no record has been defined to the file Record Copy screen File Size Definition screen, if the file is to be recreated	Status is REC DEFN REQD; cannot be executed until the record is defined. Defines the record. Status is REC DEFN REQD; cannot be executed until the record is defined. Defines the record. Defines the record. Status is *REC DEFN REQD; cannot be executed until the record is defined. Defines the record. Defines the record.
REDEFINE	Record Definition screen	Redefines the record.
DELETE	Record Definition screen	Deletes the record definition from the dictionary.
RENAME	Record Definition screen	Renames the record.
R/R	Record Definition screen	Redefines and renames the record.

Field group commands

Command	Generated from...	Action
DEFINE	Field Group Definition screen File Size Definition screen, if the file is to be recreated	Defines the field group. Defines the field group.
REDEFINE	Field Group Definition screen	Redefines the field group.
DELETE	Field Group List screen	Deletes the field group definition from the dictionary.
RENAME	Field Group List screen	Renames the field group.
R/R	Field Group Definition screen	Redefines and renames the field group.

Deleting commands

To delete commands:

Issue the DELcmds command (or press F9) from the primary screen.
Select the commands you want to delete, and press F6.