UNISYS Dorado Utilities
AKA Sperry Univac 1100, 2200, and Clearpath IX systems
Select a utility processor for details and download information.
Introduction
APC
AVAIL
BOOT
CM432
DRAIN
FLED
LSTSUP
PROCUTIL
SPOT
SPRT
UZI
VOPT
WAD
WHAT
WHERE
WHTSUP
Welcome!
I have spent close to 50 years of my life working on the Univac 1100 series computer systems and its descendents. My first Univac introduction was to an 1108 during my college years at Illinois Institute of Technology. I was involved with the 1100 series, the follow on 2200 series, then the IX series, the Dorado series, and finally the ClearPath Software Series systems which are emulated on linux machines. Through my work career at Univac, Sperry, and Unisys and with various Unisys clients I supported, I wrote many utilities to enhance the systems.
Now in my retirement years, thanks to PS2200 Express (fantastic work Ward), I have rewrote many utilities I wrote during my time at Sperry Univac/Unisys. I am now making these utility processors/programs available to you.
If you find a utility you need or like feel free download. Let me if you have any comments, issues, or just want to chat. I suggest downloading the ZIP Program file packages since they include all the includes, procs, subroutines that are required. The ZIPped Program file packages should be downloaded to your PC, unzipped, then transfered to your Dorado system via ftp bin/cfmt format or for PS2200 use @'import,b instead of ftp.
Jeff Ganser to email me see the "Contact me" link at the bottom of the page.
APC Processor
Overview
Very unlikely processor to need but when you do! This is only for MHFS systems. It is possible that a file can get marked as application private. When a file is application private it cannot be accessed, asg (even only Y option), or deleted no matter the privileges you have. Application private is used by the UDS system mostly. If you somehow wind up with an application private file this processor is able to deal with it. You can clear, inspect, or set application private.Download Options
Example Execution
No example is available since it only runs on MHFS systems and I do not currently have access to one.
Help Documentation
A P C Processor This processor will clear, inspect, or set the Application Private ID for a shared file. Processor call format: @APC[,options] File.[,Apid] Options: C --> Clear Application Private. D --> Debugging. H --> Display help. I --> Inspect only (default). S --> Set Application Private. File --> File to clear/inspect/set Application Private ID of. *** NOTE *** The FULL filename must be specified q*f(c)., no use names. Apid --> For set the Application Private ID to use, defaults to "APC"
AVAIL Processor
Overview
The AVAIL processor displays the available disk space in detail.Download Options
Example Execution
@avail AVAIL 5R1 S77R2A 02/14/23 10:43:19 UNIT TRACKS CAPACITY %AV DEVICE T PREP PACKID LDAT ASGCNT STATUS DR0 89,725 255,076 35% SCDISK F 112 FIX000 1 1 UP DR6 773,290 1,407,936 54% SCDISK R 112 REM006 7 0 UP TOTAL FIXED REMOVABLE AVAILABLE 863,015 89,725 773,290 PERCENT AV 51% 35% 54% IN-USE 799,997 165,351 634,646 CAPACITY 1,663,012 255,076 1,407,936 DRIVES 7 1 1 DOWN DRIVES 5
Help Documentation
A V A I L Processor This processor will display the number of tracks of available mass storage for each disk/drum device on the system. Also displayed will be the device name, the device type, whether the device is fixed or removeable, the pack id, the ldat, the assign count, and the status of the device. (up, down, suspended, or not available) Processor call format: @AVAIL[,OPTIONS] F -> List fixed units only. H -> Display help. L -> List units even if down. M -> Stop output after 20 lines and wait for a transmit. R -> List removable units only. S -> Shared directory. Y -> Summary only.
BOOT Processor
Overview
BOOT simply displays information about the last boot. The information displayed includes system description, Exec information, boot time and UP time.Download Options
Example Execution
@boot System CC running on partition JG1 of a DV1000. RSVL Exec level: 49R5 Local level: 49R5-201026. Exec collection time: October 26, 2020 09:13:15. Last tape boot: January 20, 2022 14:49:28 reel: T27615. Booted: February 3, 2022 10:53:46. UP: 0 Days 0 Hours 23 Minutes 50 Seconds.
Help Documentation
NONE
CM432 Processor
Overview
The intent of this program is to analyze the primary and secondary MS Compool files to help identify why Compool records are being orphaned.Download Options
Example Execution
Not a great example execution since this system does not have orphaned compool. @cm432 CM432 1R1 Thu Feb 16 11:31:50 2023 (2200/8070-49R4-PART-1) Number of MPAs found 0. Total Compool records accounted for by MPAs 0. Allocated primary compool records 0. Allocated secondary compool records 0. Allocated total compool records 0. Free primary compool records 300. Free secondary compool records 300. Free total compool records 600. End CM432
Help Documentation
The intent of this program is to analyze the primary and secondary MS Compool files to help identify why Compool records are being orphaned. Read each allocated Compool record and examine word 0 S3 (indicator) for a 013 (tip output) and assume it is an MPA. Then follow the CID chain for the Compool record counting the number records used by the Compool message. Print a line about the Compool record found, with information such as pids, function, number of records, message length, transaction code, partial did, and first 32 characters of the message. After all Compool is evaluated print a summary report. Only allocated Compool records should be analyzed so retrieve the CM432 and CM1782 bit maps from the Exec DBank using er-config$ to read the CM432 and CM1782 bit maps. In order to read the bit maps call Exectag to read the sys$*sys$map. file to determine the address in the Exec DBank of the CM432, CM1782, and CMPDAT tags. Using the addresses of these tags determine the length of the primary and secondary compool files (e.g. c32nbr and c82nbr). The X option is required for the privilege to read protected TIP files along with the SSREADEXEC privilege to retrieve the bit maps. The A option can be used to analyze all Compool blocks whether allocated or not. The D option turns on debugging print outs.
DRAIN Processor
Overview
There are times that TIP output messages can become stuck on a PID's output queue due to perhaps hardware or configuration issues. In any case it might become desireable to delete the messages, perhaps because of QI exhaustion, off the TIP queue and DRAIN handles that.Download Options
Example Execution
EXP:179636 PART-1 49R4.30PSE 2023-02-17 08:22:48 CST mcb1 $qout MCB1 *MCB105081: A1 - Output queued and active output count = 80 mcb1 $qilst all MCB1 *MCB105163: A1 - 0 INPUT queue items found. MCB1 *MCB105163: A1 - 0 ACTIVE queue items found. MCB1 *MCB105163: A1 - 80 OUTPUT queue items found. MCB1 *MCB105156: A1 - Queue item list complete - 80 queue items found. MCB1 *MCB105086: A1 - MCB1*ALT$PR091341 sent to default print queue. DRAIN (DRAIN) 1R1C Initialized for application group 1/APPONE. drain 503 40 messages drained from PID 503. mcb1 $qout MCB1 *MCB105081: A1 - Output queued and active output count = 40 drain 501 40 messages drained from PID 501. mcb1 $qout MCB1 *MCB105081: A1 - Output queued and active output count = 0 drain help DRAIN pid_number - Drain messages for this PID DRAIN Ack - Enables ACKing mode. DRAIN Don - Enables Debugging. DRAIN DOFf - Disables Debugging. DRAIN Help - Display help information. DRAIN Log - Turns on logging. DRAIN Nak - Enables NAKing mode. DRAIN NOlg - Turns off logging. DRAIN Term - Terminates DRAIN.
Help Documentation
The DRAIN processor removes output messages that are queued in the MCB to a PID that is currently closed. NOTE The following copy must be done before executing this processor. @COPY,A MCBx*MCB$LIB.CBEP$EMMCBx to execution file. Where x is the application number. Processor call: @DRAIN[,options] [PID] Options: B -> Run in batch mode D -> Debugging enabled H -> Display help L -> Enable logging N -> Use NAK instead of ACK T -> Do NOT use PID -> For DEMAND ONLY the number of the PID to be drained. Required for DEMAND and ignored for BATCH. For BATCH these keyins are available: DRAIN pid_number - DRAIN messages for the PID DRAIN Ack - Enables ACKing mode. DRAIN Don - Enables Debugging. DRAIN DOFf - Disables Debugging. DRAIN Help - Display keyin help information. DRAIN Log - Turns on logging. DRAIN Nak - Enables NAKing mode. DRAIN NOlg - Turns off logging. DRAIN Term - Terminates DRAIN. DRAIN establishes itself as a CMS, this involves going real time (er-rt$), connecting to tip (CONNECT$TIP), registering with Exec as a CMS (er-cms$reg), and finally registering with MCB (CMINIT$$) as a CMS. DRAIN retrieves a PID number from the console keyin when executed in batch and from the processor call when executed in demand. Once the PID is establish DRAIN will read all the messages queued to the PID and delete them, this involves assigning the PID (er-rt$pid), if TIP session control is enabled signing on (er-tip$sm), opening the session to MCB for the PID (CMSOPEN$$), looking for messages on the ROQ (ORQ), retrieve the queued messaage(s) with MCB CMSRECV$$ then acking the message to MCB (CMSACK$$) optionally naking the messages (CMSNAK$$). Once all messages have been retrieved tear down the MCB session (SESSCP$$), TIP sign on, and release the PID (er-rt$pid). In demand mode we are done but in batch loop waiting for a DRAIN console keyin with another PID to drain or TERM to exit.
FLED Processor
Overview
FLED is a full screen raw file editor.Download Options
Example Execution
@fled,f gans. File:STD#GANS*GANS(1). Track:0/0/0 Sector:0/0 0000000000 505025135050 000000436171 000000000000 **PF**@@@<19@@@@@@ 0000000003 000000000001 020356000000 021312000000 @@@@@[]#,@@@]FE@@@ 0000000006 000000000000 000000000000 021304000000 @@@@@@@@@@@@]F^@@@ 0000000011 000000002100 000244000000 021304000000 @@@@L@@]=@@@]F^@@@ 0000000014 000000000000 000214000000 021304000000 @@@@@@@]G@@@]F^@@@ 0000000017 000000000000 000000000000 021304000000 @@@@@@@@@@@@]F^@@@ 0000000022 000010000000 000000000000 000000003400 @@C@@@@@@@@@@@@@W@ 0000000025 000016630410 000000416726 000700000000 @@I3^C@@@-7Q@B@@@@ 0000000030 000000000000 000000000000 000000000000 @@@@@@@@@@@@@@@@@@ 0000000033 000000000000 000042000126 000456000000 @@@@@@@@+@[Q@^,@@@ 0000000036 000751000067 000200000570 000345000074 @B(@@7@]@@ 8@#>@@/ 0000000041 000576000000 000340000224 000117000000 @ "@@@@#)@]O@[J@@@ 0000000044 000510000077 001206000417 000476000544 @ C@@_@EA@^J@^"@ = 0000000047 000177000000 000000000324 001165000000 @[_@@@@@@@#O@D5@@@ 0000000052 000444000507 000026000000 000350000472 @^=@ B@@Q@@@@#*@^' 0000000173 000236000741 000303001053 000650000000 @]Y@B-@##@C:@A*@@@ 0000000176 000000000004 000365000000 000461000233 @@@@@^@#5@@@@^1@]V 0000000201 000033001101 001102000212 001104000000 @@V@D[@D]@]E@D^@@@ Command
Help Documentation
The FLED processor is a raw file editor. Call format is @FLED,options file. Options: A-Ascii, D-Decimal, F-Fieldata, I-Instruction, O-Octal, X-Hex H-Help, M-Addresses decimal, R-Read only, S-Addresses sector format. E-Extended mode instruction display, T-Third word instructions. Commands: [-]number -> Move forward number words or - backwards. Address Decimal | Octal [,Sector] -> How addresses are displayed. Display Octal[,Decimal,Fieldata,Ascii,Hex,Instruction]->Formats to display. Exit -> Ends FLED Go track/sector/offset | sector/offset | word -> Position to. Help -> This help display. Instruction Basic | Extended [, Third | Quarter] -> Instruction decoding. Locate string[,[start,[end[,region]]] Locate string start-address same as GO, end-address same as GO region-Octal, Ascii, Decimal, Fieldata, Hex default Octal Top -> Position to first word of file. Undo -> Remove the last change made. All commands can be abbreviated to a single letter.
LSTSUP Processor
Overview
Display the Supur file that a transaction is loading from.Download Options
Example Execution
@lstsup,sx LSTSUP 1R1 S77R2A 02/16/23 11:50:55 Xact PrgNum XQT Type Loader Aux Info ckckon 3 ckckon abs Online d0432a, d1782a, and fast2a. mcb1s 110 mcb1s abs Supur main 65 mcb3s 333 mcb3s abs Supur main 65 rdo1 85 rdo1 abs Supur main 65 rdo2 400 rdo2 abs Supur main 65 rdo3 450 rdo3 abs Supur main 65 sysprt 4 sysprt abs Supur main 65 xxmcb1 111 xxmcb1 abs Supur main 65 xxmcb3 334 xxmcb3 abs Supur main 65 Number of valtab records: 8190. Number of inuse valtab records: 9. Number of valtabs without load information: 0. End LSTSUP
Help Documentation
LSTSUP Processor This processor will display the Supur file all transactions are loading from. Call format @LSTSUP[,Options] [valtab-file.] Options: D->Display debugging information. H->Display help information. S->Sort by transaction code (Default sort by program number). X->Required to read online valtab. Valtab-file Exec file to read the valtabs from, default use tip file 4.
PROCUTIL Processor
Processor Overview
Find the element that contains a proc.Download Options
Example Execution
@procutil,cl sys$lib$*proc$. PROCUTIL 1R2 SL74R1 02/16/23 11:53:55 ENTER NAME TO LOOK UP. >screen-print-buffer ELEMENT SCREEN-DEFS/COBP CONTAINS PROC SCREEN-PRINT-BUFFER SCREEN-PRINT-BUFFER PROC / * * * THIS PROCEDURE DEFINES THE BUFFER USED FOR THE * 'SCREENGET' FUNCTION. * * 01 SCREEN-PRINT-BUFFER. 05 SCREEN-LINE OCCURS 24. 10 FILLER PIC X(80). * END ENTER NAME TO LOOK UP. >@eof
Help Documentation
. . P R O C U T I L Processor . . This is a utility processor, that display's the element name . which contains the specified procedure. . The processor will only search the file specified for the proc. . The "L" option on the call card will cause the proc to be . printed, if the proc is found. . . Processor call format: . . @PROCUTIL,[OPTIONS] FILE. . . The utility will then prompt you to get the procedure name. . Enter the procedure name, PROCUTIL will then perform it's function. . . OPTIONS: . A-LOOK UP AN ASSEMBLER PROCEDURE NAME . C-LOOK UP A COBOL PROCEDURE NAME . E-LOOK UP AN ENTRY POINT NAME . F-LOOK UP A FORTRAN PROCEDURE NAME . L-LIST THE PROCEDURE
SPOT Processor
Overview
SPOT is similar to a MINI OSAM. It retrieves processor usage statistics on a timed basis and reports to the console or demand user. The output can be a single line summary or a more detailed multi line.Download Options
Example Execution
***NOTE*** View from the system console EXP:179896 PART-1 49R4.30PSE 2023-02-16 07:59:23 CST SPOT 2R2 spot 1 SPOT interval set to 1 minutes. GANS TURNED ON SIP Exec 0.1% Bgr 0.0% R/T 0.0% Tip 0.0% User 0.2% Idle 99.7% 08:00:24 spot multi SPOT in multiline mode. Misc Exec 0.0% Real time 0.0% I/O 0.0% ILES 0.0% Dispatcher 0.0% CMS 0.0% Memory 0.0% UDS 0.0% TIP/IR/Audit 0.0% TIP 0.0% Symbionts 0.0% Critical deadline 0.0% Misc switch Exec 0.0% Demand 0.2% Idle 99.7% Batch 0.0% Forced Idle 0.0% spot single SPOT in single line mode. spot term Exec 0.1% Bgr 0.0% R/T 0.0% Tip 0.0% User 0.2% Idle 99.7% 08:01:34 GANS TURNED OFF SIP SPOT terminated.
Help Documentation
S P O T P r o c e s s o r SPOT will display processor utilization statistics on the console every specified interval. The data is from the internal performance monitor, a composite of all processors and retrieved with er-sysbal$. SPOT is meant to be executed in a batch runstream. It will continue to display statistics until terminated. SPOT will display statistics on the console if executed from batch, execution from demand will output the statistics to the demand terminal. Processor call: @SPOT[,OPTIONS] [INTERVAL] Options: B option will make SPOT execute in batch mode from demand. H option display help. S option will produce a single line output. Interval: Initial time interval setting, if not specified defaults to 5 mins. Value between 1 and 15 minutes. SPOT console keyins: number -> Set time interval between 1 and 15 minutes H[ELP] -> Display help information M[ULTI] -> Set multi line output S[INGLE] -> Set single line output T[ERM] -> Terminate spot This is only a prototype at least the following should be looked into for any production environment. 1. The program runs at batch priority, it should probably be R/T to inform appropriate personal when R/T has taken over the system. 2. The exact security requirements are not specified which I believe is SSCONSOLE and Quota level 2. 3. Checking that SIP data buffers are large enough, perhaps dynamically allocating them.
SPRT Processor
Overview
The SPRT processor was designed to be a full screen version of @PRT. There are many additional capabilities beyond what @PRT can do besides full screen. Consider SPRT a bit of @PRT, @TOCED, and @QEDIT all wrapped into one. It allows selections of files, elements, and print files with wild card and mask characters. Transition from MFD to PF to SDF and back again. Far too much to describe in a single overview paragraph. Numerous display and sorting options.Download Options
Example Execution
@sprt,q SPRT 4R1Q40 (230106 1149:17) 2023 Feb 16 Thu 1200:38 CST List of print queue ALL Record 1 of 1 GANS GANS*BKFIL$GANS(3) 9 PR 230216 1200:25 *** End of print file list *** Command @sprt,t gans. SPRT 4R1Q40 (230106 1149:17) 2023 Feb 16 Thu 1202:05 CST TOC of file GANS*GANS(1) Record 1 of 788 ABSX ACCT ACL-LOGT1 ACOB-BASE ACOB-BDIV ACOB-KONS ACQUIRE ACQUIRE ACSF AD ADDMOVE AEDEC AEDECV AEHEX AEPACK AF Command @sprt,tl SPRT 4R1Q40 (230106 1149:17) 2023 Feb 16 Thu 1423:28 CST TOC of file GANS*GANS(1) Record 1 of 788 ABSX ABS 1981 Oct 12 Mon 1545:47 304 8318 ACCT ABS 1992 Sep 17 Thu 1020:40 11 9371 ACL-LOGT1 SYM-MSM 2015 Jul 23 Thu 1512:53 2 69305 ACOB-BASE SYM-ELT 2001 May 03 Thu 0935:32 35 29253 ACOB-BDIV SYM-ELT 2020 Feb 02 Sun 1137:18 10 100973 ACOB-KONS SYM-ELT 2021 Jul 22 Thu 2119:31 18 116873 ACQUIRE SYM-ELT 2001 May 03 Thu 0935:52 149 41677 ACQUIRE ABS 1981 Aug 31 Mon 1232:33 36 9382 ACSF SYM-ELT 2001 May 03 Thu 0935:19 7 24164 AD SYM-ELT 2013 Jan 15 Tue 1008:08 3 66408 ADDMOVE SYM-ASM 2021 Feb 06 Sat 0740:44 1 105627 AEDEC SYM 2021 Jun 07 Mon 0557:45 161 114225 AEDECV REL 2016 Jul 29 Fri 0711:13 3 70481 AEHEX SYM-ELT 2001 May 03 Thu 0935:56 48 43241 AEPACK SYM 2021 Jun 14 Mon 0543:12 21 115145 AF SYM-IPF 2001 May 03 Thu 0935:22 2 24805 Command @sprt SPRT 4R1Q40 (230106 1149:17) 2023 Feb 16 Thu 1424:44 CST MFD list, MASK=*. Total=799789 Record 600 of 1009 SYS$*DLOC$(1) SYS$*FISENG(2) SYS$*F010L1(14) SYS$*F010L1(15) SYS$*F018L1(1) SYS$*GENF$(1) SYS$*ILES$(3) SYS$*IP$DUMPLIB(24) SYS$*LIB$(1) SYS$*LOADSECURE$(1) SYS$*LOADSECURR$(1) SYS$*MCB(1) SYS$*MCBFIG(1) SYS$*PR@000P22SIO(1) SYS$*RLIB$(1) SYS$*RUN$(1) SYS$*SBF@@@FIX000(1) SYS$*SCHQ$(1) SYS$*SEC@ACCTINFO(1) SYS$*SEC@ACR$(1) SYS$*SEC@USERID$(1) SYS$*SMDTF$@@@@@@(1) SYS$*SRT$PAR(126) SYS$*ST@010542152(1) SYS$*SYS$MAP(1) SYS$*ZIPLIB$(1) Command @sprt,l SPRT 4R1Q40 (230106 1149:17) 2023 Feb 16 Thu 1426:25 CST MFD list, MASK=*. Total=799789 Record 254 of 1009 GANS*BKFIL$GANS(1).,F2/0/TRK/262143 TRKS=2 GANS*BKFIL$GANS(2).,F2/0/TRK/262143 TRKS=2 GANS*BKFIL$GANS(3).,F2/0/TRK/262143 TRKS=5 GANS*BKFIL$GANS(4).,F2/0/TRK/262143 TRKS=0 GANS*CB(1).,F/0/TRK/9999 TRKS=0 GANS*COMUS(1).,F/0/TRK/99999 TRKS=2047 GANS*ED$TCGANS(1).,F/0/TRK/3000 TRKS=1 GANS*FLIST(1).,F/0/TRK/99999 TRKS=79 GANS*GANS(1).,F/0/TRK/99999 TRKS=2268 Command
Help Documentation
S P R T Processor The SPRT processor was designed to have most of the functionality of the FURPUR processor PRT function. However some enhancements were added and unfortunately some features removed. Hopefully the enhancements outweight the regressions. SPRT in the MFD list mode (Absence of H, Q, T, or S option) will fill a screen with file names then wait for the user to enter a command. SPRT I believe is much faster at MFD displays than PRT. The enhancements to the PRT,T command follow. The table of contents is displayed on a screen much more reasonablly. SPRT provides for multiple element names on a single line greatly increasing the number viewable element names on a single screen. SPRT will fill a screen with the table of contents then wait for a user command. SPRT in the element list mode (S option) displays a screen full of data then waits for the user to issue a command. SPRT in print queue view mode (Q option) displays a screen full of print files queued to the specified queue. Then wait for a command. In all modes SPRT allows complete control of the display view. SPRT also provides pattern matches for qualifiers and filenames in MFD list mode, pattern matches for element and version names in toc list mode (PRT only allows version pattern matches with the V option), and multiple sort keys in MFD and TOC mode. While in MFD mode you can tab to a filename, that is fastrand addressable and loaded, and transmit. This will put you into toc mode if the file is a program file or element list mode if the file is an SDF formated file. In TOC mode you can tab to undeleted symbolic elements and transmit, this will put you in list mode for that element. Tabbing to any element and pressing F3 will cause the element to be deleted. F4 will undelete. In QUEUE mode you can tab to a print file and transmit, this will allow you to view the print file. Note that the SSSMOQUE priviledge is required to view a print file. Note also that a print file can be printed before you select it, in this case you will not be able to view the print file. SPRT does not handle the PRT F or I option commands. SPRT is supported on Uniscope terminals and Telnet NVT (VT-100) terminals. The NVT coding only supports the use of the arrow keys for cursor positioning. When a function key is used on a NVT the return key must be pressed afterwards. @SPRT[,opts] [qual*file.elt/ver],[format][/class] Opts: A --> In TOC mode select absolute elements. In MFD mode retrieve the shared directory. B --> Sort in descending order. C --> Inhibit error exit. D --> Display files on a removeable pack. Use FIXED for the pack-id to display files only on fixed. E --> In TOC mode select deleted elements. In MFD mode expanded selection by class. F --> Floating pattern matches. Matches if the pattern exists in the subject matter, not limited to matches starting at the first character position as required by anchored. G --> Turn on debug mode. H --> Display HELP information. I --> Force color display. J --> Force non color display. K --> Continue display without user intervention. L --> Long listing - single element per line all information shown. For print files show line spacing and print ctl images. For symbolics show the control words. M --> Sort by time of creation. N --> Select files from MFD by account specified. O --> In TOC mode select omnibus elements. In MFD mode select files owned by owner specified. P --> Select files from MFD by project specified. Q --> View the print queue specified. R --> In TOC mode select relocatable elements. In MFD mode single cycle listing. S --> List symbolic elements or files. T --> List file table of contents. U --> Create an EXEC dump function index. V --> Sort by version name first then element name. In MFD list mode sort by filename then qualifier. W --> Wide screeen (132 columns). X --> Extra long screen (48 rows). Y --> Reuse the old mfd. Z --> Sort by file/element size. Specifications: qual*name. --> T-option File to list table of contents of. S-option File containing element to list or file to list. Not T or S Qualifier and Filename selection patterns. elt/ver --> T-option Element and version name selection patterns. S-option Name of element to list. Q-option Print queue/RunID to list, queue can be ALL. D-option Pack ID/equipment to list. Use "FIXED" to select only fixed. Not S,T,Q Elt is a name pattern for the project or D (P-option), the account (N-option), or the owner (O-option). All the patterns allow for a mask character of -, and wild character of $. Format --> MFD mode - Format for initial display. Class --> MFD mode - Class of files to select. Requires use of E option. Asg-d Backed-up Current-back Disabled Fixed G-opt No-backup NOt-current Position PRivate PUblic Read-only Removeable Store-thru Tape Unloaded UNOwned V-opt Word WRite-only WRITTen SPRT will display a control line at the bottom of the screen. The following commands are available. Capitalized letters of the command are required. SPRT provides some command capabilities via the function keys. F1 ---> Resume the last locate. F2 ---> Repaint the screen. F3 ---> Delete the element the cursor is positioned on. F4 ---> Undelete the element the cursor is positioned on. Nothing --> Roll forward 1 screen of data. - --> Roll backward 1 screen of data. number --> Roll forward (number) records. -number --> Roll backward (number) records. Color field=foreground/background field names: Id --> SPRT id line, screen top line. Default Cyan on Black. Header --> Information line, second line of screen. Default Black on Yellow. Fastrand --> Loaded fastrand formated file. Default Green on Black. Word --> Loaded word addressable file. Default Blue on Black. Tape --> Tape files. Default Magenta on Black. Unloaded --> Unloaded disk file. Default Red on Black. Deleted --> Delete element of any type. Default Red on Black. Symbolic --> Symbolic element. Default Green on Black. Asmp --> Assembler procedure symbolic. Default Green on Black. Cobp --> Cobol procedure symbolic. Default Green on Black. FOrp --> Fortran procedure symbolic. Default Green on Black. Relocatable --> Relocatable elements. Default Blue on Black. ABsolute --> Absolute elements. Default Magenta on Black. Omnibus --> Omnibus elements. Default White on Black. TExt --> Lines from symbolic files or elements. Default White on Blue. HIghlight --> Locate found a match on this line. Default Blue on White. HOld --> Color of hold lines. Default Black on Magenta. Print --> Color of print queue view. Default Cyan on Black. COMmand --> Command input. Default Yellow on Black. Error --> Color for error message display. Default Black on Red. foreground and background color choices: Black Red Green Yellow BLUe Magenta Cyan White On NON color displays highlighting is accomplished with normal and low intensity. This applies to TOC and MFD modes. In TOC mode undeleted symbolics are normal intensity while all other element types are low intensity. In MFD mode fastrand loaded files are normal intensity while all other files types are low intensity. COLUmn num --> Position to (num) column, 1 is the first column. Debug param --> Turns debugging mode on or off. Param: OFf - turns debugging off. ON - turns debugging on. Exit --> Exit Sprt. Find --> Same as locate but match must start in column 1. FC --> Find continuous. Find all references within the specified range (See locate). A result is built and displayed with all matches. FOrmat name --> Display in (name) format. Formats below: Short - Short display (No L option). Long - Assignment information/Element type, create date. Print files display line spacing info. Symbolics display control words. The following apply to MFD mode. Id - File grouping information (Account, Project). SEcurity - Security (Keys, Owner, Acr). Dates - Dates (Catalog, Last reference, Backup). Allocation - Allocation (Pack ids or Tape reels). Flags - Flags (Disabled, Vopt, Gopt, Read, Write, Unlabeld). Backup - Backup reels. Go number --> Position to (number) line/record. Help name --> Display the help information. Name can be: Author Commands COLor COLUmn Exit Find FC FOrmat Go Help HOld Locate LC Mask Not NC Options OVerview Pick POp Queue Return ROll Select SEt SOrt Top TYpe Debug FIXes FUture Vt HOld number --> Holds the number of lines at the top of the display. Rolling and locating will not change the top number of lines. A maximum of 10 lines can be held, a zero releases the held lines. Locate p1,p2,p3 --> Locate the p1 parameter text in the text of the symbolic being listed. To locate spaces or commas enclose the search parameter in quotes ('). To search for a quote while using a quoted parameter use double quotes. P1 can include a mask character to match any character, default is - (see set mask). P1 can also include a wild character to match 0 to x characters, default is $ (see set wild). The default is for case insensitive, however this can be changed to case sensitive (see set case). Parameter p2 specifies the line range for the locate in the format startline:endline Optional defaults to top line on screen when p1 specified or line after last locate success if p1 is not specified through last line of the symbolic element. Parameter p3 specifies the column range for the locate in the format startcolumn:endcolumn Optional defaults to column 1 thru column 1200. LC --> Locate continuous. Find all references within the specified range (See locate). A result is built and displayed with all matches. Mask params --> Same as Select, to be eliminated. Not --> Inverted locate, finds a line that does not match. NC --> Not continuous. Find all references within the specified range (See NOT). A result is built and displayed with all matches. Pick num,num--> Pick an item from the menu by specification of row and column. POp --> Same as return to be eliminated in the future. Queue name --> Select a another print queue to list. name is the name of a print queue, can be ALL. Return --> Go back, as from symbolic mode to Toc mode. Select param--> Change the selection mask for files or elements. Multiple params can be specified seperated by commas Qualifier=name - Change qualifier selection mask to name. Filename=name - Change filename selection mask to name. Account=name - Select files on account mask of name. Owner=name - Select files on owner mask of name. Project=name - Select files on project mask of name. Account, Owner, and Project are mutually exclusive. Class=name - Select files that match a class. Asg-d, Backed-up, Current-back, Disabled, Fixed, G-opt, Large, No-backup, NONe, NOT-current, Position, PRivate, PUblic, Read-only, REMoveable, Store-thru, Tape, Unloaded, UNOwned, V-opt, WRite-only, WRITTen Element=name - Change element selection mask to name. Version=name - Change version selection mask to name. Runid=name - Change runid mask for print queue list. ANchor - Cancel floating mask patterns. FLoating - Make mask patterns floating. Anchor and Floating are mutually exclusive and must be the last parameter listed. SET params --> Change the mask and/or wild characters, header display or locate case sensitivity. Multiple params can be specified seperated by commas Case=argument Insensitive - Locate is done case insensitive. Sensitive - Locate is done case sensitive. Header=argument Colorkeys - Header decodes the color key. Information - General info such as current line number. Title - Title line for column data. Mask=char - Character to change the mask character to. Wild=char - Characger to change the wild character to. SOrt name --> Resort the entries in (name) order. Sort names for TOC mode: Element - Element/version name Normal - Same as element, to be eliminated. Version - Version/element name Time - Date/Time of element creation Size - Size of element. Location - Disk address of element Sort names for MFD mode: Qual - Qualifier, filename. File - Filename, qualifier. Time - Date/Time of file creation Size - Size of file. Owner - By file owner, Q, F, Cyc Sort names for QUEUE mode: Time - Time of SYM. Qual - Qualifier, filename. File - Filename, qualifier. Queue - Print queue name and priority Runid - Print runid, qual, file QQual - Print queue, qual, file QRunid - Print queue, runid, qual, file name,Backward will sort in descending order. Top --> Position to first record. TYpe names --> Select the specified (names) element types. Symbolic - Elements of type symbolic Relocatable- Elements of type relocatable Absolute - Elements of type absolute Omnibus - Elements of type omnibus OTher - Elements of any other type Deleted - Elements which are deleted will be selected *Note with deleted you must specify the types of deleted elements to display (eg Sym, Rel, etc...) For print queue mode. Dump - Create an Exec dump index for selected print file Symbolic - Selected print file is symbolic.
UZI Processor
Overview
Can UNZIP ZIP files. Not all that useful now with CFIS's ZIPUT and Native-X however it is a lot more intuitive how to use it on a Dorado.Download Options
Example Execution
@UZI,V CB. UZI 1R1Q2 SL77R2 02/16/23 15:22:13 Archive Date/Time Compressed Uncompressed cb300.txt 2013-05-13 15:24:20 88075 460448 cb310.txt 2013-05-13 15:25:02 205980 1089230 Elapsed time 0.065 seconds. IP Sup seconds 0.057, Disk I/Os 10. End UZI. @uzi,a cb. UZI 1R1Q2 S77R2A 02/16/23 14:48:19 Inflating: cb300.txt, 88,075 bytes compressed. Cataloging output file. as: gans*cb300(1)., 460,448 bytes uncompressed. Inflating: cb310.txt, 205,980 bytes compressed. Cataloging output file. as: gans*cb310(1)., 1,089,230 bytes uncompressed. Elapsed time 0.825 seconds. IP Sup seconds 2.773, Disk I/Os 41. End UZI.
Help Documentation
U Z I Processor This processor will unzip a .zip archive. Even though one could use the Unisys ziput, UZI works more naturally with the Unisys directory structure and is somewhat faster. Processor call format: @UZI[,options] Zip-File.[Element/Version][,Out-File1.[Elt1/Ver1]] [,Out-FileN.[EltN/VerN]...] Options: A -> Write A format output (e.g. 4 9-bit bytes per word). vs. C format (e.g. 9 8-bit bytes per 2 words). Generally speaking one wants C format. C -> Force C format input when auto detect fails. D -> Turn on debugging, only if generated with "bug" set to true. E -> Output will be elements based on archive file name. F -> Handle a CIFS zip file. This refers to output not input. There are caveats. H -> Display help information. L -> If UZI must catalogue an output file make it a large file. P -> Output file 1 is a PF to place unzipped files as elements. U -> User will be prompted for output file or element names during inflation. V -> View the zip archive only. X -> If creating a PF make it a LEPF. Y -> If creating a PF make it a LPF. Z -> Zip the input. NOT currently implemented. Zip-File --> File or element containing the zip archive. The input ZIP archive can be in A or C format, detection is automatic although not infalable, see C option. Out-File --> 1 thru N. File or element where unzipped files from the ZIP archive are placed in order as found in the archive. U-option these are ignored. P-option only Out-File1 is used and must be a PF. If neither Out-File is specified nor the U options is being used for a file then the name from the archive is used after reworking for valid 1100 file and element names. With no opts ...directory/qualifer/filename.extension With E option ...dir/qualifier/filename/element.version if no qualifier and filename then tpf$. is used With F option ...dir/qualifier/filename/element.version.type With P option ...directory/element.version if out-file1 is missing then tpf$.
VOPT Processor
Overview
The VOPT processor can set or clear the V option for a file.Download Options
Example Execution
@prt,f v. * * PROJ: GANS ACCNT: 0 * * GANS*V(1),F/0/TRK/256 MODES: PUBLIC OWNER: GANS NO. OF GRANULES ASG-D: 0 HIGHEST GRANULE ASG-D: 0 TOTAL ASSIGNMENTS: 0 HIGHEST TRACK WRITTEN: 0 CAT: 2023-02-17 18:20:03 LAST REF: 2023-02-17 18:20:03 @vopt v. VOPT 1R2A SL77R2 02/17/23 18:22:10 V Option set for GANS*V(1). End VOPT. @prt,f v. FURPUR 33R2 (2018-03-29 15:38:20 CDT) 2023-02-17 18:22:15 CST * * PROJ: GANS ACCNT: 0 * * GANS*V(1),F/0/TRK/256 MODES: PUBLIC,V-OPT OWNER: GANS NO. OF GRANULES ASG-D: 0 HIGHEST GRANULE ASG-D: 0 TOTAL ASSIGNMENTS: 0 HIGHEST TRACK WRITTEN: 0 CAT: 2023-02-17 18:20:03 LAST REF: 2023-02-17 18:20:03 @vopt,c v. VOPT 1R2A SL77R2 02/17/23 18:22:19 V Option cleared for GANS*V(1). End VOPT. @prt,f v. FURPUR 33R2 (2018-03-29 15:38:20 CDT) 2023-02-17 18:22:23 CST * * PROJ: GANS ACCNT: 0 * * GANS*V(1),F/0/TRK/256 MODES: PUBLIC OWNER: GANS NO. OF GRANULES ASG-D: 0 HIGHEST GRANULE ASG-D: 0 TOTAL ASSIGNMENTS: 0 HIGHEST TRACK WRITTEN: 0 CAT: 2023-02-17 18:20:03 LAST REF: 2023-02-17 18:20:03
Help Documentation
V O P T Processor This processor will set or clear the V bit (unload inhibit) for the specified file. Processor call format: @VOPT[,options] file. Options: C --> Clear the V bit. H --> Display help topics. File --> File to set/clear the V bit for.
WAD Processor
Overview
If you have lost your SILAS source configuration this is the processor for you. WAD will read the SILAS wad configuration file and produce source statements.Download Options
Example Execution
@wad,rs silas$a*config. WAD 2R3 Thu Feb 16 15:29:54 2023 (2200/8070-49R4-PART-1) *Warning Output file/elt not specified, using tpf$.silas Number of TOCs: 1. Number of Remote EUs: 0. Number of Group Entries: 3. Number of Pool Groups: 3. Number of Util Index Banks: 1. Number of PID banks: 1. Number of PID statements: 3. Number of PIDs: 297. Number of I/Os: 18. End WAD ***GENERATED OUTPUT IN TPF$.SILAS*** List of element GANS*TPF$(0).SILAS Line 1 Column 1 ADMIN SECURITY,PASSWORD,SILAS ; KEYIN-NAME,SILAS INFO CONFIG-NAME,WRC002 APPLICATION,APPONE APP-NO,1 ; NAK-ACTION,SESSION-CLOSE ; CONCURRENT-COMPOOL,YES ; PID-POOL,POOL1 PROCESS,CSACSU TP0-ATTACH-NAME,CSACSU ; TP0-ATTACH-PASSWORD,CSA INTERNET-ADR,INET1 IP,10.1.1.1 LOG ASG,*LOG(+1).,F///128 ; SIZE,1792 PROCESS,RSDCSU TP0-ATTACH-NAME,RSDCSU ; TP0-ATTACH-PASSWORD,RSD ; INTERNET-ADR,INET1 ; TELNET-ATTACH-NAME,TELRSI ; TELNET-ATTACH-PASSWORD,RSI TIP CMS-NUMBER,1 ; CORE-BUFFERS,300 ; WORD-BDRY,YES PROCESS,TIPCSU TP0-ATTACH-NAME,TIPCSU ; TP0-ATTACH-PASSWORD,TIP APPLICATION,TIP001 APP-NO,0 ; NAK-ACTION,SESSION-CLOSE ; PID-POOL,POOL0 TRACE ASG,*TRACE(+1).,F///60 ; MEDIUM,S ; SIZE,1792 APPLICATION,UDSSRC APP-NO,3 ; NAK-ACTION,SESSION-CLOSE ; CONCURRENT-COMPOOL,YES ; PID-POOL,POOL3 PID,1,99 PID-POOL,POOL0 ; NAK-ACTION,SESSION-CLOSE PID,101,199 PID-POOL,POOL1 ; NAK-ACTION,SESSION-CLOSE PID,301,399 PID-POOL,POOL3 ; NAK-ACTION,SESSION-CLOSE *** End of file ***
Help Documentation
The WAD processor converts from a SILAS binary configuration WAD file to source statements. Call: @WAD[,options] [Qual*]File.[,[QUAL*]OUT.[ELT]] Options: B -> List PID bank entries as encountered. D -> Enable debugging code. G -> List information from the General Information Entry (GIE). H -> Display Help information. R -> Readability S -> Display statistics. T -> List the Table Of Contents (TOC). Qual*File.: Word Addressable binary SILAS configuration file. The running WAD file can be retrieved with a 'SILAS CONFIG COPY q*f.' console command. Qual*Out.Elt: The element (or file) to write the source statments to.
WHAT Processor
Overview
Determine what type of file you have. This is mostly for a support type person who receives diagnostic materials but it is unclear what the materials are.Download Options
Example Execution
@what gans. WHAT 1R1K Thu Feb 16, 2023 15:34:19 Site:PART-1 Exec:49R4 Mach:2200/8070 Program File - Standard End WHAT. @what diag$. WHAT 1R1K Thu Feb 16, 2023 15:35:47 Site:PART-1 Exec:49R4 Mach:2200/8070 Post Mortem Dump - Extended mode DIAG$ file for WAD End WHAT. @what dump3. WHAT 1R1K Thu Feb 16, 2023 15:37:14 Site:PART-1 Exec:49R4 Mach:2200/8070 Exec dump SYS$MAP file. End WHAT.
Help Documentation
The WHAT processor inspects a file to identify its contents. Call: @WHAT,options file. Options: H -> Help File types WHAT can identify. Program files (Standard, Large, and Large Element). SDF Data Files (Print, PCIOS, Fortran, Symbiont). Exec dump OFD files. Exec panic, exdrum, and sysmap CPComm, CPCommOS, CITA, MCB, and SILAS Log and Trace files. CPCommOS trace net PCAP files. MCB 9 dump files. cpFTP Xfer Logs. Audit Trails (System Log, COD, and Step). PMD (Basic, Extended mode 'MCB and probable UDS dumps'). DVD (@DCOPY) files. VTH files. DDP/PPC log and trace files. SYSBAL files. End WHAT
WHERE Processor
Overview
Displays the tape a file is backed up to.Download Options
Example Execution
@where udsmon22r1*so. WHERE 1R2 SL77R2 02/16/23 21:34:14 UDSMON22R1*SO(1) IS BACKED UP ON REEL T27601, FILE POSITION 12. IT WAS BACKED UP ON JANUARY 26, 2022 AT 08:11:48.
Help Documentation
W H E R E PROCESSOR THIS PROGRAM WILL DISPLAY WHAT TAPE THE SPECIFIED FILE WAS LAST BACKED UP TO BY SECURE OR FAS. PROCESSOR CALL FORMAT: @WHERE[,OPTIONS] FILE. OPTIONS: H ---> DISPLAY HELP.
WHTSUP Processor
Overview
Determine what SUPUR file a transaction is loading from.Download Options
Example Execution
@whtsup rdo2 WHTSUP 1R2 S77R2A 02/16/23 15:40:17 Transaction rdo2 loads abs rdo2 from Supur main file 65. End WHTSUP
Help Documentation
WHTSUP Processor This processor will display the Supur file a transaction is loading from. Call format @WHTSUP[,Options] XACT Options: H->Display help information.