unisys

ClearPath Enterprise Servers

System Software Utilities

Operations Reference Manual

ClearPath MCP 17.0

April 2015 8600 0460523

NO WARRANTIES OF ANY NATURE ARE EXTENDED BY THIS DOCUMENT. Any product or related information

described herein is only furnished pursuant and subject to the terms and conditions of a duly executed agreement to

purchase or lease equipment or to license software. The only warranties made by Unisys, if any, with respect to the

products described in this document are set forth in such agreement. Unisys cannot accept any financial or other

responsibility that may be the result of your use of the information in this document or software material, including

direct, special, or consequential damages.

You should be very careful to ensure that the use of this information and/or software material complies with the

laws, rules, and regulations of the jurisdictions with respect to which it is used.

The information contained herein is subject to change without notice. Revisions may be issued to advise of such

changes and/or additions.

Notice to U.S. Government End Users: This is commercial computer software or hardware documentation developed

at private expense. Use, reproduction, or disclosure by the Government is subject to the terms of Unisys standard

commercial license for the products, and where applicable, the restricted/limited rights provisions of the contract

data rights clauses.

Unisys and ClearPath are registered trademarks of Unisys Corporation in the United States and other countries.

All other brands and products referenced in this document are acknowledged to be the trademarks or registered

trademarks of their respective holders.

8600 0460523 iii

Contents

Section 1. Introduction

Documentation Updates .................................................................................. 11 Whats New? ...................................................................................................... 11

Section 2. BARS (Activity Reporting System)

BARS Commands ............................................................................................. 22 BYE Command ............................................................................... 22 CYCLE Command .......................................................................... 22 DISPLAY Command ...................................................................... 22 HELP Command............................................................................. 23 LOAD Command ........................................................................... 23 NEWDISPLAY Command ............................................................ 24 PACK Command ............................................................................ 25 PERIOD Command ........................................................................ 25 SAVE Command ............................................................................ 25 WORDS Command ....................................................................... 26

Keywords ............................................................................................................ 26 MONITOR File Format ..................................................................................... 27

MONITOR Record 1 (Operational Information) ..................... 28 MONITOR Record 2 (Utilization Times and Counts

Information) ............................................................................... 29 MONITOR Record 3 (Queue Information) .............................. 29

Section 3. CARDLINE Utility

Printing a Data Deck .......................................................................................... 31 Examples ............................................................................................................. 32

Section 4. CDFORMAT

Creating Media .................................................................................................. 41 Limitations .......................................................................................................... 45 Examples ............................................................................................................. 46 Hardware Requirements ................................................................................ 46

Section 5. COMPARE Utility

Running the COMPARE Utility ........................................................................ 51 Using MARC to Run COMPARE ................................................. 51 Using a WFL Job to Run COMPARE ......................................... 51

Contents

iv 8600 0460523

Files Used by the COMPARE Utility ............................................................. 53 Output from the COMPARE Utility ............................................................... 53

Section 6. DCAUDITOR

DCAUDITOR RUN Statement .........................................................................61 Options .................................................................................................................61 Sample Report ................................................................................................... 62

Section 7. DCSTATUS

Execution ............................................................................................................. 71 CANDE DCSTATUS Command ................................................... 71 CANDE and WFL Run Statements ............................................ 72

DCSTATUS Options .......................................................................................... 73

Section 8. DUMPALL Utility

Understanding Key DUMPALL Concepts ................................................... 81 Using DUMPALL Commands ..................................................... 82 Use of Long File Names .............................................................. 82 Understanding File Records ....................................................... 82 Understanding Structural File Attributes ................................ 83 Specifying Data or Character Set Translations ................... 810 Special Considerations for Using BNA Logical I/O

Host Services .......................................................................... 812 Standard Commands ..................................................................................... 812

ATTRIBUTES or FILE Command .............................................. 813 CAT Command............................................................................. 814 COPY Command ......................................................................... 822 DEFINE Command ...................................................................... 840 DMPMT Command ..................................................................... 841 HEXDSK Command ................................................................... 844 LIBMT Command ....................................................................... 845 LIST Command ........................................................................... 846 TEST Command ........................................................................... 852

Interactive List Routine Commands .......................................................... 855 Interactive AGAIN Command .................................................. 856 Interactive FILE or ATTRIBUTES Command ......................... 856 Interactive CONTINUE Command ........................................... 856 Interactive LIST Command ....................................................... 856 Interactive MODE Command ...................................................858 Interactive NEXT Command ..................................................... 859 Interactive OPEN Command .................................................... 859 Interactive PREVIOUS Command ...........................................860 Interactive PRINT Command....................................................860 Interactive QUIT Command .....................................................860 Interactive RECORD Command ............................................... 861 Interactive SKIP Command ...................................................... 861

Running the DUMPALL Utility ...................................................................... 862

Contents

8600 0460523 v

Parameter Mode ......................................................................... 862 Interactive Mode ......................................................................... 863 Using the MARC Interface ....................................................... 863 Controlling I/O Exceptions ....................................................... 864

Input to the DUMPALL Utility ...................................................................... 867 Basic DUMPALL Constructs .................................................... 867 Field Definition ............................................................................. 871 Format Definition ........................................................................ 875 Key Option .................................................................................... 876 Old Specs ...................................................................................... 877 Print Option .................................................................................. 878 Record Range List ...................................................................... 878 Skip Specification....................................................................... 880

Handling Tape Files ........................................................................................ 881 Description of Tape Formats ................................................... 881 Output Files ..................................................................................885 Input Files from Labeled Tapes ...............................................885 Input Files from Unlabeled Tapes .......................................... 886 Treating Labeled Tapes as Unlabeled Tapes ...................... 886

Section 9. DUMPANALYZER

General Information ......................................................................................... 92 DUMPANALYZER Files ................................................................ 92 Family Substitution ....................................................................... 95 Saved Memory Dumps ............................................................... 95 Analysis of Memory Resident Information ............................ 95 Compatibility of MCP Levels ...................................................... 96

Running DUMPANALYZER ............................................................................. 97 Remote Operation ........................................................................ 97 ODT Operation .............................................................................. 98 Batch Operation ............................................................................ 99

