Variable gathering dialog options

Use the action commands and modes available for the variable-gathering phase.

Variable-gathering action commands

Two modes are used to display the variables:

LST: Variables are presented as a scrollable list of items. One or more items can be modified at a time, but minimal information is displayed for each item. LST is the default.
ENT: Variables are presented one at a time. Scrollable descriptive information is provided for each variable.

Action commands are provided to support the IVP dialog during the variable-gathering phase. Action commands are also referred to as action verbs.

The following table contains the action commands, accepted modes, and command descriptions. Mode indicates whether the commands are accepted in:

LST: LST mode
ENT: ENT mode
Both: LST mode and ENT mode

In the following table, the capitalized letters in the action column indicate the shortest allowable abbreviation for each command.

Table 1. Variable-gathering action commands
Action	Mode	Description
Chg	Both	Changes information in an item. The dialog performs basic validity checking for the new value. If an item is modified, CHG is the default. It is not necessary to use CHG in the action field.
Doc	Both	Prints variables documentation to the ISPF LIST data set. The DOC action prints all variables, not only the variable where the DOC action is requested.
eNt	LST	Switches to ENT mode. ENT mode presents items one at a time on a formatted screen and provides a description of the variable along with its usage.
Lst	ENT	Switches to LST mode. LST mode presents a scrollable list of items. Within ENT Mode, the ISPF END command is also interpreted as the LST action.
Nxt	ENT	Moves forward to the next item.
Prv	ENT	Moves backward to the previous item.
Rfr	Both	Refreshes a variable value from the IVP master table.
Imp	Both	Imports the IVP variables.
Exp	Both	Exports the IVP variables.

In LST mode, you can either change one item at a time or make changes to many items before pressing ENTER. Whenever two or more changes are made before pressing Enter, the dialog attempts to process all change requests before returning control.

If errors occur during the variable-gathering phase, the item is updated with the supplied information and the character string ERR is placed into the action field. If errors exist after all requests have been processed, a single error message is displayed and the screen is positioned at the first item containing the string ERR in the action field. Correct all errors before the dialog allows you to enter the file-tailoring or execution phases. If you cannot tell what is wrong with a given item, type CHG in the action field for that item, and change one item at a time. When you press Enter, the dialog reruns variable edit for that item and produces an appropriate error message.

Variable gathering—LST mode

When you enter the variable-gathering phase, you are in LST mode. The following figure depicts the LST mode panel of the variable gathering phase. This mode provides the greatest visibility of the variables available for the selected option.

Figure 1. Variable gathering (LST mode) panel

 Help
------------------------------------------------------------------------------
IVP          Variable Gathering (LST Mode)- XRF        IMS 15.4.1 ROW 1 to 8 of 154
COMMAND ===>                                                  SCROLL ===> PAGE

Action Codes: Chg Doc eNt Rfr Imp Exp - CHG is the default for a modified
              item
      Variable = Value..........................................
          Var-Title.............................................
 *       IXUIVPHQ = IVPIVP11
               IVP - High-level DSNAME qualifier for IVP (IVP) data sets
 *       IXURLMHQ = IVPRLM11
               IVP - High-level DSNAME qualifier for the IRLM (RLM) data sets
 *       IXUDLBHQ = IVPIVP11
               IVP - High-level DSNAME qualifier for IMS DLIB (DLB) data sets
 *       IXUSYSHQ = IVPIVP11
               IVP - High-level DSNAME qualifier for IMS System (SYS) data sets
 *       IXUEXEHQ = IVPIVP11
               IVP - High-level DSNAME qualifier for Execution (EXE) data sets
 *       IXUUTLHQ = IVPIVP11
               IVP - High-level DSNAME qualifier for Utility (UTL) data sets
 !       IXUSSCLS = 
               SMS - Storage Class
 !       IXUSMCLS = 
               SMS - Management Class
 !       IXUTAPEU = 3480
               IVP - Tape device type

