CICS PA Settings

This facility allows you to customize the CICS PA dialog and batch JCL for running Report Sets and processing Historical Databases.

To display the CICS PA Settings panel, select option 1 CICS PA Settings from the Profile Options Menu.

Figure 1. CICS PA Settings
   File  Options  Help
 ------------------------------------------------------------------------------
                               CICS PA Settings
 Command ===> _________________________________________________________________
 
 Specify settings.
 
 CICS PA Load Library . . . . . 'CICSPA.V5R1M0.SCPALINK'_______________________
 
 Personal Profile Library . . . 'xxxx.CICSPA.TABL'____________________________
 
 Delete Confirmation  . . . . . YES___  (Yes or No)
 Cancel Confirmation  . . . . . NO____  (Yes or No)
 Automatic Save on Exit . . . . YES___  (Yes, No or Prompt)
 Reports in Upper Case  . . . . NO____  (Yes or No)
 Start of changeRead SMF File to EOF . . . . . NO____  (Yes or No)End of change
 Preferred Date Format  . . . . 1  1. ISO (YYYY⁄MM⁄DD)
                                   2. US (MM⁄DD⁄YYYY)
                                   3. European (DD⁄MM⁄YYYY)
 DASD Work File Unit Name . . . ________  (Blank for System Default)
 
 Job Statement Information:
 ===> //userid  JOB (ACCOUNT),'NAME',REGION=4M________________________________
 ===> ________________________________________________________________________
 ===> ________________________________________________________________________
 ===> ________________________________________________________________________
Start of change ===> ________________________________________________________________________End of change
Start of change ===> ________________________________________________________________________End of change 

All options have initial settings, but you can change these at any time to suit the way you use CICS® PA. Values must be specified for all options, except the DASD Work File Unit Name and CICS PA Load Library which have system defaults.

The options are:
CICS PA Load Library
Specify the name of the library that contains the CICS PA executable modules. This is used by the CICS PA dialog when generating the JCL for executing Report Sets. It need not be specified if the modules reside in the system LINKLIST. The initial setting is 'xxxx.SCPALINK' where xxxx is the DSN prefix specified at dialog start up. The default initial setting is 'CICSPA.V5R1M0.SCPALINK'.
Personal Profile Library
The CICS PA dialog utilizes ISPF tables for storing some user data such as your personal system definitions.

Specify the name of the data set to be used for maintaining these ISPF tables. As the data is typically user-specific and sharing with other users is not an issue, it is recommended that each user has their own data set to avoid contention with other users for access to tables.

The initial setting is 'xxxx.CICSPA.TABL' which CICS PA translates to 'xxxx.CICSPA.TABL' where xxxx is determined by your TSO prefix and userid.

If the specified data set does not exist, CICS PA uses default allocation parameters to create it when it is required. The data set can be allocated using ISPF facilities outside the dialog if your site has local requirements not satisfied by the defaults.

Delete Confirmation
This option applies only to Delete requests from panels which have Confirm in the action bar: the CICS PA “primary object” list panels (Report Sets, Report Forms, Object Lists). From these list panels, deleted items cannot be reinstated, so you might always want to be prompted to confirm your Delete requests. On all other panels, deleted items can be reinstated by a Cancel request.

Specify YES to request CICS PA to display a confirmation pop-up to prompt you to confirm your Delete request before it is actioned. This is the initial setting.

Specify NO to have CICS PA action Delete requests immediately without prompting for confirmation.

Note: This option does not apply to HDB where the default is always YES.
Cancel Confirmation
This option applies only to Cancel requests from panels which have Confirm in the action bar: CICS PA “primary object” panels (Report Set, Report Form, Object List), System Definitions and HDB.

Specify YES to display a confirmation pop-up if you attempt to Cancel when there have been updates. This is to alert you that you have made changes that will be discarded if you proceed with the Cancel request.

Specify NO to have CICS PA action Cancel requests immediately, without first prompting for confirmation. This is the initial setting.

Automatic Save on Exit
This option applies only to attempts to Exit edit sessions after making changes on CICS PA “primary object” panels (Report Set, Report Form, Object List) and the System Definitions panel. It is not applicable to HDB.

Specify YES to automatically save the changes on Exit. This is the initial setting.

Specify NO to automatically discard the changes on Exit. To save any changes before exit you must remember to use the SAVE command.

Specify PROMPT to display a message if there have been updates when you attempt to Exit. To save the changes, you can use the SAVE command. Otherwise, to discard the changes, you can use the CANCEL command.

Reports in Upper Case
Specify NO to receive reports in upper and lower case characters. This is the initial setting.

Specify YES to translate all reports to upper case characters only. This is particularly for printers that cannot handle mixed case. This generates the UPPER parameter on the EXEC statement in CICS PA JCL generation generates the

Start of changeRead SMF File to EOFEnd of change
Start of changeSelect this option to force CICS PA to process all records in the SMF file through to EOF. Normally CICS PA stops reading the SMF file as soon as the first record is encountered that is later than the To time (SMFSTOP). However, if the file is not in ascending time sequence, reading might end before all records earlier than SMFSTOP have been found.

This option is only effective when the To time is specified. Select it when the SMF file has been presorted and you want to ensure that all records within the From and To time range are processed.

End of change
Preferred Date Format
The CICS PA dialog can accept and present dates in the following formats:
  1. YYYY/MM/DD ISO
  2. MM/DD/YYYY US
  3. DD/MM/YYYY European

Enter either 1, 2, or 3 for the date format you prefer. 1 (ISO) is the initial setting.

Note: This option does not apply to the format of dates presented on batch reports, which is typically MM/DD/YYYY. Further, there are exceptions within the CICS PA dialog where the functionality dictates the date format. For example, the Changed time stamp field of component lists (Report Sets, Report Forms, Object Lists) always presents as YYYY/MM/DD HH:MM to be able to sort on this field.
DASD Work File Unit Name
Specify the device type or group name to be used by CICS PA to allocate DASD data sets as required by facilities such as:
  • Report Set, Report Form, Object List Data Sets
  • Extract, External and Sort Work Data Sets used in batch processing (if the Reporting Allocation Settings are not set).

The name must represent a device that is defined as DASD in the Eligible Device Table of the current processor. For example, SYSDA, SYSALLDA, 3390.

If not specified, the system default is used. Blank (for system default) is the initial setting.

Job Statement Information
Specify the JCL JOB statement, which can be continued to a maximum of Start of changesixEnd of change lines. These are used by CICS PA to supply the job statement for batch Report Set and HDB processing. All the rules of JCL must be followed in specifying the job statement. CICS PA does not validate this information. Blank lines are ignored.

The default is //userid JOB (ACCOUNT),'NAME'.

It is recommended that you include a REGION= parameter on your job card to allocate a virtual storage region size for CICS PA of at least 4M.


Information Information

Feedback


Timestamp icon Last updated: Friday, 8 February 2013


http://pic.dhe.ibm.com/infocenter/cicsts/v5r1/topic//settgs.htm