CA SymDump System provides two programs that perform basic maintenance and utility functions in batch.
The dump index utility CADVIDXU provides batch access to view or update the contents of any dump index. It can also be used to initialize a new dump for viewing by building the storage index in batch.
The dump loading utility CADVILDD can be used to convert a SVC dump into a format that can be loaded by the CA SymDump System dump viewers.
A sample JCL member is provided for each of the utilities in the sample JCL library, each with a member name matching the utility name.
This section contains the following topics:
Use CADVIDXU to display or modify the contents of the dump index, or to initialize a dump for viewing.
Sample JCL for CADVIDXU is shown here:
// JOB //STEP1 EXEC PGM=CADVIDXU //STEPLIB DD DISP=SHR,DSN=yourhlq.CCPILINK //SYSPRINT DD SYSOUT=* //SYSIN DD * (input commands go here) /*
No STEPLIB DD statement is required if CA SymDump System is available through the linklist.
Input commands can start in any column but each command must be fully contained on a single line.
The following input commands are supported:
Each command is described in detail in this chapter.
Deletes one or more dumps and removes the corresponding index entries from the dump index. Dumps that have been locked (see the LOCK command later in this section) cannot be deleted.
Syntax
DELETE <selection-criteria>
Where selection-criteria refer to an expression used to select one or more dumps to delete. See Selection Criteria later in this section for information.
DELETE AGE GT 5
Example
This statement deletes all dumps in the dump index older than five days, provided that they were not locked to prevent deletion.
Identifies the name of the dump index. The DSN command must precede any other commands.
Syntax
DSN dump-index-dsname
Where dump-index-dsname refers to the fully qualified data set name for your dump index.
Note: Do not enclose the dsname in quotes.
Example
DSN CAI.DUMPIX
This statement initiates access to the dump index named CAI.DUMPIX.
Initializes a new dump index for capture. You must initialize a new dump index before using it for dump capture. You cannot reinitialize an existing dump index. To create a new dump index you must allocate a new data set using IDCAMS prior to initialization.
Syntax
INIT ENTRIES EQ nnnn
Where nnnn identifies the maximum number of dump index entries that can be allowed to occupy the dump index at any time. For more information about initializing a dump index, see the Installation Guide.
Example
INIT ENTRIES EQ 250
This statement initializes a new dump index and sets the maximum number of entries to 250.
Displays the attributes for one or more dumps from the dump index.
Syntax
LIST <selection-criteria>
Where selection-criteria refer to an expression used to select one or more dumps to list. For information, see "Selection Criteria".
Example
LIST COMP EQ S0C7
This statement displays the attributes for all dumps in the dump index whose completion code was S0C7.
Locks a dump to prevent accidental deletion and places your own user ID in the Lock Userid attribute in the dump index.
Syntax
LOCK <selection-criteria>
Where selection-criteria is an expression used to select one or more dumps to lock. For information, see "Selection Criteria".
Example
LOCK ASID EQ 012C
This statement locks all dumps created for the address space whose ASID is equal to 012C.
Builds the storage index to prepare a dump for loading into the viewer.
Syntax
STGINDEX <selection-criteria>
Where selection-criteria is an expression used to select one or more dumps whose storage indexes must be built. For information, see Selection Criteria.
Example
STGINDEX ALL
This statement builds the storage index for all dumps for which the index has not already been built.
Unlocks a previously locked dump to allow deletion and removes the Lock Userid attribute from the dump index entry.
Syntax
UNLOCK <selection-criteria>
Where selection-criteria is an expression used to select one or more dumps to be unlocked. For information, see "Selection Criteria".
Example
UNLOCK DATE LT 2010/01/21
This statement unlocks all dumps created before January 21, 2010.
Some of the input commands for CADVIDXU require selection criteria to determine which dumps must be targeted by the command.
To target all dumps in the index, specify:
Otherwise, specify a selection criteria expression as follows:
<attribute operator value>
Where:
attribute refers to one of the following:
Age of a dump.
Value must specify a number of days.
Address space ID for the captured dump.
Value must specify a four-digit hexadecimal address space ID.
Completion code from the captured dump.
Value must specify a completion code such as Sxxx or Uxxxx.
Date that the dump was captured.
Value must specify a date yyyy/mm/dd.
Reports data set name for the dump.
Value must specify a fully qualified dsname, no quotes.
Storage data set name for the dump.
Value must specify a fully qualified dsname, no quotes.
Job name for the captured dump.
Value must specify a job name.
User ID owning a no delete lock for the dump.
Value must specify a user ID.
Executing program name from the captured dump.
Value must specify a program name.
System ID for the system on which the dump was captured.
Value must specify a system id.
User ID from the captured dump.
Value must specify a user id.
operator Is the type of comparison that is made between specified attribute of each dump and the specified value. If the comparison is successful, the dump is selected for processing.
Attribute is equal to the value specified.
Attribute is not equal to the value specified.
Attribute is greater than the value specified.
Attribute is less than the value specified.
Attribute is greater than or equal to the value specified.
Attribute is less than or equal to the value specified.
Value Is a target for the comparison, and has different formats depending on the attribute specified. The specific meaning and format of each value is described with the attributes discussed previously.
Examples
AGE GT 5
USER EQ DUBMI01
COMP EQ S0C4
SYS EQ TEST
Use CADVILDD to convert an SVC dump into a format that can be loaded by the CA SymDump System dump viewer.
This utility enables you to use the CA SymDump System dump viewer to browse the storage for a dump that was not captured by the product. It does not modify the input dump data set in any way, so that data set can still be used with IBM's IPCS product to format dump information and execute verb exits. The utility simply provides an alternate viewing environment for dump storage, one that allows control block mapping, point-and-shoot access, and other dump viewer features for dumps not captured by the product.
Since CA SymDump System did not capture the input dump, Favorites, Formatted Reports and CICS Control Blocks are not available in the resulting dump tree. OS Control Blocks and Loaded Programs are included in the dump tree.
This utility:
This utility can only be used on a system on which dump capture is active.
Sample JCL for CADVILDD is show here:
// JOB //STEP1 EXEC PGM=CADVILDD //STEPLIB DD DISP=SHR,DSN=yourhlq.CCPILINK //CADVSYSD DD DISP=SHR,DSN=input.dump.dsname //SYSPRINT DD SYSOUT=*
Note:
|
Copyright © 2014 CA Technologies.
All rights reserved.
|
|