If you are not sure what a variable is, you can use the ENT action to switch to ENT mode, read the variable description, and use the LST action to return to LST Mode. You can also use the ENT action to switch to ENT mode, and then progress through the variables one at a time.

Special characters in the action field indicate changes to variables:

!: Indicates that either a variable was added to the table (due to service) or that the RFR action has restored the master table default value. You can remove the ! indicator by running the table-merge process.
*: Indicates that the variable was changed, either by the CHG action or by the copy-startup variables process.
@: Indicates that the variable has been changed, either by the CHG action or by the copy-startup variables process, as the result of propagating the change of a global variable to the affected data set allocation variables.

Try the ENT action for the first item. Type ENT (or N) into the action field next to the item you want. The command line cannot be used for action commands on the LST mode panels.

To switch modes, press Enter.

Variable gathering—ENT mode

The following figure depicts the ENT mode panel corresponding to the item you selected in the LST mode panel.

Figure 2. Variable gathering (ENT mode) panel

  Help
----------------------------------------------------------------
IVP         Variable Gathering (ENT Mode)-XRF           IMS 15.4.1
COMMAND ===>                                             SCROLL ===> PAGE
DFSIX001: DFSIXX08 - "ENT" action complete
Action...... *   Select one of: Chg  Doc  Lst  Nxt  Prv  Rfr Imp Exp
Name........: IXUIVPHQ
User Value..: IVPIVP11
Title.......: IVP - High-level DSNAME qualifier for IVP (IVP) data sets
Blank-OK....: N  HLQ-Group...    VOL-Group...    BLK-Group...
------------------------------------------------------------------------------
**************** Top of Data *******************************
This variable specifies the high level DSNAME qualifier (HLQ) to be
used when allocating and referencing IVP data sets.

This grouping of data sets includes those data sets which are specific 
to the IVP process:
  o INSTALIB, INSTATBL, ...

Data sets associated with this HLQ variable belong to the “IVP” 
group. If this variable is changed, then the HLQ variables for ALL
data sets belonging to this group will be changed accordingly.

NOTE:
Press HELP for additional information on the following:
   o  Global Variables
   o  Data Set Allocation Variables
       (including the overriding of global VOLSER and BLKSIZE values)

JCL (and VSAM, if applicable) coding rules apply.

*************** BOTTOM OF DATA *****************

ENT mode provides more information for each variable:

Whether the variable can be blank.
Membership in the global variable groups. These fields are blank for all variables except those variables that used for data set allocation.
A scrollable description of the variable.

You can view all the items in the variable table by using the NXT and PRV actions.

Use the DOC action to print a copy of the online help. Type DOC into the action field and press Enter.

Variable gathering—DOC action

The following figure shows the DOC action panel for the variable-gathering phase.

Figure 3. Variable gathering (DOC action) panel

 Help
----------------------------------------------------------------
IVP        Variables Documentation - XRF       IMS 15.4.1
COMMAND ===>

   Select (1 or 2) the type of output:
_  1 - LST Mode equivalent containing names, titles, and current values
   2 - ENT Mode equivalent containing full descriptions

   Select (/) the types of variables to be documented:
_  General variables (HLQ, VOL, BLK, JOB, SMP, SYSDEF, etc.)
_  Data set allocation variables




   Press END to return to Variable Gathering.
   Press ENTER to initiate the documentation request.

   NOTE:  Output will be printed to the ISPF List data set.
   Maximum output (for XRF/ISD) is about 2K lines for Type 1
   and 12K lines for Type 2.

In this panel, select the type of output listing you want:

LST mode equivalent
ENT mode equivalent

Then select the variables you want to print and press Enter. The requested documentation prints to the ISPF LIST data set. Even though the DOC action is entered against a single item, the resulting documentation is for all the selected types of items.

For the example in the above figure, no documentation is printed. Press End twice to return to LST mode, and then press End again to exit from the variable-gathering phase.