User Library Interface for DUMPANALYZER ........................................... 910 Entry Points for the User Library Interface ........................... 911

Analyzing Program Dumps ........................................................................... 933 Basic Constructs ............................................................................................ 934

Number ......................................................................................... 934 File Title ......................................................................................... 935 Simple Address ........................................................................... 936 Multiple Addresses ................................................................... 940 Simple Value ................................................................................. 941

DUMPANALYZER Commands .....................................................................945 AREAS (Memory Areas) ............................................................945 ARRAYLIMIT (Array Limit) ........................................................ 950 ASD (Actual Segment Descriptor) .......................................... 950 ASDNUMBER (Actual Segment Descriptor

Number).................................................................................... 951 ASDTABLEBASE (ASD Table Base) ........................................ 958 BOXINFO (Box Information Array) .......................................... 959 BYE (Stop DUMPANALYZER) ................................................... 961 CB (Connection Block) ............................................................... 961

Contents

vi 8600 0460523

CODEFILE (Code File or Disk Family Name) ......................... 962 COREMAP (Memory Analysis) ................................................ 965 CTRACE (Controller Trace Table Analysis) ........................... 967 CU (Core Utilization) ...................................................................968 DC (Data Communications) ......................................................968 DCTRACE (Data Comm Trace) ................................................. 972 DEADLOCK (Lock Analysis) ...................................................... 974 DEBUG (Debug Option) ............................................................. 975 DESCANAL (Descriptor Analysis) ........................................... 976 DISKFILE (Disk Output File) ...................................................... 977 FIB (File Information Block) ...................................................... 978 FILELOCKS (File Region Locks) ................................................ 981 FINDSTACKS (Find Stacks) ....................................................... 982 GC (Group Configuration) .......................................................... 982 GRAPHS (Graph Stacks) ........................................................... 984 HARDINFO (Hardware Information) ....................................... 985 HDR (Disk File Header) ..............................................................986 HEADING (Heading Page) .........................................................990 HEAP (Heap Analysis) ................................................................ 991 HEAPSTACK (Heap Stack Analysis) .......................................996 HELP (Help Information) ........................................................... 998 HISTORY (History Command) ................................................ 9100 IO (I/O Analysis) ......................................................................... 9101 IOCB (I/O Control Block) .......................................................... 9110 IOCD (Direct I/O Control Block) .............................................. 9111 IOTRACE (I/O Trace Table) .......................................................9112 JOB (Job Command) ................................................................ 9115 KEEP (Keep Command) ........................................................... 9116 LIB (Library) ..................................................................................9117 LINKCHECK (Check Memory Link) ........................................ 9119 LINKS (Memory Links) ..............................................................9121 LOADXREF (Load Cross-Reference Files) .......................... 9123 LOCKS (Lock Analysis) ............................................................. 9124 LOGRECORD (Log Record Analysis) .................................... 9125 LSN (Analyze Datacom Station) ............................................ 9126 MASK (Mask Register) ............................................................ 9127 MAXPRINTSIZE (MAXPRINT) ................................................. 9129 MD (Memory Dump) ................................................................ 9129 MEM (Memory) ......................................................................... 9130 MEMPOOL (Analyze Memory Pool) ..................................... 9131 MEMRQ (Memory Result Queue) ........................................ 9133 MESSAGES (Data Comm Messages) ................................... 9133 MIT (Mirror Information Table) .............................................. 9134 MIX (Mix Number) .................................................................... 9135 MODE (Set Mode) ..................................................................... 9136 MSCW (Mark Stack Control Word) ...................................... 9141 NAMES (MCP Names and Addresses) ................................ 9142 NSP (Network Support Processor Tables) ......................... 9144 OLAYINFO (Overlay File Allocation) ..................................... 9145 OPT (Option) ............................................................................... 9147 PATTERN (Pattern Register) .................................................. 9148 PC or PRINTCODE (Print Mnemonic) ................................... 9150

Contents

8600 0460523 vii

PIB (Process Information Block) ........................................... 9151 PMQ (Primitive Message Queue) ......................................... 9154 POOL (Analyze Pool Area) ...................................................... 9156 PORT (Port File) ......................................................................... 9157 PRIMITIVEDUMP (Primitive Dump Analysis)...................... 9160 PRINTARRAY (Print Array) ...................................................... 9162 PRINTER (Printer Route) .......................................................... 9163 PRINTHEAP (Print Heap) ......................................................... 9164 PROCSTACKS (Processor Stacks) ........................................ 9165 PROGRAMDUMP (Program Dump) ...................................... 9165 PV or PRINTVAL (Print Value) ................................................. 9167 QUEUE (DCALGOL Queue) ..................................................... 9169 RCWTOSEQ (Convert RCW Into Sequence

Number).................................................................................. 9174 READYQ (Ready Queue) ......................................................... 9175 RECESS (Recess DUMPANALYZER) .................................... 9175 RELEASE (Release File) ............................................................ 9176 RELX (Release Now) ................................................................ 9176 REMOTE (Remote Terminal) .................................................. 9177 REPEAT (Repeat Command) .................................................. 9177 RESULTQ (Result Queue) ....................................................... 9178 SAVE (Save to Disk) .................................................................. 9179 SB (Structure Block) ................................................................. 9180 SEARCH (Search for Pattern) ................................................. 9181 SF (System Factors) ................................................................. 9184 SFV (System File Vector) ......................................................... 9184 SHAREDBUFF (Shared Buffers) ............................................. 9184 SHOW (Show Previous Input) ............................................... 9185 SSAQ (Storesafe Alert Queue) .............................................. 9185 STACK (Format Stack Contents) ........................................... 9186 STACKWINDOW (Stack Window) ........................................ 9194 STOP (Stop DUMPANALYZER) .............................................. 9195 SUBPORT (Subport Analysis) ................................................. 9195 SUMMARY (Summarize Stack Information) ...................... 9198 TAB (Task Attribute Block) .................................................... 9203 TCPINFO (Task Control Processor Information

IOM Systems) ...................................................................... 9205 TERMINAL (Terminal Characteristics)................................. 9207 TRACE (Trace Table) ................................................................ 9209 USE (Use Saved Commands) ..................................................9211 USERCOMMAND Command ..................................................9211 USERLIB (User Library Command)........................................ 9212 UTILIZATION (System Utilization Statistics)....................... 9213 WHERE (Show Global Identifier) ........................................... 9213 WHO (Show D[0] Global Identifier) ....................................... 9214 @ (Last Referenced Stack) ..................................................... 9215 $ (Last Referenced Segment) ................................................ 9216 ?AX BRK (Interactive Break) ................................................... 9217 Error Messages ......................................................................... 9217

