MSD 3R3F -- Mass Storage Display Utility

MSD will display a summary of all mass storage devices on the system, showing each drive's status and available tracks. Under option and parameter control it can display other items, select which drives to include, and perform other functions related to output and display.

Call:

@MSD[,options] [param1/data,param2/data,...]

-or-

@MSD TOT -- for a quick display of system totals.

MSD's header line, which also functions as a signon, begins with "MSD", the processor level, the system site id, MSALL$ revision number (r3,r4,...), time, and date. This is followed by the total number of units selected; the granularity used (tracks/KB/MB); whether totals, percents, or packids are shown; and, space permitting, a reminder to call @MSD,HELP if needed.

With no options or parameters MSD will list all drives in MCT order and show their remaining track count. The display will pause between screens as needed. MSD can display an individual drive capacity of up to 34,359,738,367 tracks.

Unless the N option is used or the @MSD call occurs in breakpoint, batch, or an @ADD stream, MSD will use FUSION full screen mode for its display. The status of each drive will be designated by the color of its track count:

        Green    - UP
        Yellow   - SU (Suspended)
        Magenta  - RV (Reserved)
        Red      - DN (Down)
        Low Cyan - NA (Not Available) - normally not included;
                                        see A, C options.
        Gray     - X2 (Secondary Unit Duplex Partner)

With FUSION, the track count of fixed drives is shown in normal intensity, that of removable drives in low intensity. If only removable drives were selected, however, their tracks are shown in normal intensity.

Without FUSION, the track count of fixed drives is separated by an equals sign (FIXDRV=12345), that of removable drives by a colon (REMDRV:12345).

By default MSD displays each drive name and its remaining tracks. The TKD parameter described later may be used to control the presence and format of other items in this section of the display.

If the K option is used, tracks will be shown as kilotracks, rounded down to the nearest multiple of 1000. If the TKD parameter 8 or 9 is used, tracks will be shown as 8-bit or 9-bit kilobytes, or megabytes if M is also used.

See also individual keywords for selecting display granularity: TRK, KTR, POS, 8KB, 9KB, 8MB, 9MB.

If FUSION is used and MHFS is configured, then, depending on FUSION settings, local drive names will have a white or gray background and shared drives will have a cyan background. If FUSION is not used, you will need the U option to display the status and directory of individual drives.

MSD is able to detect and use terminal sizes larger than the standard 24x80.

MSD's end lines will differ depending on the system's MSALL$ revision number, which is displayed in the header line as r3, r4, ...

- If less than 4, MSD will display the available tracks for all selected drives, fixed/removable, local/shared; and list all drive statuses encountered.

- If 4 or higher, MSD will display both the available and total tracks for all selected drives, the available/total percent, the physical/logical drive count based on unit duplexing, and the status count for each type of drive (FIX/REM, LOC/SHR).

While there are 7 ways of displaying track counts for individual drives, the end line totals will always display either tracks (default, KTR, K option, TKD/K, POS), 8-bit kilobytes (TKD/8[M], 8KB, 8MB), or 9-bit kilobytes (TKD/9[M], 9KB, 9MB). However, the TKD parameter U can be used to force them to be in the same units as individual drives.

The TKD parameter X will omit all end lines.

The end lines can display totals in the billions, trillions, or more. Depending on the sizes of the numbers and the terminal width, the display may be adjusted to fit, such as by editing numbers without commas.

A - Include NA drives. If the F option is used, include RV & DN drives.

B - Use batch width (132 characters) if in batch or breakpointed mode, or if output is being directed to an alternate file by the PRT parameter. See also the COL/cc parameter to specify output width.

C - Compact list. If no other options or parameters, will display only drive names. The A option will be assumed so all drives will be shown.

The C option triggers a different display mode than usual and affects some other options when used in combination with it:

CT  - Display each drive's LDAT index.

CTQ - Also display each drive's channel type.

CG  - Display assign counts for each drive with a non-zero count. Since fixed drives always have an assign count of 1, will assume R if neither F nor R option set. Will sort by descending assign count unless I option used.

CGZ - Same as CG, but include drives with 0 assign count.

D - Exclude downed (DN) drives.

E - Unconditionally exclude packids. In the absence of this option, certain other options or parameters will trigger the display of packids: the options R without F, I, AK; the parameters PAK, PKM, PKL.

