Executing and deleting commands with FILEMGMT

From m204wiki
Revision as of 04:20, 10 May 2014 by DmeWiccan (talk | contribs) (Automatically generated page update)
Jump to navigation Jump to search

Executing commands

Commands are executed on the appropriate commands screen.

To invoke the Execute Commands screen:

  1. Issue the COMmands command (or press F6) from a screen that supports the command.
  2. 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:

  • 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)

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 OUTxxxx file. The OUTxxxx 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
  1. Record Name List screen
  2. Record Definition screen
  3. Field Definition screen, if the file has no records defined
  4. File Recreate screen, if the field is sorted, hashed, or has record security, and no record has been explicitly defined
  5. File Copy screen, if records are selected for copying
  6. File Copy screen, if no record has been defined to the file
  7. Record Copy screen
  8. File Size Definition screen, if the file is to be recreated
  1. Status is *REC DEFN REQD; cannot be executed until the record is defined.
  2. Defines the record.
  3. Status is *REC DEFN REQD; cannot be executed until the record is defined.
  4. Defines the record.
  5. Defines the record.
  6. Status is *REC DEFN REQD; cannot be executed until the record is defined.
  7. Defines the record.
  8. 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:

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