Base Configuration Define or Alter

The DEFINE and ALTER options of the Configuration Application Selection panel are quite similar and are discussed together. They both use as input an SFS file ID specified in the CONFIGURATION FN FT and the FM/DIRID fields located at the top of the panel. DEFINE and ALTER cannot be invoked on the 'ACTIVE' configuration. DEFINE establishes the base configuration information associated with a source configuration, and ALTER modifies existing base configuration information.

When defining the base configuration information, the Source Configuration File Creation Request Confirmation panel shown in Figure 1 is displayed when a file does not exist. After inputting the requested information, the Base Configuration Define panel shown in Figure 2 is displayed. When you ALTER a source configuration, the Base Configuration Alter panel shown in Figure 2is displayed.
Figure 1. Source Configuration File Creation Request Confirmation Panel
DGTDIUX1  SOURCE CONFIGURATION FILE CREATION REQUEST CONFIRMATION PANEL
 COMMAND ===>

  TO CONFIRM CREATION OF:

   SOURCE CONFIGURATION FN FT:
     FM:   DIRID:



  SPECIFY THE FOLLOWING:
      PERFORM CREATION        ===> N           (Y or N)










 USE ENTER TO PERFORM CREATION;
 USE HELP COMMAND FOR HELP; USE END COMMAND TO EXIT.

The Source Configuration File Creation Request Confirmation panel can be displayed from the Configuration Application Selection, Management Class Application Selection, or Translate ACS Routine panels. The Source Configuration File Creation Request Confirmation panel indicates the file ID of the file containing the source configuration to be created. The panel also prompts the storage administrator to either proceed with the creation of the file (by entering Y in the PERFORM CREATION field), or to not proceed (by leaving the N in the PERFORM CREATION field).

The following are descriptions of the panel fields displayed in the Source Configuration File Creation Request Confirmation panel:
  • SOURCE CONFIGURATION FN FT: This field identifies the file name and file type of the source configuration file.
  • FM: If a file mode is specified in the FM/DIRID field on the previous panel, it is displayed in this field.
  • DIRID: The fully qualified directory ID of the source configuration.
  • PERFORM CREATION: This field is set to N when the panel is displayed. The storage administrator must specifically change this to Y and press ENTER in order to create the file. The valid values are:
    • Y—indicating that the source configuration file is created
    • N—indicating that the source configuration file is not created
If you indicate to create a file, the Base Configuration Define panel is displayed. The Base Configuration DEFINE or ALTER panels are identical in appearance except for the title and instruction line which becomes DEFINE or ALTER depending on the desired mode. For example:
  • When in DEFINE mode, the title is Base Configuration Define Panel and the instruction line is To Define The Base Configuration, Specify
  • When in ALTER mode, the title is Base Configuration Alter Panel and the instruction line is To Alter The Base Configuration, Specify

    The panels are shown in Figure 2.

Figure 2. Base Configuration Define or Alter Panels
hcpt4f06

The Base Configuration Define panel is primed with the default attributes values, and the Base Configuration Alter panel is primed with the attribute values previously saved with the base configuration information.

The following describes the panel fields displayed in both the Base Configuration Define and Alter panels:
  • CONFIGURATION FN FT:; This field identifies the file name and file type of source configuration file.
  • FM: If a file mode is specified in the FM/DIRID field on the previous panel, it is displayed in this field.
  • DIRID: The fully qualified directory ID of the source configuration is displayed here.
  • CONFIGURATION STATUS: This field is either VALID or INVALID depending on whether the configuration can be activated. Refer to Valid and Invalid Configurations for the criteria for a valid configuration. If a configuration is invalid, use option 4 on the Configuration Application Selection panel to obtain a report of why the validation has failed.
    Note: If you are defining a base configuration the status is invalid. If the base configuration is the only thing missing, the configuration is valid after the base is defined.
  • DESCRIPTION: If you want to perform a DEFINE operation, this field is blank, and you can type in up to 120 characters of description information. If you want to perform an ALTER operation, you can edit this field. This is not a required field, but it is recommended that you provide some descriptive information here.
  • DEFAULT MANAGEMENT CLASS NAME: This field contains the default management class name. If a file has the NULL management class and the file’s parent directory has the NULL management class, the system default management class is used when processing that file.
  • INVOKE ACS FOR FILE CREATION: This field indicates whether to invoke, defer, or disable (inherit) ACS processing during file creation. Valid values are YES, DEFER, or INHERIT, where:
    • YES indicates that ACS processing is invoked during file creation. YES should not be used if an installation wants to assign a management class based on file size.
    • DEFER indicates that ACS processing is not invoked during file creation and no management class is assigned to the new files. The management class is assigned later during DFSMS CONVERT, MANAGE, or MIGRATE command processing
    • INHERIT indicates that ACS processing is not invoked during file creation and the NULL management class is assigned to the new files. The NULL management class allows a file to inherit the management class of the file’s parent directory. If the parent directory management class is also NULL, the system default management class is inherited.

Pressing ENTER verifies the values. If there are syntax errors on any of the values, you are prompted to correct those values. If you have left a required field blank, you are also prompted to provide a value. To save the base configuration information into the source configuration and return to the Configuration Application Selection panel, press END; however, you are not able to save the base configuration information if there are any syntax errors. Enter CANCEL from the ISMF command line to quit without saving.