Contents

viii 8600 0460523

Section 10. EMAIL Utility

Function ............................................................................................................. 104 Options .............................................................................................................. 105 Installing the EMAIL Utility ........................................................................... 107 Considerations for File Attachments ......................................................... 109 Running the EMAIL Utility ............................................................................. 109 Examples .......................................................................................................... 1011 Errors and Warnings .................................................................................... 1013

Retry Mechanism ...................................................................... 1015

Section 11. FILECOPY Utility

Processing FILECOPY Requests .................................................................. 111 Constraints .................................................................................... 112 Input to the FILECOPY Utility .................................................... 112

Basic FILECOPY Constructs .......................................................................... 114 FILECOPY Task Requests .............................................................................. 118

CREATED, ACCESSED, UPDATED, and

ANYUPDATED Requests ...................................................... 118 ADDED and ALLFILES Requests ............................................ 1110 EXPIRED Request ....................................................................... 1111

FILECOPY Modifiers ...................................................................................... 1112 FILECOPY Options ......................................................................................... 1120 Splitting WFL COPY Statements .............................................................. 1124 WFL Failures .................................................................................................... 1125 Index Files ........................................................................................................ 1125 Sample FILECOPY Runs ............................................................................... 1126

Section 12. FILEDATA Utility

Running the FILEDATA Utility ...................................................................... 122 Input Options ................................................................................................... 122 Output Options................................................................................................ 123 Selecting the Files to Be Reported On ..................................................... 124

Running FILEDATA with a Privileged Usercode or

from an ODT............................................................................ 124 Running FILEDATA with a Nonprivileged Usercode .......... 124 Running FILEDATA with a Request to Access

Headers from a Library Maintenance Tape .................... 125 Running FILEDATA with a Request to Access

Headers from a Container ................................................... 126 Effects of Family Substitution ..................................................................... 127 Error Reporting ................................................................................................ 127 Database Generation and Reuse ................................................................ 127

General Behavior ......................................................................... 128 Reuse for Particular Reports ................................................... 128 Database Version Levels .......................................................... 129 Database Examples .................................................................... 129

Sample FILEDATA Runs ............................................................................... 1210 WFL Jobs ..................................................................................... 1210

Contents

8600 0460523 ix

CANDE Commands ................................................................... 1211 Task Requests ................................................................................................ 1212

ARCHIVEINFO Request ............................................................ 1213 AREASUMMARY Request ....................................................... 1215 ATTRIBUTES Request ............................................................... 1216 BACKUP Request...................................................................... 1220 CATALOGINFO Request ......................................................... 1223 CHECKERBOARD Request ..................................................... 1225 CODEFILEINFO Request .......................................................... 1226 COMPATIBILITY Request ....................................................... 1230 COPYDECK Request ................................................................ 1233 DEFINEOUTPUT Request ........................................................ 1234 FILENAMES Request ................................................................ 1235 HEADERCONTENTS Request ................................................ 1238 INCOMPATIBILITY Request ................................................... 1240 NAMELIST Request .................................................................. 1243 NOREPORTS Request ............................................................. 1244 STRUCTUREMAP Request ..................................................... 1246 TAPEDIR Request ..................................................................... 1247

FILEDATA Modifiers ..................................................................................... 1248 ABBREVIATED ........................................................................... 1248 ALL ................................................................................................ 1248 ALTERDATE ................................................................................ 1248 APL ............................................................................................... 1248 ARCHIVE ...................................................................................... 1248 ARCHIVEBACKUP ..................................................................... 1249 AREALENGTH ............................................................................ 1250 AREAS .......................................................................................... 1250 AREASINUSE .............................................................................. 1250 AREASIZE .................................................................................... 1250 ATTMODIFYDATE ...................................................................... 1251 BACKUPDATE ............................................................................. 1251 BACKUPSN .................................................................................. 1251 BADINFO ...................................................................................... 1251 BLOCKSIZE ................................................................................. 1252 BLOCKSTRUCTURE .................................................................. 1252 CATALOGUE ............................................................................... 1252 CCSVERSION .............................................................................. 1252 CLEARAREAS ............................................................................. 1252 CODEINFO .................................................................................. 1253 CODEVERSION .......................................................................... 1253 CONTAINER ................................................................................ 1256 COPYDESTDATE ....................................................................... 1256 COPYSOURCEDATE ................................................................. 1256 CREATIONDATE ........................................................................ 1256 CRUNCHED ................................................................................. 1256 CYCLE ........................................................................................... 1256 DATABASE ................................................................................. 1256 DELETED ...................................................................................... 1257 DECK ............................................................................................ 1257 DIRECTORY ................................................................................ 1257 DMAUDITFILE ............................................................................ 1258

Contents

x 8600 0460523

