2 - create catalog.

Usage:

mme    gefsye
zero   CC,ARGLIST
zero   2,BUFFER

Where:

CC
is either zero or a courtesy call address.
ARGLIST
points to a list of arguments for this call. The format of this list is described below.
BUFFER
points to a buffer that can be used in this operation. This buffer should be 355 words long.

Description:

This version of MME GEFSYE creates a catalog with a given set of characteristics. The argument list indicated by ARGLIST has the form 

zero    RETURN_WORD,USERID
zero    CAT_NAME,PERMISSION
zero    OPTION,0
where
RETURN_WORD
points to two words where MME GEFSYE can return a status. MME GEFSYE will initialize these words to zeroes. When MME GEFSYE returns, the first word will contain 
Bit 0      -- 1 to indicate completion
    1-11   -- error code, or 0 for success
    18-35  -- pointer to additional error info
              (if any)
See "expl mme gefsye" for a list of common error codes. Other possible error codes are 
01  -- userid not in master catalog
USERID
points to two words containing the userid under which the program is operating (in BCD characters).
CAT_NAME
points to an area of memory containing the name of the catalog to be created. This consists of four word chunks: the first two words of each chunk gives a component of a pathname (first chunk the userid, next chunk the name of the first catalog, and so on); the last two words of each chunk gives a password. Each component name and password is given as 1-12 BCD characters, left-justified and padded on the right with blanks. If a component has no password, the password part of the chunk is all blanks.

The password part of the final chunk of the pathname (the catalog being created) may have a normal password or may have a special password block (as described later on).

After the last catalog name chunk comes a word containing the value -1.

PERMISSION
points to a word giving general attributes for the catalog.
Bits 0-11
give general permissions (four octal digits, as described in "expl mme gefsye").
Bit 30
if 1, WLOCK
Bit 32
if 1, NSAVE
Bit 35
if 1, SLOCK
OPTION
points into a buffer describing additional arguments for the catalog creation. Below we describe the bits of each word in the buffer. 
OPTION:
      Bit 5:  catalog should be assigned to
              removable structured disk pack
      18-35:  BCD device name (bit 5=0)
                   or
              bits 18-29 zero, 30-35 device code
              (see "expl mme gefsye") (bit 5=0)
                   or
              0 (no user specification, bit 5=1)
 
OPTION+1:
  Bits 0-35:  zero, if OPTION bit 5=0
 
    or if OPTION bit 5=1
 
        0-5:  volume type code (see "expl mme
              gefsye")
       6-35:  BCD volume serial number (left-
              justified, blank-filled)
Beginning at OPTION+2, there are triplets of words indicating specific permissions for the catalog being created. The first two words of each triplet give the BCD userid receiving the permission. The last word has the general permissions code in Bits 0-11 (see "expl mme gefsye"). Bit 17 should be on if this EXCLUDEs permission. Other bits are reserved.

The final triplet is followed by a word containing -1.

Special Password Block

A special password block is two words long. It appears in the password part of the final chunk of a pathname. It has the form 

zero    N,-1
zero    LIST,0
where LIST points to a list of password descriptors and N is the number of descriptors in the list. Each descriptor is four words long. The first two words give a password as 1-12 BCD characters, left-justified and padded with blanks. The next word gives a time when the password starts to apply, and the last gives a time when the password should stop applying. This lets you create passwords that are only in effect at certain times of the day. Times are given as a certain number of "ticks" after midnight, where each tick is 1/64,000 of a second.

See Also:

expl access

expl access permissions

Copyright © 2000, Thinkage Ltd.