Using the DUMPER Runstream

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