EXECUTEDATE ........................................................................... 1258 EXTDELIMITER ........................................................................... 1258 EXTMODE ................................................................................... 1258 FAMILYNAME ............................................................................ 1258 FILECLASS ................................................................................... 1259 FILEKIND ...................................................................................... 1259 FILELENGTH ................................................................................ 1260 FILENAME ................................................................................... 1260 FILEORGANIZATION ................................................................. 1260 FILESERIALNO ........................................................................... 1260 FILESTRUCTURE ........................................................................ 1260 FILETYPE...................................................................................... 1260 FRAMESIZE ................................................................................. 1260 GUARDFILE ................................................................................. 1260 IDENTITY ...................................................................................... 1261 INTMODE ..................................................................................... 1261 INUSE ............................................................................................ 1261 LASTACCESSDATE .................................................................... 1261 LASTRECORD ............................................................................. 1261 LEVEL ........................................................................................... 1262 LIBMAINTDIR ............................................................................. 1262 LICENSEKEY ............................................................................... 1262 LINEWIDTH ................................................................................. 1262 LOCKEDFILE ............................................................................... 1263 MAXRECSIZE .............................................................................. 1263 MINRECSIZE ............................................................................... 1263 NAMESONLY ............................................................................. 1263 NEWDATABASE ........................................................................ 1263 NONRESIDENTONLY ................................................................ 1263 NOTE ............................................................................................ 1264 OPENDATE ................................................................................. 1264 PACKNAME ................................................................................ 1264 PAGESIZE .................................................................................... 1264 PPB ............................................................................................... 1264 PRINTER ...................................................................................... 1264 PRODUCT .................................................................................... 1264 PROTECTION .............................................................................. 1265 RAWHEADERS .......................................................................... 1265 READDATE.................................................................................. 1265 RELEASEID .................................................................................. 1265 REMOVED ................................................................................... 1265 RESIDENTONLY ......................................................................... 1265 SAVEFACTOR ............................................................................. 1266 SCREEN........................................................................................ 1266 SECURITY .................................................................................... 1266 SERVICES .................................................................................... 1266 SPO ............................................................................................... 1266 TAPE ............................................................................................. 1266 TAPEHEADERS .......................................................................... 1267 TIMESTAMP ............................................................................... 1267 TITLE ............................................................................................. 1267 TOTALSECTORS ........................................................................ 1268

Contents

8600 0460523 xi

TTY ................................................................................................ 1268 UNITS ........................................................................................... 1268 USERINFO ................................................................................... 1268 VERSION ...................................................................................... 1268 WARNINGS ................................................................................. 1268 WORKLOADGROUP ................................................................. 1268 WRAPPEDFILES ......................................................................... 1269

Numeric Report Requests.......................................................................... 1269 Using System Commands to Initiate FILEDATA ................................... 1269

DIR (Directory) Command ....................................................... 1269 TDIR (Tape Directory) Command .......................................... 1270

Basic FILEDATA Constructs ........................................................................ 1271

Section 13. HARDCOPY and PRINTCOPY

HARDCOPY........................................................................................................ 131 Running HARDCOPY ...................................................................................... 132 Disk File Format ............................................................................................... 133 PRINTCOPY ...................................................................................................... 135 Running PRINTCOPY ...................................................................................... 135

Section 14. INTERACTIVEXREF Utility

INTERACTIVEXREF Operation ....................................................................... 141 Files Used by the INTERACTIVEXREF Utility ........................ 142 Running the INTERACTIVEXREF Utility .................................. 143 Input to the INTERACTIVEXREF Utility .................................. 144 Basic INTERACTIVEXREF Constructs ..................................... 144

INTERACTIVEXREF Commands ................................................................. 1410 DECLARATIONS Command ..................................................... 1411 EXPAND Command .................................................................. 1417 HELP Command......................................................................... 1421 LIST Command .......................................................................... 1421 LOAD Command ....................................................................... 1423 LOCATE Command ................................................................... 1423 MERGE and COINCIDENCE Commands .............................. 1424 QUALIFY Command ................................................................. 1427 RANGE Command ..................................................................... 1428 REFERENCE Command ............................................................ 1429 SAVE Command ........................................................................ 1432 SET and RESET Commands .................................................... 1432 STOP Command ........................................................................ 1433 SUMMARY Command ............................................................. 1433 SYMBOL Command ................................................................. 1434 TERMINAL Command .............................................................. 1434 TEXT Command ......................................................................... 1435 WHAT Command ...................................................................... 1436 WHATFILES Command ............................................................ 1436 WHERE Command .................................................................... 1436

Using the INTERACTIVEXREF Utility......................................................... 1437 Use with Improperly Sequenced Source ........................... 1437

Contents

xii 8600 0460523

Use with COBOL74 AND COBOL85 .................................... 1437 Use with C .................................................................................. 1438 Use with FORTRAN77 ............................................................. 1438 Use with PASCAL and PASCAL83 ........................................ 1438

Example INTERACTIVEXREF Program ..................................................... 1439

Section 15. INVENTORY Utility

Using the INVENTORY Utility ........................................................................ 151 Report File Destination .............................................................. 152 Saving the Report to Another File Title or Family .............. 152 Security Administrator Status ................................................. 152 Report Format ............................................................................. 152 Example Report ........................................................................... 153 Scheduling a Periodic Run of the INVENTORY

Utility ......................................................................................... 155 Limitations .................................................................................... 155

Viewing the Report ........................................................................................ 155 Comparing the Report ............................................................... 156

Section 16. KEYEDIO Support

Physical Structure of KEYEDIO Files .......................................................... 162 Coarse Tables .............................................................................. 162 Fine Tables .................................................................................... 162 Data Blocks .................................................................................. 162 Locating Data ............................................................................... 162

File and KEYEDIO Library Management .................................................... 163 Removing and Installing a KEYEDIO Library ............................................ 164 KEYEDIO Program Interface ........................................................................ 164 Indexed KEYEDIO File Attributes ................................................................ 165

Setting the FILEORGANIZATION Attribute ........................... 165 Setting the EXCLUSIVE Attribute ............................................ 166 Setting the Value of the BUFFERS Attribute ....................... 166 Choosing a Value for the BLOCKSIZE Attribute .................. 168

KEYEDIO Procedures .................................................................................... 1611 Key Information ......................................................................... 1613 File Access Information .......................................................... 1614 Results Returned ...................................................................... 1614 ISMGETKEYSTRUCTURE Procedure .................................... 1614 ISMOPEN Procedure ................................................................ 1616 ISMCLOSE Procedure ............................................................... 1617 ISMSTART Procedure .............................................................. 1618 ISMSEQUENTIALWRITE Procedure ..................................... 1619 ISMSEQUENTIALREAD Procedure ....................................... 1620 ISMRANDOMWRITE Procedure ............................................ 1621 ISMRANDOMREAD Procedure ............................................. 1622 ISMREWRITE Procedure ......................................................... 1623 ISMDELETE Procedure ............................................................ 1624 ISMSETUPLIMIT Procedure .................................................... 1625

