COPYCAPD subcommand — copy captured dump data

Use the COPYCAPD subcommand to generate a report showing all captured dumps present in a standalone dump and then copy the captured dump data to an output data set. The generated report contains the following information:

An ordinal number arbitrarily associated with the captured dump.
The time when the dump capture process was started.
The dump title.
If present, the name of the dump data set to which part of the captured dump was written.

Syntax

  COPYCAPD
            { captured-dump-number }
            { OUTDSNAME(dsname)|OUTDATASET(dsname)|ODS(dsname) }
            { OFILE(ddname)|OUTDDNAME(ddname)                  }
            [ SPACE(nnnn[,mmmm]) ]

-------- SETDEF-Defined Parameters -------------------------
Note: You can override the following SETDEF parameters.
See SETDEF subcommand — set defaults.

            [ ACTIVE|MAIN|STORAGE     ]
            [ DSNAME(dslist)|DATASET(dsname)       ]
            [ FILE(ddname)|DDNAME(ddname) ]
            [ PATH(hfspath) ]
            [ FLAG(severity) ]
            [ PRINT | NOPRINT ]
            [ TERMINAL | NOTERMINAL ]
            [ TEST | NOTEST ]

Parameters
captured-dump-number

Selects the captured dump to be copied. If this is omitted, COPYCAPD only produces a report describing captured dumps.

OUTDSNAME(dsname) or OUTDATASET(dsname) or ODS(dsname)

OFILE(ddname) or OUTDDNAME(ddname)

Specifies the output data set into which the dump is to be copied. An output data set must be specified. OUTDSNAME, OUTDATASET, or ODS specifies the name of the output data set. After copying, IPCS closes and deallocates the data set.
If the designated data set exists, it must be cataloged. It is dynamically allocated and used by COPYCAPD. If the data set resides on a volume that is not mounted as RESIDENT or RESERVED, MVS™ MOUNT authorization is required.

If the designated data set does not exist, the system allocates a new data set with the specified name and the defaults RECFM=FBS, LRECL=4160, and system-determined BLKSIZE are used.

OFILE or OUTDDNAME specifies the ddname of the output data set. This data set must be allocated by JCL or the TSO/E ALLOCATE command before COPYCAPD is entered.

After copying, COPYCAPD closes the data set, but does not directly deallocate it. You may use the JCL option FREE=CLOSE to release the data set at the earliest possible moment.

SPACE(nnnn[,mmmm])

Specifies the primary space allocation, nnnn, and the secondary space allocation, mmmm, if a new data set is created. Space is allocated in units of 4160-byte dump records. Excess space is released at the completion of COPYCAPD processing.
If you omit this parameter, both the primary allocation and the secondary allocation defaults are 1500 records. If only the primary allocation is specified, the secondary allocation defaults to the primary allocation.

Return codes

Code	Explanation
00	End of file reached. The input data set has been closed and a dump has been copied to the output data set.
16	Subcommand processing ended after detection of a problem in the IPCS processing environment.
20	Subcommand processing ended as a result of an attention interruption you generated. The input data set has been closed. The output data set has been loaded with part of a dump.

Example 1: Request a report only. Normally, an IPCS user will first request a report to determine the available dump titles and time stamps. Once that information has be evaluated, the user can request another COPYCAPD subcommand to select a specific dump.

Action
```
COMMAND ===>  COPYCAPD
```

Result:

When title text will not fit on the first line, it is broken at a blank or comma and continued under the time stamp.

copycapd                                                
                                                                   
                                                                           
Number  Time stamp           Title                                       
------  -------------------  --------------------------------------------
                                                                           
                                                                           
     1  09/19/2001 22:27:42  COMPON=GRS,COMPID=5752SCSDS,ISSUER=ISGREC,  
        MODULE=ISGWFP  ,EP=ISGWFPR ,ABEND=S0602,REASON=00000000          
                                                                           
1 captured dump processed

Example 2: Request to report and copy the captured dump.

Action

COMMAND ===>  COPYCAPD 1 SPACE(5000) OUTDSN(my.captured.dump)

Result

copycapd 1 space(5000) outdsn(my.captured.dump) 
                          
                                                                         
Number  Time stamp           Title                                       
------  -------------------  --------------------------------------------
                                                                           
                                                                           
     1  09/19/2001 22:27:42  COMPON=GRS,COMPID=5752SCSDS,ISSUER=ISGREC,  
        MODULE=ISGWFP  ,EP=ISGWFPR ,ABEND=S0602,REASON=00000000          
                                                                           
1 captured dump processed                                                

                                                                           
BLS18169I Dump 1 is being copied                                          
DATA SPACE ASID(X'0005') DSPNAME(00003SDU) STOKEN(X'800027000000002E')    
DATA SPACE ASID(X'0005') DSPNAME(00000SDU) STOKEN(X'800023000000002A')    
DATA SPACE ASID(X'0005') DSPNAME(00001SDU) STOKEN(X'800025000000002B')    
DATA SPACE ASID(X'0005') DSPNAME(00002SDU) STOKEN(X'800026000000002C')    
BLS18100I ASID(X'0005') DSPNAME(00000SDU) 7EE73008 not available for PRDDATA
                                                                          
IEA11004I DAT-off nucleus could not be accessed.                          
IEA11005I 23 SUMDUMP pages were not accessible.                           
IEA11005I 1 first reference page was not accessible.                      
BLS18170I 57,669 records 239,903,040 bytes, copied