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.
Downloaded 2 times
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
Downloaded 0 times
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
Downloaded 1 times
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
Downloaded 0 times
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
Downloaded 0 times
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
Downloaded 0 times
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
Downloaded 0 times
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
Downloaded 0 times
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
Downloaded 0 times
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
Downloaded 0 times
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
Downloaded 0 times
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
Downloaded 0 times
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
Downloaded 0 times
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
Downloaded 0 times
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
Downloaded 0 times
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
Downloaded 0 times
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
Downloaded 0 times
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.
Visitors:
Total downloads: 3
Updated: Feb. 18th, 2023