F - Show fixed drives only. If used with R, list fixed drives first.

G - Show each drive's granularity, i.e., prep factor. If all drives displayed have the same prep factor, this will be indicated by a message at the bottom of the display. If there are two or more prep factors, each drive name will be preceded by a prep factor code; and there will be a message at the bottom of the display identifying each code.

HELP - Display a single-screen guide to MSD.

HJX - Unit Duplex display options. These govern how Unit Duplex drives will be displayed and flagged (DUPLX1=Primary, DUPLX2=Secondary):

None - DUPLX1 and DUPLX2 listed in MCT order with no flagging.

X - *DUPLX1, ^DUPLX2 flagged but listed in normal order.

JX - ^DUPLX2 immediately follows *DUPLX1.

J - *DUPLX1|^DUPLX2 on same line.

H - ^DUPLX2|*DUPLX1 on same line.

JH - *DUPLX1|^DUPLX2 and ^DUPLX2|*DUPLX1 will both appear.

Note that the J and H options require more space because every drive, whether UD or not, will take up space for two drive names.

I - Sort drives by packid.

K - Show track counts as kilotracks, rounded down to the nearest multiple of 1000. End line totals will still be shown as actual tracks unless the TKD U parameter is used.

L - Show LOCAL drives only.

M - Monitor loop. Updates a single screen every 10 seconds. For details and tuning, see MON parameter.

N - Do not use FUSION full screen mode.

O - Produce normal output when an alternate display parameter such as PRT, SNP, or SSG is used. Normally the use of such an alternate file suppresses the usual edited MSD output.

P - Display the packid of each drive. Assumed by R without F, I, PAK, or PKL. Also assumed if the EMPTY or USED parameter used.

Q - Show each drive's equipment type. If all drives displayed have the same equipment type, this will be indicated by a message at the bottom of the display. If there are two or more equipment types, each drive name will be preceded by an equipment type code; and there will be a message at the bottom of the display identifying each code.

R - Show removable drives only. If used with F, will put fixed drives first. Otherwise, will assume P option.

S - Show SHARED drives only.

T - Sort drives by descending available tracks.

U - Show each drive's status. The available tracks will be followed by U, S, R, D, N, or X. If FUSION is not being used and SHARED is configured, the status letter will be followed by L or S, for Local or Shared.

If the MSALL$ revision is 4 or more, the status letter will be preceded by "+" if the drive is prepped as DRS, "!" if it is the current system drive, or a space if it is neither.

V - Exclude reserved (RV) drives.

W - Use a wider format for the available and total tracks of individual drives by employing comma separation for numbers of 4 or more digits.

Y - Test display. Generate a test disk configuration consisting of all possible disk types and display most possible items. The X option is assumed to demonstrate unit duplex display. Add the parameter TKD/ATP to show available & total tracks, plus percent full.

Z - Exclude drives with 0 tracks, whether they be full, RV, DN ,or NA.

The processor call may include many parameters to modify MSD's display and behavior. The format of each parameter is KEYWORD/value, where KEYWORD identifies the parameter and value optionally sets it. Although the descriptions below may show KEYWORDs of any length, only the first 3 characters are checked.

Select drives connected to one or more channel types. Up to 8 may be listed.

Select only the specified drives. If more than drive is being selected, they may be listed in consecutive fields, preceded by a slash, without the need to repeat the DRV keyword. Precede DRV with "-" to exclude the named drives. DRIVE will also be accepted as the keyword.

A dollar sign ("$") may be used as a wild card to select drives that begin with or contain certain characters: DRV/ABC$$ could select ABC01, ABC02, etc.

Instead of listing drives on the @MSD call, an element or SDF file may be supplied that contains the list of drives. Up to 256 drives may be listed, one or more per image, separated by spaces, commas, or slashes.

Finally, a consecutive range of drives may be specified by following the first drive with a dash and the numeric portion of the last drive. Example:

DRV051-54 - Drives DRV051, DRV052, DRV053, and DRV054.

These different methods may be combined, both on the processor call and in a file/elt list:

@MSD DRV/ABC$$$,/PQR005-015,DRV,FILE.LST

Select only the specified packids. If more than packid is being selected, they may be listed in consecutive fields, preceded by a slash, without the need to repeat the PAK keyword. Precede PAK with "-" to exclude the named packids. PACK or PACKID will also be accepted for the keyword.

