5 - access random cataloged file.

Usage:

mme     gemore
zero    5,BUFPTR
tra     FAIL_RTN

Where:

BUFPTR

points to the beginning a 355-word buffer allocated by the user in the user program.

FAIL_RTN

is the denail return -- see "expl mme gemore".

Q register

should hold the following values.

Bits 0-17

pointer to the qualified filename block (see below).

Bits 18-23

indicate access permissions, as listed below.

100000   -- Read
100001   -- Read/C
010000   -- Write
010001   -- Write/C
110000   -- Read/Write
110001   -- Read/Write/C
111000   -- Load
111100   -- Recovery
000001   -- Query
000010   -- Test
000011   -- Test/C
010100   -- Private

For complete details on these permissions, see the GCOS-8 OS File Management Supervisor manual.

Bits 24-35

is the file code that should be associated with the cataloged file.

Description:

This version of MME GEMORE accesses a cataloged file and associates it with the file code given in the Q register. The file will always be accessed in random mode, regardless of the mode in which the file was created. A $USERID statement must appear in the job stream before any activity executing this version of MME GEMORE.

The pathname of the cataloged file is given in a "qualified filename block". This block consists of a sequence of four-word components, one for each part of the pathname. The first two words of each block component specify the part of the pathname (i.e. the name of a file or catalog), 1-12 BCD characters, left-justified with trailing blanks. The last two words of each component contain any password associated with the file or catalog, again 1-12 BCD characters, left-justified with trailing blanks.

If the first word of the qualified filename block is -1 (all 1-bits), FMS will replace it with the user master catalog name from .SUID. This is compatible with TSS's DRL FILACT capability.

The last component in the qualified filename block should be followed by a word containing the decimal value -1 (all 1-bits). This is called the "fence".

The buffer indicated by BUFPTR is used by the FMS routines to hold catalog descriptors during FMS processing. The contents of this buffer are overwritten before returning to the user program to maintain file system security. However, if an error occurs, the buffer will contain the appropriate FMS error message in two locations when MME GEMORE returns:

Word 43: marks the beginning of the FMS return message.
Word 37: contains the (absolute) address of word 43 in its upper half and the length of the FMS return message (in bits) in its lower half.
Word 1: marks the beginning of a duplicate copy of the FMS return message. (This duplication is an ease-of-use feature for new program development.)
Word 0: contains the (absolute) address of word 1 in its upper half and the length of the duplicate FMS return message (in bits) in its lower half.

5 - access random cataloged file.

Usage:

Where:

Description:

See Also: