Retro1.org codex

ACCESS                                                    CMS Transient command

Use the ACCESS command to identify a disk to CMS, establish a filemode letter
for the files on the disk, and set up a file directory in storage.  The
specifications you make with the ACCESS command determine the entries in the
user file directory.  The format of the ACCESS command is:
+----------+------------------------------------------------------------------+
| ACcess   | 191 cuu  A|mode[/ext [*|fn [*|ft [*|fm]]]] [(options...[)]]      |
|          | options:                                                         |
|          | ERASE    MODE0    NODISK   NOPROF                                |
+----------+------------------------------------------------------------------+
where:

cuu      makes available the disk at the specified virtual device address.  The
         default value is 191.  Valid addresses are 001 through 5FF for a
         virtual machine in basic control mode, and 001 through FFF for a
         virtual machine in extended control mode.

mode     assigns a one-character filemode letter to all files on the disk being
         accessed.  This field must be specified if cuu is specified.  The
         default value is A.

ext      indicates the mode of the parent disk.  Files on the disk being
         accessed (cuu) are logically associated with files on the parent disk;
         the disk at cuu is considered a read-only extension.  A parent disk
         must be accessed in the search before the extension. A blank must not
         precede or follow the slash (/).

fn [ft [fm]]
         defines a subset of the files on the specified disk.  Only the
         specified files are included in the user file directory and only
         those files can be read.  An asterisk coded in any of these fields
         indicates all filenames, filetypes, or filemode numbers (except 0) are
         to be included.  (See Usage Notes 3 and 4.)

Options:

ERASE    specifies that you want to erase all of the files on the specified
         disk.  This option is only valid for read/write disks.  (See Usage
         Note 7.)

MODE0    makes mode 0 files visible on a read only disk. Normally they are
         hidden.

NODISK   lets you gain access to the CMS operating system with no disks
         accessed by CMS except the system disk (S-disk) and its extensions.
         This option is only valid if the ACCESS command is the first command
         you enter after you IPL CMS.

NOPROF   suppresses execution of a PROFILE EXEC file.  This option is valid
         only if the ACCESS command is the first command entered after you IPL
         CMS.  On subsequent ACCESS commands, the NOPROF option is ignored.


Usage Notes:

1.  If you have defined disk addresses 190, 191, 192, and 19E in the VM/370
    directory, or if they are defined before you IPL CMS, these disks are
    accessed as the S-, A-, D-, and Y-disks respectively.  Following an IPL of
    CMS, you must issue explicit ACCESS commands to access other disks.
    Ordinarily, you have access only to files with a filemode number of 2 on
    the system disk, or S-disk.  Note that you cannot specify a filemode of S
    with the ACCESS command.

2.  Associated with each CMS disk is a file directory, which contains an entry
    for only those CMS files on the disk to which you have access.  If you use
    the CP LINK command to link to a new minidisk, issue an ACCESS command each
    time.  Do this so that you obtain the appropriate file directory.

3.  The filename, filetype, and filemode fields can only be specified for disks
    that are accessed as read-only extensions.  Also, requesting a subset of
    files creates a file directory in your virtual machine.  For example:
        access 195 b/a * assemble
    gives you read-only access to all the files with a filetype of ASSEMBLE on
    the disk at virtual address 195, and the file directory information is
    stored in your virtual machine.  The command:
        access 190 z/a * * z1
    gives you access to all files on the system disk (190) that have a filemode
    number of 1.  When you access any disk in read-only status, files with a
    filemode number of 0 are not accessed, unless the MODE0 option is
    specified.

4.  You can also identify a set of files on a disk by referring to a filename
    or filetype prefix.  For example:
        access 192 c/a abc*
    accesses only those files in the disk at virtual address 192 whose
    filenames begin with the characters ABC.  The command:
        access 192 c/a * a* c2
    gives you access to all files whose filetypes begin with an A and that have
    a filemode number of 2.

5.  You can force a read/write disk into read-only status by accessing it as an
    extension of another disk or of itself; for example:
        access 191 a/a
    forces your A-disk into read-only status.

6.  When a disk is made a read-only extension of another disk, commands that
    typically require or allow you to specify a filemode may search extensions
    of the specified disk.  The exceptions to this are the LISTFILE and DISK
    DUMP commands.

7.  If you enter the ERASE option by mistake, you can recover from the error as
    long as you have not yet written any new files onto the disk.  (That is,
    you have not yet caused CMS to rewrite the file directory.)  Reissue the
    ACCESS command without the ERASE option.

8.  You should never attempt to access a disk in read/write status if another
    user already has it in read/write status; the results are always bad.

9.  When accessing OS and DOS disks:
    a.  You cannot specify filename, filetype and filemode when you access OS
        or DOS disks, nor can you specify any options.
    b.  In order to see OS and DOS disks, you must have a read/write CMS A-disk
        available if you are going to use the LOAD command with the MAP option.

10. To free an accessed disk, refer to the CMS RELEASE command.

Responses:

DMSACC723I    mode [cuu] <R/O R/W> [-OS -DOS]
    If the specified disk is a CMS disk, this message is displayed if the disk
    is read-only.  If the disk is in OS or DOS format, the message indicates
    the format, as well as whether it is a read/write or read-only disk.

DMSACC724I    cuu1 REPLACES mode (cuu2)
    Before execution of the command, the disk represented by cuu2 was the
    'mode' disk.  The disk cuu1 is now assigned that filemode letter.  This
    message is followed by message DMSACC726I.

DMSACC725I    cuu ALSO = mode [-OS -DOS] DISK
    The disk specified by cuu is the 'mode' disk and an ACCESS command was
    issued to assign it another filemode letter.

DMSACC726I    cuu mode RELEASED
    The disk being accessed at virtual address cuu as a read/write disk is
    already accessed at a different mode.  It is released from that mode.  Or,
    a disk currently accessed at mode is being replaced.