As with DRV, "$" may be used as a wild card, a file.elt list may be supplied, or a consecutive range may be specified.

Select drives residing on one or more equipment types. Up to 8 may be listed.

Include a drive only if it has no more than n available tracks.

Include a drive only if it has at least n available tracks. Both MAX and MIN may be used to select drives whose available tracks fall within a certain range. If a different display granularity is selected for individual drives, whether positions, kilobytes, or megabytes, the values for MAX and MIN must be in those measurements.

Include a drive only if it has no more than n total tracks.

Include a drive only if it has at least n total tracks. TMAX and TMIN operate the same as MAX and MIN for a drive's total tracks.

If TMAX or TMIN is used, the drive's total tracks will be selected for display unless the TKD parameter occurs after TMAX and TMIN, in which case the display will be determined by the TKD options.

These parameters enable selection of drives based on their percent available or full status (0-100), which may be specified as a minimum or maximum. Unlike other parameters, these must be spelled out in full; but the second and third keywords may occur in either order, as in PCTAVLMIN or PCTMINAVL.

A display of percent available or full will be forced unless the TKD parameter occurs after this one.

Include a drive only if its Sector 1 version is at least n.

Include a drive only if its MBT scale factor is at least n. Both S1V and MBT will force a display of the drive's Sector 1 version and MBT scale factor.

Select only drives that are empty (available tracks = total tracks), or in use. Drives with 0 total tracks (DN or NA status) are never included. These parameters are only meaningful with MSALL$ revision 4 or higher.

Select or exclude drives having one of the given statuses: UP, SU, RV, DN, NA, X1 (primary Unit Duplex), or X2 (secondary Unit Duplex).

Select or exclude drives based on whether they are prepped as DRS packs, or are on the current system drive. The U option will be forced.

Define the display width to be nn columns. Default: demand screen width, less 1 if FUSION not used. Range: 40-252. MSD will fit the display within this width; depending on the items chosen for display, the full nn columns may not always be used.

If FUSION is used, there will be no SOE at the beginning of each display line; if not, there will be, but the nn count does not include the SOE.

COL does not affect header and end lines.

Specify the length of the drive name field. Range: 0-6. Default: length of longest drive name selected. If 0, drive names will not be displayed.

Specify a mask that will define which characters of the drive name to display. An "X" denotes a character to display; a "-" denotes a character to omit. Example: DVM/XX--XX would cause drive DV1234 to be displayed as DV34.

Place MSD into a monitoring loop that will periodically update the screen. The drives selected for monitoring must fit on a single screen, including end lines. Monitoring can only be invoked in nonbreakpointed demand mode, with FUSION on.

The monitoring interval in seconds may be included. This defines how long to wait between each pass. Default: 10. Range: 10-300 (5 minutes).

At the end of each pass the bottom line will be updated with the relative change in tracks, if any, on all types of disk: fixed or removable, shared or local.

The monitor can be instructed to terminate if the number of drives selected ever reaches zero, by coding the parameter as MONZ instead of MON; or by entering the Z keyin described below.

A delta interval in minutes may also be specified. It must be a multiple of the monitoring interval. At the end of each delta interval the next to last line will be updated with the relative changes since the last delta. If a filename is supplied it will be @ASG,T and the delta info placed there; otherwise the default MSD$DEL will be used.

The bottom line of the display will always begin with these characters, with the cursor positioned afterwards:

->Monitor Pass n. XMIT=Quit;Frz;Z;n(m)

You may enter keyins here to affect monitoring and they will take effect on the next pass. If an invalid command or improper interval is entered, the bottom line will include "ERR>" on the next pass. Possible keyins:

Q - Quit. You may also press <Enter> to quit.

F - Freeze monitor. "Frz" will be replaced by "Rsm".

R - Resume frozen monitor.

Z - Quit (after one more pass) if the number of drives reaches zero. The "Z" in the prompt line will be replaced by "C".

C - Continue if the number of drives reaches zero. This will reverse the effect of "Z", and the "C" in the prompt will be replaced by "Z".

n(m) - Enter new monitoring (n) and/or delta (m) interval. This will also have the effect of resuming a frozen monitor.

Specify the length of the packid name field. Range: 0-6. Default: length of longest packid name selected. If 0, packids will not be displayed.

