Most formatted dumps are produced using the DUMPER runstream because it requires minimal information about the UDS dump file and the dump functions. The DUMPER runstream can format the dump file either as a full dump or as a Remote System Support (RSS) dump.
When you choose the RSS dump, UDS Control registers it with the Remote System Support facility. RSS transfers support files between your computer system and the Unisys Support Center.
The DUMPER runstream calls the RSS batch processor RSSDIR to process a UDS Control system dump file, creating and registering RSS files for possible
transmission to Unisys. These files are the RSS dump file and any raw dump files. The processed dump file contains a subset of information pertaining to the specific error that caused the dump.
For information about how to transmit an RSS dump file to Unisys, see the RSS
Operations Guide.
To begin interactive DUMPER runstream generation, enter
@add uds$$src*util$.dumper
The runstream solicits UDS product names and the associated DAP function file name for each product installed on your system. However, the runstream assumes default file names for all UDS products, which are illustrated in the examples that follow. You must enter DAP function file names only for files you provide as alternates.
The runstream produces a print file named UDS$*DUMP(cycle) containing the
processed dump information. You can look at this file online or print it. If you select an RSS dump, the runstream also produces RSS registered files containing the processed UDS system dump and the raw dump.
In addition to processing dumps, the DUMPER runstream provides these utilities to simplify dump handling, particularly for multifile dumps:
• List dump files
Lists all the dump files in a program file element
• Delete dump files
Deletes all raw dump files related to a dump
• Copy dump files to tape
Copies all raw dump files related to a dump to a tape
Processing UDS Dumps
Examples
The following examples show typical runstream dialogues. No entry means that the default value is used. User input is in bold type.
For Example 1 and Example 2, assume that your dump file is in UDSPROD*DUMP0(3).
Example 1
The first example shows how to create a dump registered by RSS. The files containing DAP functions for each UDS product are accepted by default.
@add uds$$src*util$.dumper
The smaller RSS-DUMP can be registered and transmitted to a remote software support center (SSC) for analysis.
Indicate the dump type or utility desired:
1 - full dump (include page banks) 2 - all threads (formatted and octal)
3 - all threads formatted, erroring thread's dbank 4 - erroring thread only (formatted and octal) 5 - rss (default)
6 - list dump files 7 - delete dump files 8 - copy dump files to tape Enter dump processing number? ▒
For multi-part dumps, prefix the file name with "+" to enter more than one file name, for example "+qual*filename(cycle)".
(The "+" is not necessary if files have original names and cycles.) Which file { Qual*Filename() } contains your dump?
udsprod*dump0(3)
Based upon file assigns of the standard release configuration files, the following UDS products are installed:
PRODUCT FILE NAMES --- --- UDSC UDS$$SRC*UTIL$ RDMS SYS$LIB$*RDMS DMS UDS$$SRC*DMS$UTIL SFS SYS$LIB$*SFSLIB
Do you wish to use alternate product files? YES or <NO> ▒___ Please indicate which UDS product is associated
with this dump RDMS, DMS, SFS or <UDSC> ▒ END SSG . . .
Processing UDS Dumps
Example 2
The second example illustrates a full dump. Note that the user file UDSPROD*UTIL$, containing dump analysis routines, replaces the standard UDS dump analysis routines for UDS Control. The standard RDMS DAP file is accepted by default, whereas the DMS and SFS DAP files are not assigned because the products are not installed.
@add uds$$src*util$.dumper
The smaller RSS-DUMP can be registered and transmitted to a remote software support center (SSC) for analysis.
Indicate the dump type or utility desired:
1 - full dump (include page banks) 2 - all threads (formatted and octal)
3 - all threads formatted, erroring thread's dbank 4 - erroring thread only (formatted and octal) 5 - rss (default)
6 - list dump files 7 - delete dump files 8 - copy dump files to tape Enter dump processing number? 1
For multi-part dumps, prefix the file name with "+" to enter more than one file name, for example "+qual*filename(cycle)".
(The "+" is not necessary if files have original names and cycles.) Which file { Qual*Filename() } contains your dump?
udsprod*dump0(3)
Based upon file assigns of the standard release configuration files, the following UDS products are installed:
PRODUCT FILE NAMES --- --- UDSC UDS$$SRC*UTIL$ RDMS SYS$LIB$*RDMS DMS UDS$$SRC*DMS$UTIL SFS SYS$LIB$*SFSLIB
Do you wish to use alternate product files? YES or <NO>... y
Source file for UDSC Flit functions <UDS$$SRC*UTIL$>...udsprod*util$
Is RDMS installed at your site? YES or <NO>...y Source file for RDMS Flit functions <SYS$LIB$*RDMS>... ▒ Is DMS installed at your site? YES or <NO>... ▒ Is SFS installed at your site? YES or <NO>... ▒ END SSG . . .
Processing UDS Dumps
Example 3
@add uds$$src*util$.dumper
The smaller RSS-DUMP may be registered and transmitted to a remote software support center (SSC) for analysis.
Indicate the dump type or utility desired: 1 - full dump (include page banks)
2 - all threads (formatted and octal)
3 - all threads formatted, erroring threads dbank 4 - erroring thread only (formatted and octal) 5 - rss (default)
6 - list dump files 7 - delete dump files 8 - copy dump files to tape
Enter dump processing number? 1 For multi-part dumps, prefix the file name with "+" to enter more than one file name, for example "+qual*filename(cycle)".
(The "+" is not necessary if files have original names and cycles.) Which file { Qual*Filename() } contains your dump? appsvn*dump0
Based upon file assigns of the standard release configuration files, the following UDS products are installed: PRODUCT FILE NAMES --- --- UDSC UDS$$SRC*UTIL$ RDMS SYS$LIB$*RDMS DMS UDS$$SRC*DMS$UTIL SFS SYS$LIB$*SFSLIB Do you wish to use alternate product files? YES or <NO> y
Source file for UDSC Flit functions <UDS$$SRC*UTIL$>... util$ Is RDMS installed at your site? YES or <NO>... ▒ Is DMS installed at your site? YES or <NO>... y
Source file for DMS Flit functions <UDS$$SRC*DMS$UTIL>. uds$$svn*dms$util Is SFS installed at your site? YES or <NO>... ▒ END SSG. ERRORS: 0 WARNING 0 SYNTAX 0 NO-FIND 0 MERGE/CORRECT LINES: 213 INTERPRETED 46 OUTPUT TIME: 10.232 STORAGE: 211/0/1/0325377 @ASG,T TEMP. W:120133 file is already assigned. @BRKPT PRINT$/TEMP @DAP DAP 12R2A (030226 1044:57) yyyy mmm dd day hhmm:ss Copyright (c) 1994-2003 Unisys Corporation. All rights reserved. UNISYS CONFIDENTIAL
Processing UDS Dumps
INPUT ************************************************************ *** UDS CONTROL DATA BANK DUMP *** *** *** *** DUMP FILE: APPSVN*DUMP0( 64) *** *** APPSVN*DUMP0P01( 8) *** *** TAKEN BY: 5JAFO 5JAFOA *** *** TAKEN ON: mm/dd/yy AT hh:mm:ss *** *** LEVEL ID: UDSC13DEV1-2 *** *** PRINTED ON: mm/dd/yy AT hh:mm:ss *** *** *** *** DUMP REASON: SUDSDP (R2) *** *** SUDS DP request *** ************************************************************ NUMBER OF BANKS 03550 (INCLUDES PCT) WAIT- DUMP FORMATTING IN PROGRESS
Example 4
For this example, assume
• appsvn*dump0(64) was previously copied to file dump0. • appsvn*dump0p01(8) was previously copied to file dump1. @add uds$$src*util$.dumper
The smaller RSS-DUMP may be registered and transmitted to a remote software support center (SSC) for analysis.
Indicate the dump type or utility desired: 1 - full dump (include page banks)
2 - all threads (formatted and octal)
3 - all threads formatted, erroring threads dbank 4 - erroring thread only (formatted and octal) 5 - rss (default)
6 - list dump files 7 - delete dump files 8 - copy dump files to tape
Enter dump processing number? For multi-part dumps, prefix the file name with "+" to enter more than one file name, for example "+qual*filename(cycle)".
(The "+" is not necessary if files have original names and cycles.) Which file { Qual*Filename() } contains your dump? +dump0
Enter the additional dump file parts in order (P01, P02, etc.) Enter a blank file name when you are done. Enter the next file { Qual*Filename() } of the dump dump1 Enter the next file { Qual*Filename() } of the dump ▒ .
. .
Processing UDS Dumps
Example 5
This example shows how to use the DUMPER utility to copy a raw UDS dump to tape.
@add uds$$src*util$.dumper
SSG 24R1 (050914 1037:51) 051010 1541:57 Copyright (c) 1993-2005 Unisys Corporation. All rights reserved. UNISYS CONFIDENTIAL skel The smaller RSS-DUMP may be registered and transmitted to a remote software support center (SSC) for analysis. Indicate the dump type or utility desired: 1 - full dump (include page banks) 2 - all threads (formatted and octal)
3 - all threads formatted, erroring threads dbank 4 - erroring thread only (formatted and octal) 5 - rss (default)
6 - list dump files 7 - delete dump files 8 - copy dump files to tape Enter dump processing number? 8
Which file { Qual*Filename() } contains your dump? appsvn*dump0
Copy the dump file(s) to tape. Enter the assign options, equipment type, and reel number. For example: T,HICL,899C Do not use spaces.
Enter asg-options,equip-type,reel-number for the tape tf,hicl,15924c @asg,tf uds$tape,hicl,15924c
Based upon file assigns of the standard release configuration files, the following UDS products are installed: PRODUCT FILE NAMES
--- --- UDSC UDS$$SRC*UTIL$ RDMS SYS$LIB$*RDMS DMS UDS$$SRC*DMS$UTIL SFS SYS$LIB$*SFSLIB
Do you wish to use alternate product files? YES or <NO>? yes
Processing UDS Dumps