Skip to content

Commit

Permalink
Created branch to hold help files.
Browse files Browse the repository at this point in the history
Changes improve consistency among documents.
  • Loading branch information
marXtevens committed Jan 23, 2022
1 parent 69d33c4 commit a84e10c
Show file tree
Hide file tree
Showing 22 changed files with 5,584 additions and 0 deletions.
11 changes: 11 additions & 0 deletions .project
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
<?xml version="1.0" encoding="UTF-8"?>
<projectDescription>
<name>vm370</name>
<comment></comment>
<projects>
</projects>
<buildSpec>
</buildSpec>
<natures>
</natures>
</projectDescription>
23 changes: 23 additions & 0 deletions BASIC.HELPCMD.D1
Original file line number Diff line number Diff line change
@@ -0,0 +1,23 @@
BASIC CMS Command

Acronym for Beginners' All-purpose Symbolic Instruction Code, runs CALL-OS
BASIC as supplied with VM/370 R1.
+----------+-----------------------------------------------------------------+
| BASIC | fn [( <LONG> [)] |
+----------+-----------------------------------------------------------------+
where:

fn Is the filename of the file to be run. It must have a filetype
of BASIC.

option:

LONG Tells BASIC to use LONG form numbers.

For more details see

GC20-1803-1 VM370 BASIC Language Reference Manual Rel 1

which may be downloaded from BITSAVERS in the folder

http://bitsavers.org/pdf/ibm/370/VM_370/Release_1/
81 changes: 81 additions & 0 deletions BLOCKTAP.HELPCMD.D1
Original file line number Diff line number Diff line change
@@ -0,0 +1,81 @@
BLOCKTAP Nucles Extension

Trap TAPEIO calls and change the blocksize to 32k (approx). This was written
expressly to improve the functions of VMFPLC2 and TAPE. There are sequences of
I/O operations which are probably NOT handled correctly by this routine but it
should work correctly for all sequences generated by VMFPLC2 and TAPE. Tapes
created withOUT BLOCKTAP will be readable with BLOCKTAP ON.
+----------+------------------------------------------------------------------+
| BLOCKTAP | ON|OFF|Q|CLOSE [(options...[)]] |
| | options: |
| | BLOCK|NOBLOCK TYPE|NOTYPE TAP1|TAPi|181|cuu |
| | Default Options: TAP1 BLOCK TYPE |
+----------+------------------------------------------------------------------+

where:

ON installs the nucleus extension (unless already installed) and turns it
ON for the specified (or defaulted) device.

OFF turns it OFF for the specified (or defaulted) device and removes the
nucleus extension if no devices are still ON. It performs the CLOSE
and Q functions before extracting itself.

CLOSE performs any necessary tape operations to insure that the physical
tape reflects the commands which have been buffered. The buffer is
empty after this operation. It performs the Q function after closing.

Q gives statistics for output operations. Included are the number of
bytes, gaps and tape marks written. Also, the length of tape written
in feet. (Both virtual (what would have been written without BLOCKTAP)
and real (what was actually written to the tape) are reported.

Options:

TAPn 18n specifies the symbolic tape identification (TAPn) or the actual device
address of the tape to be read from or written to, where n is 0 to F,
corresponding to devices (cuu) 180-187 and 288-28F. The default is
TAP1 or 181. The unit specified by cuu must previously have been
attached to your CMS virtual machine before any tape I/O operation can
be attempted.

NOBLOCK specifies that the output tape blocksize is NOT to be altered. This
option will optimize tape movement and eliminate the extra gaps
produced by superfluous tape marks and subsequent re-positioning of
the tape. Tapes created with this option will be readable without
BLOCKTAP.

Options BLOCK and NOBLOCK may be specified ONLY with the ON function.

TYPE specifies that statistics are to be given on the CLOSE and OFF
functions.

NOTYPE specifies that statistics are NOT to be given on the CLOSE and OFF
functions. The confirmation messages on the ON function are also
suppressed. This option has NO effect on the Q function.

The TYPE/NOTYPE setting is preserved for the specified device until
changed (by specifying the opposite setting).

This command installs a Nucleus Extension for the TAPEIO function. The nucleus
extension buffers I/O requests and causes the tape to be written in standard OS
VariableBlocked format. Each record in this format is one TAPEIO request. A
block is written to tape ONLY when addition of data to it would cause it to
exceed 32760 bytes. It is also written if an ERG, SENSE, REW or RUN command is
given.

Note that WTM, BSF, FSR and BSR commands are buffered. This saves tape when the
"standard" CMS command sequence of "write the file, WTM, WTM, BSF, BSF" is
issued over and over again ... because the superfluous tape marks are NOT
written.

The user must NOT re-position the tape with any CP commands while BLOCKTAP is
ON because the last few commands are probably still in the buffer and were NOT
written to the tape!!!

NO warrantee of ANY kind is either expressed or implied by the author or
Brigham Young University.

Author: Steven C. Howes Brigham Young University
Version: 1
Date: 11 May 1987
29 changes: 29 additions & 0 deletions COBOL.HELPCMD.D1
Original file line number Diff line number Diff line change
@@ -0,0 +1,29 @@
COBOL CMS EXEC

Use the COBOL exec to compile COBOL programs using the OS MVT/MFT Cobol V3
compiler described in GC28-6399 which may be downloaded from www.bitsavers.org.

The format of the COBOL command is

+------------+----------------------------------------------------------------+
| COBOL | filename |
+------------+----------------------------------------------------------------+

where:

filename Is the name of a file with filetype COBOL and fixed length 80 byte
records.

Options:

The command does not accept any options but passes the following options to
the COBOL compiler:

Notes:

1. The compiler outputs two files "filename TEXT" containing the generated
object code, and "filename LISTING" which contains the compiler listing
including diagnostic messages.

2. The COBOL runtime is contained in "COB360 TXTLIB Y". Issue a GLOBAL TXTLIB
referencing this file before loading a cobol program.
Loading

0 comments on commit a84e10c

Please sign in to comment.