Specify a mask that will define which characters of the packid name to display. An "X" denotes a character to display; a "-" denotes a character to omit. Example: PKM/X--XXX would cause packid DBX035 to be displayed as D035.

These parameters provide a quick summary of mass storage totals without requiring other parameters:

SAT or FULL will always show the percentage of mass storage that is full.

AVL or AVAIL will always show the percentage available.

SUM or TOT will show either percentage full or available based on the tag TOTALFULL in the source.

Each parameter may be given other TKD arguments, such as 8, 9, E...

Examples: @MSD SUM --- @MSD TOT/8KE

The parameter ROL displays the total fixed mass storage and the current ROLOUT thresholds. It is equivalent to TKD/R, minus the removable totals.

Track Display Control. This parameter affects the content of the available tracks area of the display, as well as the end lines. One or more characters may be specified to trigger the following in the output display:

A - Show available tracks on drive. Default if TKD not used.

*T - Show total tracks on drive.

*1 - Show each pack's Sector 1 version and MBT scale factor.

*S - Sort drives by descending total (vs. available) tracks. Forces T character. Available tracks will be the minor field. If the I option or TKD/I character was set, packid will be the minor field.

*I - Sort drives by packid (equivalent to I option). If TKD/S, packid will be the minor field.

*R - ROLOUT threshold and current system percent (end lines).

*P - Show percent Full or Available for each drive. By default MSD will show the percent full, or saturated, for both individual drives and the end totals lines. See the D and E to toggle either or both of these.

*3-7 - May follow or replace P to define the character width of the percent field. Range: 3 ("12%") to 7 ("12.345%"). Default: 3.

*D - Toggle % display of individual drives between Full and Available.

*E - Toggle % display of end totals lines between Full and Available.

*V - Show percent available vs. full for individual drives.

*F - Show percent full vs. available for end line totals.
(V & F are earlier characters; D & E are preferred.)

U - Display track counts in end line totals in the same units used for individual drives.

*B - Use Basic (pre-MSALL$ revision 4) format for end lines; no totals or percentages.

W - Edit individual track counts with commas (equivalent to W option).

K - Display tracks as kilotracks, rounded down to the nearest multiple of 1000 (equivalent to K option or KTR keyword).

O - Display tracks as positions, the next lowest multiple of 64 tracks. Equivalent to POS keyword.

8 - Display tracks as 8-bit kilobytes. Equivalent to 8KB keyword.

9 - Display tracks as 9-bit kilobytes. Equivalent to 9KB keyword.

M - If used with 8 or 9, display tracks for individual drives as 8- or 9-bit megabytes, rounded down to nearest multiple of 1,000,000. End line totals will still show kilobytes unless U was used. Equivalent to 8MB or 9MB keyword.

8 and 9 are provided as a way of showing PC-style byte capacities based on how words are transferred from the 2200: either as 8-bit bytes (9 per double word) or 9-bit bytes (4 per word). The kilobyte count is rounded down to the nearest multiple of 1000.

N - May be used with 8, 9, K, or O to suppress any drive display and show only the totals lines, similar to TKD with no arguments. When 8|9|K|O is used, A is assumed unless T, P, or N is used.

X - Omit any end summary lines from the display.

* - Meaningful only if system running on MSALL$ Revision 4 or higher.

If TKD is not used, TKD/A is assumed. If TKD appears with no arguments, there will be no tracks display for drives. If in addition there is no other type of drive information requested (packids, status, etc.), there will be no drive display at all, only the totals lines.

Instead of using the more complicated TKD parameter, one of these keywords may used on the @MSD call to select the granularity or conversion factor for the display: Tracks (the default), Kilotracks, Positions, 8- or 9-bit Kilobytes or Megabytes.

The keyword may be followed by "/U" to specify that totals are to be in the same units as drives instead of the default tracks (POS, KTR) or kilobytes (8MB, 9MB), the same as using U with the TKD parameter.

Examples: @MSD POS ... @MSD 8KB/U

This section describes the generation of alternate output from MSD into alternate print files. The use of such files will normally suppress the usual edited MSD output unless the O option is used.

Redirect the MSD display to an alternate print file. If a filename is supplied it will be @ASG,T; if not, the default MSD$PRT will be used.