The KEYEDIO File Structure ....................................................................... 1626

Contents

8600 0460523 xiii

Segment 0 (Zero) of the File .................................................. 1626 Block Information Layout........................................................ 1629 Coarse Table Layout ................................................................ 1631 Fine Table Layout ...................................................................... 1631 Key Information Table Layout ............................................... 1632 Logical Layout of a KEYEDIO File .......................................... 1632 Inserting Keys ............................................................................ 1634

Recovery Procedures .................................................................................. 1637

Section 17. LOGANALYZER

Installing Related Libraries ............................................................................ 171 Analyzing Logs from Different Releases .................................................. 172 Merging Entries from the SUMLOG and SECURITYLOG ...................... 172 Finding Missing Log Entries ......................................................................... 173 Running LOGANALYZER ............................................................................... 173 Interactive LOGANALYZER Commands .................................................... 174

QUIT Command ........................................................................... 174 NEXT+ Command ........................................................................ 175 NEXT- Command ......................................................................... 175 PAGE Command .......................................................................... 175 NEXT LOG Command ................................................................. 175

Option List ........................................................................................................ 176 LOGANALYZER Options ...............................................................................1710

Selection Options ......................................................................1710 Output Options.......................................................................... 1742

Input Examples .............................................................................................. 1746 LOGANALYZER Output ............................................................................... 1748

Section 18. LOGGER

LOGGER Operation ......................................................................................... 182 LOGGER Input .................................................................................................. 184

Input-Specification Commands ............................................... 184 Report-Specification Commands ........................................... 1811

Report-Specification Command Examples .............................................1821 File Data Items ............................................................................................... 1837

Long-Term Report Generation .............................................. 1843 Extended Time Period Reports ............................................. 1843 Year-to-Date Totals Reports .................................................. 1844

Program Operation Characteristics.......................................................... 1847 REPORT Commands and LOGREPORTS File ..................... 1847 Calculation of Charges ............................................................. 1848 Corrections ................................................................................. 1848 Files and File Equation ............................................................. 1848 $NODUMP Compile-Time Option ......................................... 1849 Program Information ................................................................ 1849 Overall Organization ................................................................. 1849 Structure of Program Files ..................................................... 1850 Tables Used by the EDITOR Procedure .............................. 1851 Files Used by the Program ..................................................... 1853

Contents

xiv 8600 0460523

Section 19. Mathematical Functions

Single-Precision Functions ........................................................................... 192 ARCCOS Function ....................................................................... 192 ARCSIN Function ......................................................................... 192 ARCTAN Function ....................................................................... 192 ARCTAN2 Function ..................................................................... 193 COS Function ............................................................................... 193 COSH Function ............................................................................ 193 COTAN Function .......................................................................... 194 ERF Function ................................................................................ 194 ERFC Function .............................................................................. 194 EXP Function ................................................................................ 195 Single-Precision Exponentiation ............................................. 195 GAMMA Function ....................................................................... 195 LN Function................................................................................... 195 LNGAMMA Function .................................................................. 195 LOG Function ............................................................................... 196 RANDOM Function ..................................................................... 196 SIN Function ................................................................................. 197 SINH Function .............................................................................. 197 SQRT Function ............................................................................. 197 TAN Function ............................................................................... 197 TANH Function ............................................................................ 197

Double-Precision Functions ......................................................................... 198 DARCCOS Function .................................................................... 198 DARCSIN Function ...................................................................... 198 DARCTAN Function .................................................................... 198 DARCTAN2 Function .................................................................. 198 DCOS Function ............................................................................ 199 DCOSH Function ......................................................................... 199 DERF Function ............................................................................. 199 DERFC Function ........................................................................... 199 DEXP Function ............................................................................. 199 DGAMMA Function .................................................................. 1910 DLGAMMA Function ................................................................ 1910 DLN Function.............................................................................. 1910 DLOG Function .......................................................................... 1910 DSIN Function ............................................................................ 1910 DSINH Function ......................................................................... 1910 DSQRT Function ........................................................................ 1910 DTAN Function ........................................................................... 1911 DTANH Function ........................................................................ 1911 Double Precision Exponentiation ........................................... 1911

Complex Functions ........................................................................................ 1911 Definitions Used in Complex Function

Descriptions ........................................................................... 1911 CABS Function ............................................................................1912 CCOS Function ............................................................................1912 CEXP Function ............................................................................ 1913 CLN Function .............................................................................. 1913 CSIN Function ............................................................................ 1913

Contents

8600 0460523 xv

CSQRT Function ........................................................................ 1914 Complex Exponentiation ......................................................... 1914

Common Constants ..................................................................................... 1915 Permissible Argument Ranges ................................................................. 1916

Section 20. MCP TapeStack Utility

Packaging Information ................................................................................... 202 Initiating the MCP TapeStack Utility .......................................................... 207 STACK Function ............................................................................................... 207 UNSTACK Function ......................................................................................... 208 APPEND Function............................................................................................ 209 ENCRYPT Function ....................................................................................... 2010 DECRYPT Function ....................................................................................... 2010 ENCRYPT&STACK Function ........................................................................ 2011 ENCRYPT&APPEND Function .................................................................... 2012 UNSTACK&DECRYPT Function ................................................................. 2012 CONSOLIDATE Function ............................................................................. 2013 DUPLICATE Function .................................................................................... 2013 INVALIDATE Function .................................................................................. 2014 DIRECTORY Function ................................................................................... 2014 SIZE Function.................................................................................................. 2015 RECREATEDIRECTORY Function ............................................................... 2016 SETTINGS Function ....................................................................................... 2016 HELP Function ................................................................................................ 2017

Section 21. PATCH Utility

Running the PATCH Utility ............................................................................. 211 Using a WFL Job to Run the PATCH Utility........................... 211 Using CANDE to Run the PATCH Utility ................................ 212

Files Used by the PATCH Utility .................................................................. 213 Patch Control Records................................................................................... 214

