Creating and formatting Abend-AID report files
On the CSS Utilities - Abend-AID Report File Facility screen, the BMC AMI DevX Abend-AID Report Files section lists the eight BMC AMI DevX Abend-AID report files that have been most recently used. To create and format BMC AMI DevX Abend-AID report files, complete the following steps.
- Perform the appropriate step:
- To reformat an existing BMC AMI DevX Abend-AID report file, scan the BMC AMI DevX Abend-AID Report Files list. If it does not contain the file you want to reformat, enter the file name on the blank line at the top of the list. Then enter C to the left of the file name.
- To create a new BMC AMI DevX Abend-AID report file (and add the file to the list), enter the file name at the entry line under BMC AMI DevX Abend-AID Report Files, then enter a C to the left of the file name.
- Press Enter.
- If the file name you entered does not exist yet, you will first see the following file-type selection panel. You must select which type of file you want to create. Based on your selection, one of the following Create screens will then appear:
CSS Utilities - Select Desired File Type
COMMAND ===>
Commands: SEtup DD (DDIO tutorial) SD (SD/DB tutorial) LP (LP tutorial)
File Name entered: 'CX.NEW.FILE'
1 Shared Directory - Create a shared directory
NOTE: At least one database file must be
attached to this shared directory for it
to be functional.
2 Database File - Create a Database that will be attached
to an EXISTING shared directory.
3 DDIO File - Create a non-database DDIO file. Will not
work with Abend-AID 12.4 or newer.
Enter END command to terminate
The following CSS Utilities - Create/Format Abend-AID Report screen is displayed for existing standard DDIO files, CSS Utilities - Create/Format Shared Directory is displayed for exiting shared directory files, and CSS Utilities - Create/Format Report Database is displayed for existing Report Database files attached to a shared directory.
CSS Utilities - Create/Format Abend-AID File Screen (Standard DDIO Files)
COMMAND ===>
Commands: SEtup A (Advanced Parms) DDCV (DDIOCalc Values)
DD (DDIO tutorial) SD (SD/DB tutorial) LP (LP tutorial)
Dataset Name ===> 'CX.AA.NEW.DDIO'
Preparation ===> BATCH (Batch/Editjcl/Foreground)
DS Organization ===> VSAM (Vsam/Sequential)
Reallocate ===> NO (Yes/No)
Model DSN ===>
Storage Class ===> (optional, unless site requires)
Management Class ===> (optional, unless site requires)
Data Class ===> (optional, unless site requires)
Volume ===> (optional, unless site requires)
Unit ===> (optional, unless site requires)
Space Units ===> CYLINDERS (Blocks/Tracks/Cylinders)
Primary Quantity ===> 50
Number of Members ===> 500 (1 to 16000)
Press ENTER to process or enter END command to terminate
CSS Utilities - Create/Format Abend-AID Shared Directory Files Screen
COMMAND ===>
Commands: SEtup A (Advanced Parms)
DD (DDIO tutorial) SD (SD/DB tutorial) LP (LP tutorial)
Dataset Name ===> 'CX.AA.NEW.SHRDIR'
Preparation ===> BATCH (Batch/Editjcl/Foreground)
Reallocate ===> NO (Yes/No)
Model DSN ===>
Storage Class ===> (optional) ==> (optional, unless site requires)
Management Class ===> (optional) ==> (optional, unless site requires)
Data Class ===> (optional) ==> (optional, unless site requires)
Volume ===> (optional) ==> (optional, unless site requires)
Space Units ===> TRACKS (Blocks/Tracks/Cylinders)
Primary Quantity ===> 70
OR
Number of Entries ===> (optional)
(This field overrides above space parms & calculates space needed)
Press ENTER to process or enter END command to terminate
CSS Utilities - Create/Format Abend-AID Report Database File
COMMAND ===>
Commands: SEtup A (Advanced Parms) DDCV (DDIOCalc Values)
DD (DDIO tutorial) SD (SD/DB tutorial) LP (LP tutorial)
Dataset Name ===> 'USER.CSS.DATABASE.DB1'
Preparation ===> EDITJCL (Batch/Editjcl/Foreground)
DS Organization ===> VSAM (Vsam/Sequential)
Reallocate ===> NO (Yes/No)
TYPE ===> BATCH (BATCH/CICS)
Model DSN ===>
Storage Class ===> (optional, unless site requires)
Management Class ===> (optional, unless site requires)
Data Class ===> (optional, unless site requires)
Volume ===> (optional, unless site requires)
Unit ===> (optional, unless site requires)
Space Units ===> CYLINDERS (Blocks/Tracks/Cylinders)
Primary Quantity ===> 2
Number of Members ===> 5 (1 to 16000)
Shared directory ===> 'USER.CSS.SHAREDIR.SD'
Press ENTER to process or enter END command to terminate
Complete the fields on this screen using the following table as a space.
BMC AMI DevX Abend-AID Create/Format Report File Fields
To: | Do This: |
|---|---|
Edit the CSS Utilities General Settings | Enter SE at the Command prompt. |
Display advanced parameters | Enter A at the Command prompt. For a complete description of the advanced parameters, see Abend-AID Create/Format Report File Advanced Parameters. |
Load values from the DDIOCalc Utility | Enter DDCV in the Command prompt. |
Use batch processing to submit your job | Enter BATCH in the Preparation field. |
Generate JCL for the Create/Format job, then edit the JCL | Enter EDITJCL in the Preparation field. |
Immediately perform the desired function in your TSO session | Enter FOREGROUND in the Preparation field. |
Specify the file type | Enter VSAM or SEQUENTIAL in the DS Organization field. If a Model DSN is specified (see below), this parameter is optional. If a Model DSN is not specified, you must specify a file type. |
Delete and reallocate the specified report file | Enter YES in the Reallocate field. |
To create an BMC AMI DevX Abend-AID batch report Database | Enter 'BATCH' in the TYPE field. |
To create an BMC AMI DevX Abend-AID for CICS report Database | Enter 'CICS' in the TYPE field. |
Specify a “template” (another BMC AMI DevX Abend-AID report file) for allocating and formatting BMC AMI DevX Abend-AID report files | (Optional) Enter the data set name in the Model DSN field. All explicitly set parameters on this screen, and on the Advanced Parameters screen, override settings in the template file. |
Specify a Storage Management Subsystem (SMS) storage class | (Optional unless site requires) Enter an eight-character storage class in the Storage Class field. |
Specify an SMS management class | (Optional unless site requires) Enter an eight-character management class in the Management Class field. |
Specify an SMS data class | (Optional unless site requires)Enter an eight-character data class in the Data Class field. |
Specify the volume serial number of the BMC AMI DevX Abend-AID report file | (Optional unless site requires) Enter the volser in the Volume field. |
Specify a device or device type | (Optional unless site requires) Enter the device or device type in the Unit field. |
Specify a unit of measure for the file size | Enter BLOCKS, TRACKS, or CYLINDERS in the Space Units field. If DS Organization = VSAM and a Model DSN is specified, this parameter is optional. If not, this parameter is required. |
Specify an amount of primary space for the Abend-AID report file | Enter a value in the Primary Quantity field. If DS Organization = VSAM and a Model DSN is specified, this parameter is optional. If not, this parameter is required. |
(DDIO or Database only) Specify the maximum number of members that the BMC AMI DevX Abend-AID report file can contain | Enter a value in the Number of Members field. If a Model DSN is specified, this parameter is optional. If not, this parameter is required. |
(Shared Directory only) Specify the number of entries, Total number of members, to be stored In the shared directory. | (Optional) Enter a value in the Number of Entries field. If a value is entered here, it will override the space Parameters entered. |
(Report Database only) Specify the shared directory | Enter the name of the Shared directory you want the Database attached to. |
After you have finished editing the fields, perform the appropriate action. To submit the Create/Format job or execute Create/Format commands in your TSO session, ensure that the Command prompt is blank and press Enter.
To cancel the changes and return to the previous screen, enter END at the Command prompt.
Setting Advanced Create/Format Parameters
To edit BMC AMI DevX Abend-AID report file Create/Format advanced parameters, complete the following steps:
- Enter A at the command prompt on the CSS Utilities - Create/Format Abend-AID Report File options screen.
- Make sure the DS Organization field is set to the desired file type.
- Press Enter.
BMC AMI DevX Abend-AID Report File Create/Format - Advanced Parms (Sequential)
COMMAND ===>
Commands: SEtup DD (DDIO tutorial) SD (SD/DB tutorial) LP (LP tutorial)
Prompt this panel upon process ===> N (Y/N)
Enter/Modify parameters for Sequential Abend-Aid Report file:
DEFAULTS:
Blocksize ===> (2048 to TRKSIZE) 27998
Groupcount ===> (1 to 2048) 2
Autodelete ===> YES (Dups/Yes/No) YES
Extents ===> (1 to 460) 460
Note: Once any of the above parameters are modified, the new values will
remain in effect for future formatting until they are modified again.
Press ENTER to process or enter END command to terminate
BMC AMI DevX Abend-AID Report File Create/Format - Advanced Parms (VSAM)
COMMAND ===>
Commands: SEtup DD (DDIO tutorial) SD (SD/DB tutorial) LP (LP tutorial)
Prompt this panel upon process ===> N (Y/N)
Enter/Modify parameters for VSAM Abend-AID Report file:
DEFAULTS:
CISIZE ===> 18432
Multivolume ===> (Yes or No) NO
VSAM Catalog ===>
Groupcount ===> (1 to 2048) 3
Autodelete ===> DUPS (Dups/Yes/No) YES
Extents ===> (1 to 460) 460
Note: Once any of the above parameters are modified, the new values will
remain in effect for future formatting until they are modified again.
Press ENTER to process or enter END command to terminate
BMC AMI DevX Abend-AID Report File Shared Directory Create - Advanced Parms
COMMAND ===>
Commands: SEtup DD (DDIO tutorial) SD (SD/DB tutorial) LP (LP tutorial)
Prompt this panel upon process ===> N (Y/N)
Enter/Modify parameters for VSAM Shared Directory:
DEFAULTS:
CISIZE ===> 8000 18432
Multivolume ===> YES (Yes or No) NO
VSAM Catalog ===>
Note: Once any of the above parameters are modified, the new values will
remain in effect for future formatting until they are modified again.
Press ENTER to process or enter END command to terminate
BMC AMI DevX Abend-AID Report Database Create/Format - Advanced Parms (VSAM)
COMMAND ===>
Commands: SEtup DD (DDIO tutorial) SD (SD/DB tutorial) LP (LP tutorial)
Prompt this panel upon process ===> N (Y/N)
Enter/Modify parameters for VSAM Report Database:
DEFAULTS:
CISIZE ===> 18432
Multivolume ===> YES (Yes or No) NO
VSAM Catalog ===>
Groupcount ===> 21 (1 to 2048) 3
Autodelete ===> YES (Dups/Yes/No) YES
Extents ===> (1 to 460) 460
Note: Once any of the above parameters are modified, the new values will
remain in effect for future formatting until they are modified again.
BMC AMI DevX Abend-AID Report Database Create/Format - Advanced Parms (Sequential)
COMMAND ===>
Commands: SEtup DD (DDIO tutorial) SD (SD/DB tutorial) LP (LP tutorial)
Prompt this panel upon process ===> N (Y/N)
Enter/Modify parameters for Sequential Report Database:
DEFAULTS:
Blocksize ===> (2048 to TRKSIZE) 27998
Groupcount ===> 20 (1 to 2048) 2
Autodelete ===> YES (Dups/Yes/No) YES
Extents ===> (1 to 460) 460
Note: Once any of the above parameters are modified, the new values will
remain in effect for future formatting until they are modified again.
Press ENTER to process or enter END command to terminate
Complete the fields on this screen, as necessary, using the following table as a space.
BMC AMI DevX Abend-AID Create/Format Report File Advanced Parameters
To: | Do This: |
|---|---|
Specify whether advanced parameters will be displayed each time a Create/Format Abend-AID Report File command is processed | Enter one of the following in the Prompt This Panel Upon Process field: Y: Displays advanced parameters before processing Create/Format commands. N: Processes Create/Format commands without displaying advanced parameters. |
(Sequential files only) Specify the BMC AMI DevX Abend-AID report file blocksize | Enter an integer between 2048 and 32760 in the Blocksize field. • If you do not complete this field, the default blocksize of 4096 will be used. • The blocksize is always ignored during the file allocation phase. |
(VSAM files only) Specify the control interval size | Enter an integer in the CISIZE field. If you do not complete this field, the default value of 4096 will be used. |
(VSAM files only) Specify whether VSAM BMC AMI DevX Abend-AID report files will be allocated on multiple volumes | Enter one of the following in the Multivolume field: Yes: VSAM BMC AMI DevX Abend-AID report files will be allocated on multiple volumes. No: (Default) VSAM BMC AMI DevX Abend-AID report files will not be allocated on multiple volumes. The multivolume data set allocation must be performed in a batch mode. See the Enterprise Common Components Installation and Customization space for more information. After allocation is complete, the file can be formatted using online Create/Format panels with the Reallocate field value set to NO and Advanced Parameter Multivolume set to YES. |
(VSAM files only) Specify the VSAM catalog in which the BMC AMI DevX Abend-AID report file will be created | (Optional) Enter a catalog name in the VSAM Catalog field. |
Specify the number of blocks allocated to an BMC AMI DevX Abend-AID report file when additional space is needed | Enter a number between 1 and 2048 in the Groupcount field. We recommend setting the Groupcount to 8. The default setting is 4. |
Specify whether the oldest member of an BMC AMI DevX Abend-AID report file will be deleted when the file becomes full | Enter one of the following settings in the Autodelete field: Dups: Unlocks automatically locked members with the same name, then locks the most recent member. Yes: (Default) Automatically deletes one or more of the oldest unlocked members to allow new members to be written to the file. No: You must manually delete members when the DDIO file becomes full. For a complete description of these settings, see Command-Parameters-for-all-DDIO-files. |
Specify the maximum number of extents allocated to each BMC AMI DevX Abend-AID report file member | Enter a number between 1 and 460 in the Extents field. If you do not complete this field, the default value of 64 will be used. |
After you have finished editing the fields, perform the appropriate action. To apply the advanced parameter settings and return to the previous screen, ensure that the Command prompt is blank and press Enter. To cancel the changes and return to the previous screen, enter END at the Command prompt.