Post on 26-May-2018
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