Patch Compiler Control Records ($ Records)...................... 214 Patch Literal Compiler Records ($& Records) ..................... 216 Patch Delimiter Records ($# Records) .................................. 216 Patch Comment Records ($: Records) .................................. 216 Patch Patch Records ($- Records) .......................................... 217 Patch WFL Records ($* Records) ........................................... 217 Patch Control Records ($. Records) ....................................... 217

Patch Control Record Options ................................................................... 2110 $.BRIEF Option ............................................................................ 2110 $.COBOL Option ......................................................................... 2110 $.COBOL74 Option .................................................................... 2110 $.COBOL85 Option .................................................................... 2111 $.COMPARE Option .................................................................. 2111 $.COMPILE Option ..................................................................... 2112 $.CONFLICT Option ................................................................... 2112 $.COUNT Option ........................................................................ 2113 $.CYCLE Option .......................................................................... 2113 $.DELETE Option ........................................................................ 2113

Contents

xvi 8600 0460523

$.DELIMOPT Option ................................................................. 2114 $.DISK Option ............................................................................. 2115 $.DISK $ Option .......................................................................... 2116 $.DUMP Option .......................................................................... 2116 $.EOF Option ............................................................................... 2116 $.ERRLIST Option ....................................................................... 2116 $.EXECUTE Option ..................................................................... 2117 $.FILE, $.DISK $, and $.PATCHDECK Options ..................... 2117 $.FLAG Option.............................................................................2118 $.GUARD Option ........................................................................2118 $.INSERT Option .........................................................................2119 $.JOB Option .............................................................................. 2120 $.LABEL Option .......................................................................... 2121 $.LIST Option............................................................................... 2121 $.LISTD Option ............................................................................ 2121 $.LISTI Option ............................................................................ 2122 $.LISTN Option........................................................................... 2122 $.LISTP Option ........................................................................... 2122 $.MARK Option ......................................................................... 2122 $.MARKBLANK Option ............................................................ 2123 $.MOVE Option .......................................................................... 2124 $.NDLII Option ........................................................................... 2125 $.NEW Option ............................................................................ 2125 $.OUT Option ............................................................................. 2125 $.PASCAL Option ...................................................................... 2125 $.PATCHDECK Option .............................................................. 2126 $.RETAIN Option ....................................................................... 2126 $.RPG Option.............................................................................. 2126 $.SINGLE Option ........................................................................ 2126 $.SQUASH Option ..................................................................... 2127 $.TOTAL Option ......................................................................... 2127 $.VERSION and $.CYCLE Options ......................................... 2127 $.WIDE Option ........................................................................... 2128 $.WIDECARD Option ................................................................ 2129

Debug $. Records ......................................................................................... 2129 Debug Options .......................................................................... 2130

Examples of PATCH Utility Input .............................................................. 2132

Section 22. PCDRIVER Utility

Running the PCDRIVER Utility ..................................................................... 222 Error Messages ............................................................................................. 2210 LAUNCHER ..................................................................................................... 2216

LAUNCHER on Windows ........................................................ 2216 LAUNCHER on LINUX............................................................... 2220

Internationalization Issues .......................................................................... 2223

Section 23. PDIR, PMIX, and PUNIT Utilities

Using WFL......................................................................................................... 231 Using CANDE or MARC ................................................................................. 232

Contents

8600 0460523 xvii

Using the PDIR Command ............................................................................ 233 PDIR Request ................................................................................................... 233 Error Messages ............................................................................................. 2310 PMIX Utility ...................................................................................................... 2311 PUNIT Utility ................................................................................................... 2313

Section 24. RLTABLEGEN Utility

General Information ....................................................................................... 241 Installation Defined Tape Labels ............................................. 241 Running the RLTABLEGEN Utility ........................................... 242

Input to the RLTABLEGEN Utility ................................................................ 242 Label Description Format ......................................................... 242 RLTABLEGEN Commands ......................................................... 242

Section 25. SORT Utility

SORT Parameters ........................................................................................... 252 Input Options ............................................................................... 253 Output Options............................................................................ 253 Compare Procedure ................................................................... 254 Number of Tapes ........................................................................ 254 Record Size................................................................................... 255 Memory Size ................................................................................ 255 Disk Size ........................................................................................ 259

SORT Operating Modes .............................................................................. 2510 Disk-Only Mode ......................................................................... 2511 Tape-Only Mode ....................................................................... 2512 ITD Mode .................................................................................... 2513 Memory-Only Mode................................................................. 2514

SORT Files....................................................................................................... 2515 Control Files ............................................................................... 2515 Work Files ................................................................................... 2515 Tape Files .................................................................................... 2516

Tag Sorting ..................................................................................................... 2516 Restart Capability .......................................................................................... 2518

RESTART Parameter Values................................................... 2519 Restarting during Stringing Phase ........................................ 2521

Error Recovery .............................................................................................. 2522 Control File Input Errors .......................................................... 2522 Control File Output Errors ...................................................... 2522 Work File Input Errors.............................................................. 2523 Work File Output Errors .......................................................... 2523 User Output File Errors ........................................................... 2523 Work File Input Errors during User Output ........................ 2523

Using SORT in Various Languages .......................................................... 2524 Using SORT in COBOL74 or COBOL85 .............................. 2524 Using SORT in ALGOL .............................................................2528 Using SORT in C ........................................................................2529 Using SORT in FORTRAN77 .................................................. 2533 Using a Procedural Interface for SORT .............................. 2536

Contents

xviii 8600 0460523

SORT Error Messages ................................................................................ 2550 SORT Statistical Array ................................................................................ 2554

Section 26. SSH Utility

Using the SSH Client ...................................................................................... 261 User Authentication ....................................................................................... 263 Getting Started ................................................................................................ 265 Creating a WFL Job to Execute an SSH Command ............................... 267 Terminating the SSHCLIENTSUPPORT Library ........................................ 268 Non-Diagnostic Logging Supported by SSHCLIENT .............................. 269 Diagnostic Log Levels Supported by SSHCLIENT ................................ 2610 Details of the SSH Client Configuration File ........................................... 2611 Removing *SYSTEM/SSHCLIENT/REQUEST files ................................. 2614

Section 27. V Series Conversion Utilities

COPYV2A Utility .............................................................................................. 272 Command Interface ................................................................... 272 Screen Interface .......................................................................... 278

PRINTV2A Utility ............................................................................................ 2713 Label Equation Interface ......................................................... 2713 Screen Interface ........................................................................ 2713

PRINTA2V Utility ............................................................................................ 2715 Label Equation Interface ......................................................... 2715 Screen Interface ........................................................................ 2715

Section 28. XREFANALYZER Utility

XREFANALYZER Files ..................................................................................... 282 Invoking XREFANALYZER ............................................................................. 282

Implicit Execution ....................................................................... 282 Explicit Execution ........................................................................ 282 Compile Time Options ............................................................... 284 Fatal Error Messages ................................................................. 284

Appendix A. GENERALSUPPORT Entry Points

CHANGELFILE .................................................................................................... A1 REMOVELFILE ................................................................................................... A3 MYOPTIONSUPPORT ...................................................................................... A5

Appendix B. Understanding Railroad Diagrams

Railroad Diagram Concepts ............................................................................ B1 Paths................................................................................................. B1 Constants and Variables.............................................................. B2 Constraints ..................................................................................... B3

Contents

8600 0460523 xix

Following the Paths of a Railroad Diagram ................................................B6 Railroad Diagram Examples with Sample Input ........................................ B7

Index ..................................................................................................... 1

Contents

xx 8600 0460523

8600 0460523 xxi

Figures

72. GRAPH Option Output .................................................................................................... 77

73. TERMINAL Option Output ............................................................................................. 78

74. STATION Option Output ................................................................................................ 79

91. Mask Word Example .................................................................................................. 9128

92. Pattern Word Example ............................................................................................... 9149

161. Coarse Table Layout ................................................................................................... 1631

162. Fine Table Layout ......................................................................................................... 1631

163. KEYEDIO File Layout ................................................................................................... 1633

164. Inserting a Key .............................................................................................................. 1635

165. Inserting a Key into a Full Table ............................................................................... 1636

181. Year-to-Date Record 1 Format ................................................................................. 1845

182. Year-to-Date Record 2 Format ................................................................................. 1846

183. Year-to-Date Record 3 Format ................................................................................. 1846

184. BREAKINFO Table ........................................................................................................ 1851

185. EDITORINFO Table ....................................................................................................... 1852

186. INCLCHECK and EXCLCHECK Tables ...................................................................... 1852

187. TAITEMS Table ............................................................................................................. 1853

251. Creating a Tag ............................................................................................................... 2517

252. Tag Sort, Nondisk Input File ...................................................................................... 2518

253. Tag Sort, Disk Input File ............................................................................................. 2518

271. Initial COPYV2A Screen ................................................................................................ 279

272. Main COPYV2A Screen............................................................................................... 2710

273. COPYV2A Directory Screen ....................................................................................... 2711

274. COPYV2A Copy or Add Screen ................................................................................ 2712

275. PRINTV2A Screen ........................................................................................................ 2714

276. PRINTA2V Screen ........................................................................................................ 2715

Figures

xxii 8600 0460523

8600 0460523 xxiii

Tables

51. COMPARE Utility Files .................................................................................................... 53

81. Standard DUMPALL Commands ................................................................................ 812

82. Default Field Type .......................................................................................................... 872

91. UDATA Parameter Contents for Stack Information Request,

SUBTYPE=0 ................................................................................................................ 920

92. UDATA Parameter Contents for Stack Information Request,

SUBTYPE=1 ................................................................................................................. 920

93. UDATA Parameter Contents for Stack Information Request,

SUBTYPE=0,1 ............................................................................................................. 921

94. UDATA Parameter Returns for Extended Stack Information Request,

SUBTYPE=0,1 ............................................................................................................. 921

95. UDATA Parameter Returns for Dump Information Request ............................. 923

96. Rules for Using Quotation Marks and Apostrophes ............................................ 936

97. SPACEUSAGE Field Items ............................................................................................ 947

98. Mode Option Descriptions ........................................................................................ 9137

99. Creating BINDINFO Information ............................................................................... 9140

910. RSVP Responses for a NO FILE Condition with the Mode Command .......... 9140

911. Response to a WRONG CODE FILE Message ..................................................... 9141

912. Mode Descriptions ...................................................................................................... 9168

913. Queue Set Specifications .......................................................................................... 9170

914. Single Queue Specification ........................................................................................9171

915. MCS Specification........................................................................................................ 9172

916. File Number Specification .......................................................................................... 9172

917. Output Options............................................................................................................. 9172

101. EMAIL Errors ................................................................................................................. 1013

102. EMAIL Warnings .......................................................................................................... 1014

111. Two-Digit Years in the FILECOPY Timestamp ........................................................ 117

112. Components of the CREATED, ACCESSED, UPDATED, and

ANYUPDATED Requests ......................................................................................... 119

113. Components of the ADDED and ALLFILES Requests ......................................... 1110

114. Components of the EXPIRED Request .................................................................... 1111

115. Components Used in FILECOPY Modifiers ............................................................ 1115

116. FILECOPY Options ........................................................................................................ 1121

Tables

xxiv 8600 0460523

121. FILEDATA Task Requests and Report Types .......................................................... 121

122. FILEDATA Input Options .............................................................................................. 123

123. FILEDATA Output Options........................................................................................... 123

124. Code File Status Information .................................................................................... 1255

141. Compiler Control Options for Producing XREFILES .............................................. 142

161. Key Word Format ........................................................................................................ 1613

162. File Access Values ....................................................................................................... 1614

171. DIAGNOSTICS option minor types .......................................................................... 1724

172. DIAGNOSTICS Examples ........................................................................................... 1725

173. LOGANALYZER Examples ......................................................................................... 1746

174. Interface Type Abbreviations ................................................................................... 1748

181. JOBSUMMARY File Data Items ............................................................................... 1837

182. STATISTICS File Data Items ...................................................................................... 1839

183. FILEIODATA File Data Items ..................................................................................... 1840

184. DRCDATA File Data Items ......................................................................................... 1842

185. Files Used by LOGGER ............................................................................................... 1853

191. TAN/COTAN Calculation ............................................................................................... 194

192. Common Constants .................................................................................................... 1915

193. Permissible Argument Ranges ................................................................................ 1916

194. Function Names ........................................................................................................... 1918

251. Determining SORT Operating Mode ...................................................................... 2510

252. RESTART Parameter Values...................................................................................... 2520

253. Input Attributes for the SORTFILES Procedures ................................................. 2537

254. Clauses That Can Be Specified in the SORTFILES Info String ......................... 2538

255. Input Attributes for the SORTPROCS Procedure ............................................... 2540

256. Input Attributes for the MERGEFILES Procedure ............................................... 2542

257. Input Attributes for the MERGEPROCS Procedure ........................................... 2544

258. Input Attributes for the TTABLE Procedure ........................................................ 2546

259. Fatal Error Messages .................................................................................................. 2551

2510. Nonfatal Error Messages .......................................................................................... 2553

2511. Contents of the SORT Statistical Array ................................................................ 2555

2512. SORT Collating Sequence ......................................................................................... 2559

271. TASKVALUE task attribute .......................................................................................... 267

272. Global Parameters ........................................................................................................ 2611

B1. Elements of a Railroad Diagram................................................................................... B2

8600 0460523 11

Section 1 Introduction

This manual provides information about system utilities, V Series conversion utilities,

KEYEDIO support, Peripheral Test Driver (PTD), and mathematical functions.

This manual is written for applications programmers, system support personnel, and

operators.

Documentation Updates

This document contains all the information that was available at the time of

publication. Changes identified after release of this document are included in problem

list entry (PLE) 19022625. To obtain a copy of the PLE, contact your Unisys

representative or access the current PLE from the Unisys Product Support website:

http://www.support.unisys.com/all/ple/19022625

Note: If you are not logged into the Product Support site, you will be asked to do so.

Whats New?

New or Revised Information Location

Added the NOCOPY option as one of the

options that can be specified with the

file specifications to indicate how the

FILECOPY would run.

Section 11:

FILECOPY Options

Updated information about analyzing

logs generated from different releases.

Section 17:

Analyzing Logs from Different Releases

Added information about finding log

entries that are not provided by the

LOGANALYZER report.

Section 17:

Finding Missing Log Entries

Updated information about the MAINT

option that is one of the options that

selects log records related to the

hardware and software configurations of

the system and the problems that are

encountered during operation.

Section 17:

Configuration and Maintenance Options

http://www.support.unisys.com/all/ple/19022625

Introduction

12 8600 0460523

New or Revised Information Location

Added a new diagnostic option. Section 17:

Diagnostics Options

Updated heading page information. Section 17:

LOGANALYZER Output

Added VSS3 as an optional parameter to

the FILE selection option.

Section 17:

Job, Task, and Session Options

Additional Selection Options

Updated installation steps for

LAUNCHER in the LINUX environment.

Section 22:

Installing Launcher in a Linux Operating

System

Added examples of commands for the

LAUNCHER running on Linux PCs.

Section 22:

Commands for the LAUNCHER Running

on Linux PCs

8600 0460523 21

Section 2 BARS (Activity Reporting System)

This section describes the BARS utility program, which provides a way to monitor

system performance by sampling various system utilization information.

The BARS utility program monitors the performance of the system and displays it in

the form of numeric values and bar graphs. Various system utilization information is

sampled and displayed dynamically on screen-type terminals. The information

displayed and the format of the screen are user-controllable.

A sample is taken and the display updated every cycle seconds. The values

displayed are the average of the samples taken over the last period seconds. The

default value for the cycle is five seconds. The default value for the period is 15

seconds.

The numeric values represent either actual values (for example, the number of core-

to-core moves) or percentages (for example, the percent of available processor time).

The plus signs (+) and minus signs () that follow numeric values indicate that the

values have increased or decreased, respectively, since the last cycle, even if the

actual values or bar graphics have not visibly changed (that is, a fractional change,

which cannot be displayed, has occurred).

Values are also represented by bars on the screen. The format of each bar consists of

number signs (#), followed by (depending on the system) capital Xs, or small, solid

rectangles (the DEL character), followed by periods (.), where the number signs extend

to the minimum value, the Xs extend to the current value, and the periods extend to

the maximum value. The minimum and maximum values are based on the values that

existed when the program was initiated or updated from the terminal by the user.

When the user enters the following command, the program executes a LOAD

DEFAULT command, which displays the default screen for that system:

E $SYSTEM/BARS

The program is initialized to a different display if the file DISPLAY is label equated to a

saved file. For example,

E $SYSTEM/BARS; FILE DISPLAY(TITLE = MY/SCREEN)

If the file MONITOR is label equated, the program writes the raw performance data to

that file as it is received from the operating system. For example,

RUN $SYSTEM/BARS; FILE MONITOR(TITLE = DEFAULT)

BARS (Activity Reporting System)

22 8600 0460523

BARS Commands

The following commands can be used as input to the BARS utility program.

& '& '& '& '& '& '& '& '& 12

BYE Command

The BYE command ends the program.

BYE &

CYCLE Command

The CYCLE command controls the sampling and display update interval.

CYCLE &

Explanation

The variable represents the interval in seconds.

DISPLAY Command

The DISPLAY command displays the NEWDISPLAY input required for a specified

display screen.

DISPLAY & ' DEFAULT & 12

BARS (Activity Reporting System)

8600 0460523 23

The following text describes the meaning of each option:

DISPLAY Entering DISPLAY causes the NEWDISPLAY input required for the

current screen (either a user-specified screen or the default screen) to

be displayed.

DEFAULT The DEFAULT option displays the NEWDISPLAY input for the default

screen for that system.

The displays the NEWDISPLAY input for the screen saved

in the specified file.

Example

The following command causes the NEWDISPLAY input for the screen saved in the file

called X/Y to be displayed:

DISPLAY X/Y ON P

HELP Command

The HELP command (or TEACH command) displays information that helps the user in

using the BARS utility.

& 1 TEACH 2

LOAD Command

The LOAD command loads a previously generated screen as the new screen. The

maximums, minimums, and averages for the system utilization information are

reinitialized.

LOAD & ' DEFAULT & 12

Entering LOAD causes