Starting the ISPF user interface
You use the ISPF user interface to specify control information for the IMS HP Change Accumulation Utility environment.
If you encounter problems, enter HELP on any panel for an explanation of what can be entered on the panel.
Required libraries
Before you run the ISPF user interface, ensure that the following libraries exist:
- smphlq.SHPCCEXE (CLISTs)
- smphlq.SHPCPLIB (Panels)
- smphlq.SHPCMLIB (ISPF messages)
- smphlq.SHPCLMD0 (Programs)
You do not need to change your TSO logon procedure to include any of the previous libraries.
ISPF data sets
The ISPF user interface uses the following data sets when ISPF is running.
- hpchlq.CONTROL
- This is a partitioned data set that is created by ISPF to contain
control information for the ISPF user interface. If the data set exists,
it is reused. This data set is defined with variable length unblocked
records. The ISPF user interface generates the following members:
- hpca-id#BAT
- This member contains global control information records and run-time parameter values for each CAGROUP that is selected for processing. If you plan to run IMS HP Change Accumulation Utility as a batch job using a two-step procedure, this member must contain the CAGROUP-dependent control information for all CAGROUPS that are registered in the RECON data set.
- hpca-id#CTL
- This member contains records from the HPCA#BAT member and records built from the output of the GENJCL procedure. The information in this member is run dependent. For each selected CAGROUP for which change accumulation occurs, relevant records for that CAGROUP are selected from HPCA#BAT and merged with the records from the output of the GENJCL procedure.
- hpca-id#GIN
- This member contains input statements to the GENJCL procedure. These statements are built using information you provide through the ISPF user interface. When running IMS HP Change Accumulation Utility as a batch job using a two-step procedure, you provide the input to the GENJCL procedure through the GENJCLIN data set.
- hpca-id#DRIV
- This member contains the JCL to run IMS HP Change Accumulation Utility for the IMS system that is associated with the IMS HP Change Accumulation Utility ID.
- hpchlq.SYSIN
- This is a temporary sequential data set that is used by the ISPF user interface to hold the input to the DBRC utility program.
- hpchlq.JCLOUT
- This is a temporary sequential data set that is used by DBRC to output the JCL it creates.
- hpchlq.SYSPRINT
- This is a temporary sequential data set that is used by the ISPF user interface to hold the output from the DBRC utility program.
- hpchlq.HPCTABLE
- This is a partitioned data set created by the ISPF user interface
to hold control information. If the data set does not exist, it is
created and maintained across ISPF sessions. This data set contains
the following ISPF tables:
- HPCTIMS
- HPCTCA
- HPCTENV
- HPCTSRT
- HPCTLOG
- hpchlq.SAMPLIB
- This library is provided with the product and contains sample JCL.
You do not need to allocate work data sets or an ISPF tables data set because they are allocated by the ISPF user interface.
Information about the ISPF screen display
- If your screen size is 24 X 80 and your screen shows the PFK settings, you might not see all the data IMS HP Change Accumulation Utility displays.
- Use the ISPF command FKA OFF to remove the display of the PFK settings.
Activating the ISPF interface
Perform the following steps to activate the ISPF interface for IMS HP Change Accumulation Utility:
- From ISPF main menu, select Option 6: Command.
Figure 1. ISPF Primary Option Menu Menu Utilities Compilers Options Status Help ----------------------------------------------------------------------------- z/OS Primary Option Menu Option ===> 6_________________________________________________________________ 0 Settings Terminal and user parameters User ID . : GCAMA 1 View Display source data or listings Time. . . : 06:37 2 Edit Create or change source data Terminal. : 3278 3 Utilities Perform utility functions Screen. . : 2 4 Foreground Interactive language processing Language. : ENGLISH 5 Batch Submit job for language processing Appl ID . : ISR 6 Command Enter TSO or Workstation commands TSO logon : TPROC02 7 Dialog Test Perform dialog testing TSO prefix: GCAMA 8 LM Facility Library administrator functions System ID : STLABE2 9 IBM Products IBM program development products MVS acct. : * 10 SCLM SW Configuration Library Manager Release . : ISPF 7.3 11 Workplace ISPF Object/Action Workplace 12 z/OS system z/OS system programmer applications 13 z/OS user z/OS user applications D DB2/DXT/QMF Display DB2/DXT/QMF Selection Panel G SWG/SVL Display SWG/SVL Selection Panel Enter X to Terminate using log/list defaultsThe ISPF Command Shell is displayed.
- From the ISPF Command Shell, enter a command string using the
following syntax:
EX 'smphlq.SHPCCEXE(HPCC000)' 'SMPHLQ(smphlq) HPCHLQ(hpchlq) <VOL(volser)> <PDSE>'The following list defines the keywords that are used to run the ISPF user interface:
- SMPHLQ
- Specify the high-level qualifier of your installation data set.
- HPCHLQ
- Specify the high-level qualifier for work data sets required by the ISPF user interface.
- VOLSER
- Specify the volume serial number of the DASD device on which the work data sets are allocated. This parameter is optional.
- PDSE
- Specify that PDSE data sets are to be used for the IMS HP Change Accumulation Utility work files. The default is to define the data sets as PDS. PDS data sets require periodic compression.
For example:
Figure 2. ISPF Command String Menu List Mode Functions Utilities Help ------------------------------------------------------------------------------- ISPF Command Shell Enter TSO or Workstation commands below: ===> ex 'gcama.irs210.shpccexe(hpcc000)' 'smphlq(gcama.irs210) hpchlq(hpca)' Place cursor on choice and press enter to Retrieve command - The IBM® copyright screen
appears.
Figure 3. ISPF IBM Copyright Screen Press ENTER to continue. ======= ============ ====== ====== * ======= ============== ======= ======= === === ===== ====== ====== === =========== ======= ======= === =========== === ======= === === === ==== === ===== === ======= ============== ===== === ===== ======= ============ ===== = ===== IMS Recovery Pack for z/OS Version 1 Release 1 IMS High Performance Change Accumulation for z/OS ---------------------------------------------- | Licensed Materials - Property of IBM | | 5655-V86 5655-F59 | | Copyright IBM Corp. 2001,2010 | | All Rights Reserved. | | US Government Users Restricted Rights - | | Use, duplication or disclosure restricted | | by GSA ADP Schedule Contract with IBM Corp.| ---------------------------------------------- * Trademark of International Business Machines - Press Enter to continue.
The HPCA-ID/IMS Profile panel displays:
Figure 4. HPCA-ID/IMS Profile - part 1 HPCA-ID/IMS Profile Row 1 of 1 COMMAND ===> _____________________________________ SCROLL ===> PAGE Enter END (PF3) to exit. To create a new HPCA-ID/IMS profile, enter an HPCA-ID and its description HPCA-ID: ____ Profile Description: ______________________________ Enter line command S to select an IMS System for this run T to setup DBRC product datasets D to delete an HPCA-ID profile CMD HPCA-ID HPCA-ID/IMS Profile Description --- ------- ------------------------------- _ IMST IMS Version n.n TestFigure 5. HPCA-ID/IMS Profile - part 2 HPCA-ID/IMS Profile Row 1 of 2 COMMAND ===> _______________________________________ SCROLL ===> PAGE Enter END (PF3) to exit. To create a new HPCA-ID/IMS profile, enter an HPCA-ID and its description HPCA-ID: ____ Profile Description: ______________________________ Enter line command S to select an IMS System for this run T to setup DBRC product datasets D to delete an HPCA-ID profile CMD HPCA-ID HPCA-ID/IMS Profile Description --- ------- ------------------------------- _ IMST IMS Version n.n Test _ IMSP IMS Version n.n Production