Snap the Unit Status Tables, LNIEs, and MSD's internal table to an alternate print file. If a filename is supplied it will be @ASG,T; otherwise the default MSD$SNP will be used. Both SNP and SNAP will be accepted as keywords. SNP is intended mainly for debugging.

Create an SGS file showing tracks, status, type, and other information for each drive. If a filename is supplied it will be @ASG,T; otherwise the default MSD$SGS will be used. (For compatibility with earlier levels the @USE name MSD$ will also be attached if the default filename is used.) The output SGS file may be used as input for the TST parameter described later. Note that SGS images may exceed 80 characters.

A 1-6-character SGS label may be included; otherwise the default MSD will be used.

For items that may be missing, such as Unit Duplex link or packid, a 1-6 character void string indicator such as "-NA-" or "<NONE>" may be supplied to use instead of the default ''''. It must conform to the syntax of a read key; i.e., any character except space, period, comma, slash, or semicolon. However, it should begin with "<" or "-" if it is to be input to MSD using the TST parameter.

Following the individual drive SGSs is a set of labelTOT SGSs showing the available and total (if Rev. 4) tracks for selected drives of all types (fixed/removable, local/shared) and the global totals for fixed drives. For MSALL$ Revision 4 the ROLOUT threshold and goal are also shown for that type.

Tracks counts for both drives and totals will reflect the granularity or conversion chosen for display, whether kilotracks, positions or 8/9-bit kilobytes or megabytes. This includes the ROLOUT threshold amount.

After the labelTOT SGSs come the labelSTAT SGSs, which show the status totals for all drive types.

Finally, there is the labelINF SGS, which shows the date, time, site, EXEC level, MSD level, SGS level (3 or 2), and MSALL$ Revision number.

Beginning with MSD level 3R1 the format of the first SGS field is changed to drive, equipment-type, channel-type, UDLink to accommodate the recent addition of channel-type. To generate the previous format, with the first three subfields in their original order (drive, equipment-type, UDLink, channel-type), code '2' as the level.

If the channel type cannot be obtained, it will show either "-NA-" or "*MCT:n", where n is the ER MCT$ status received when trying to find it.

SGF operates identically to SGS, except that variable information -- namely available tracks, LDAT, and assign count -- is set to 0 so that constant items that may have changed over time may be compared. In addition, the labelTOT SGSs are not generated. SGF and SGS are mutually exclusive.

Any two or more of the PRT, SNP, SGS and MON (Delta) files may combined into a single file, except that MON may not be used in the same call as PRT since by definition MON requires screen output. Combination is achieved by using file continuation notation for all files after the first. Example:

        @MSD  testfile.SGS,.SNP,.MON/30(5)

These parameters enable a user with the SSCONFIGMGR privilege to change the configured thresholds for ROLOUT start (STRT) and target availability goal (AVL). There are parameters for both STD and SHARED directories. Only the first two characters after STD or SHR are checked for ST or AV.

There are two formats, as shown in these examples:

@MSD STDST/nn.mm - a percentage, such as STDST/1.5 or STDST/10.34

@MSD STDAV/nnnnn - a fixed number of tracks, as in STDAV/500000. The tracks are converted to a percentage.

After the change, MSD will display the total fixed tracks and the current ROLOUT parameters. There will be a spec error if there is an invalid character or if a resulting percentage is out of the range of 0.01 - 50.00. ER CONFIG$ will return a 0400020 error if the goal percentage is not greater than the start percentage, so you may need to change them both at once:

@MSD STDSTRT/3.4,STDAV/7.0

@MSD SHRST/750000,SHRAVL/1500000

The track counts shown for the start and goal thresholds will be slightly less than those displayed in response to the MS keyin. The former represent the exact percentage, while the latter include extra space needed by the ROLOUT run, such as the directory snapshot.

Input a set of SGSs generated by means of the SGS parameter, perhaps from a different system. MSD's display will be based on these items rather than the resident system. Level may be 2 to indicate SGSs from MSD levels before 3R1 or generated with '2' as the SGS level. TEST will also be accepted as the keyword.

MSD can be made to run in permanent test mode by attaching the name MSDAUTOTEST$ to an SDF file created by a previous SGS MSD output. All subsequent calls to MSD will use data from this file without the need for the TST parameter. To revert to normal mode, @FREE,A MSDAUTOTEST$.