Using ISPF primary commands

The primary commands available from the Selected CA Groups panel are summarized in this topic.

The following primary commands are used to set default control information values and to build the control parameters that are required by IMS HP Change Accumulation Utility.

SET

Sets the default IMS HP Change Accumulation Utility control parameter values, as well as the space allocation parameters for all log spill data sets. You can override space allocation parameters for any CAGROUP by using the line commands at the CAGROUP level.

The SET command and the L line commands have similar menus. The SET menu is at the global level, and the L line command menu is at the CAGROUP level.

For a description of menu items, see Setup Selection Menu.

GEN

Creates the control information records that are required to run IMS HP Change Accumulation Utility. These records are created from the setup values entered using the SET command and the output of the GENJCL procedure for the CAGROUPS selected for the IMS HP Change Accumulation Utility run. In addition, the GEN command creates the JCL to run IMS HP Change Accumulation Utility.

ENV

Displays the current settings of the runtime parameters. An example of the panel resulting from the ENV command is displayed in Displaying current environment data (ENV command).

FAST (Create Control and Processing Information)

Combines the processing values of the GEN and RUN commands.

RUN

Submits the JCL created by the GEN command to the z/OS® internal reader for processing.

STAT (Display Job Status)

Displays the status of the submitted IMS HP Change Accumulation Utility job. If no IMS HP Change Accumulation Utility job has been submitted, STAT displays the status of all jobs for the TSO user ID. An example of the panel that results from the STAT command is displayed in Displaying job status (STAT command).

BAT (Create Control Information for Batch Mode)

Creates control parameters for running batch jobs.

Select the BAT command to create control information for all selected CAGROUPS using the parameter values set for each CAGROUP. This command does not run the DBRC utility GENJCL procedure. BAT also creates JCL to run IMS HP Change Accumulation Utility.

SORT

Sorts the displayed table by PRTY or by CAGROUP. To sort the table by PRTY, enter the SORT command without parameters. To sort it by CAGROUP, enter the command SORT CAG.

SCAN

Analyzes setup parameters and JCL. Analysis is displayed in Browse format for review. The information reported by SCAN is describe in Using diagnostic resources.

JCL

The JCL command converts the current environment settings to JCL that will process the extended batch function. The JCL is displayed and can be viewed, modified, submitted, or saved.

You can change one or more fields in multiple rows before pressing the Enter key, and you can enter multiple line commands. Processing is performed in the sequence of the CAGROUP name.

Changes are applied in two phases:

In the first phase, fields in selected rows are changed when there is no plausibility check failure.
In the second phase, rows with plausibility errors are processed again, and an error message is displayed for the field in error.

The row that contains the error displays at the top, and line commands are ignored for rows with errors.

Generally, all row modifications should precede any primary command. However, if a primary command is also entered with line commands and field modifications, then processing depends on the type of primary command that was entered.

The SET, ENV, SORT, RUN and STAT primary commands are processed immediately and cause line commands and field modifications to be ignored. The GEN, BAT and FAST commands are ignored if any row has a line command or a field modification.

If DBRC returns with a highest return code of 4 during the processing of the GEN command, the output in SYSPRINT is displayed, as shown in Figure 1. The description explains the cause of the error.

You can either cancel the GEN command (by issuing the CAN command), or continue by entering the END command (usually, PF3).

For example:

Figure 1. Sample SYSPRINT output

GENJCL Messages - 'VNDR400.SYSPRINT'     GENJCL returned with err

Enter END (PF3) to exit. Enter CAN to exit without processing.

******************************Top of data***************************
1     IMS VERSION 15 RELEASE 1  DATA BASE RECOVERY CONTROL   PAGE 000
0 GENJCL.CA  GRPNAME(CAGRP1)-
0 NOLIST NOJOB
0DSP0326I UNDEFINED SIMPLE KEYWORD %USERNAME IN SKELETAL JCL
 DSP0326I MEMBER CAJCL  DD NAME JCLPDS  RECORD NUMBER 00001
0DSP0326I UNDEFINED SIMPLE KEYWORD %USERID IN SKELETAL JCL
 DSP0326I MEMBER CAJCL  DD NAME JCLPDS  RECORD NUMBER 00002
0DSP0326I UNDEFINED SIMPLE KEYWORD %PRINT  IN SKELETAL JCL
 DSP0326I MEMBER CAJCL  DD NAME JCLPDS  RECORD NUMBER 00004
0DSP0203I COMMAND COMPLETED WITH CONDITION CODE 04
0DSP0220I COMMAND COMPLETION TIME 21.230 15:09:06.6
1    IMS VERSION 15 RELEASE 1  DATABASE RECOVERY CONTROL     PAGE 000
0 GENJCL.CA  GRPNAME(CAGRP2)-
0 DEFAULTS(MBR1)-
ODSP0203I COMMAND COMPLETED WITH CONDITION CODE 00
ODSP0220I COMMAND COMPLETION TIME 21.230 15:09:06.7
1    IMS VERSION 15 RELEASE 1 DATABASE RECOVERY CONTROL     PAGE 000
0DSP0211I COMMAND PROCESSING COMPLETE
 DSP021II HIGHEST CONDITION CODE=04
*****************************Bottom of data*************************