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
Contact me
Updated: Feb. 18th, 2023