ADD

. ADD --------

- MDISK-----Userid Vaddr Label Cyl Type Volser Size Mode ----------[RPASS password [WPASS password [MPASS password]]] ----------SFSDir DLINK-----Userid1 Userid2 Vaddr LinkAs Mode IGNORE----Userid SAFADMIN--{[USER] Userid } ----------{ACIGROUP Acigroup}

Purpose

Use the ADD command to add records to the SafeAccess database.

Authorization

SAFADMIN authorization.

Subcommands

MDISK	Adds a minidisk to SafeAccess database
DLINK	Adds a directory link to SafeAccess database
IGNORE	Adds userid to Ignore to SafeAccess database
SAFADMIN	Gives SafeAccess SAFADMIN authorization to userid

Parameters

MDISK

Adds a minidisk to the SafeAccess database. This tells SafeAccess to intercept access attempts to this minidisk and reroute them to the SFS directory specified.

Userid Vaddr Label M M M Cyl Type Volser Size Mode RPASS Password WPASS Password MPASS Password SFSDIR

Userid you are adding minidisk to Virtual address of minidisk being added CMS Label for minidisk. Notes: Embedded blanks must be specified as "\b" Slashes must be specified as "\\". For Example: Specify "AB\bC\\D" for a CMS Label of "AB C\D" Number of cylinders or FBA blocks from the CMS point of view Device type. CP Volser CP Size in cylinders or FBA blocks CP Linkmode Optional READ password Optional WRITE password Optional MULT password SFS directory that access attempts are rerouted to for minidisk being added.

DLINK

Adds a directory link to the SafeAccess database. SafeAccess will intercept LINK attempts to this virtual device and route them to SFS. It will also create the device when the user that owns it logs on.

Userid1 Userid2 Vaddr LinkAs Mode

Userid you are adding directory link to Userid of user that owns the target of the directory link Virtual address of target of directory link Virtual address of directory link being added CP Linkmode

IGNORE

Adds an Ignore record to the SafeAccess database. This causes SafeAccess to ignore all requests by this userid.

Userid

Userid to be ignored.

SAFADMIN

Adds a SAFADMIN record to the SafeAccess database. This provides a user or acigroup with SafeAccess SAFADMIN authorization.

USER Userid	Userid to be given authorization
ACIGROUP Acigroup	Acigroup to be given authorization

Return Codes

Return Code	Meaning
0	Request successful
8	Item already in database, command failed
16	Not authorized, command failed
100	Missing parameter, command failed
101	Invalid parameter, command failed
344	SafeAccess server not running, command failed

Usage Notes

1. The CMS Component does not have to be initialized on the virtual machine issuing the ADD command.



2. Changes take effect immediately; affecting CMS and CP commands issued after a record has been placed into the SafeAccess database. For example, any user that currently has a link to a minidisk added to the SafeAccess database would continue to use the minidisk until they detach and re-link the device. To prevent some users from using the real minidisk and some users from using the SFS directory ensure that no users have a link to minidisk when it is added to the SafeAccess database.



3. ADD DLINK allows you to add a DLINK record that specifies a non-existent MDISK; however, users will not be able to link to the DLINK until the MDISK is added.



4. IGNORE applies to the issuer of CP commands. For example, IGNORE MAINT will cause MAINT to always and only link to real minidisks; links to MAINT minidisks by other users will still be subject to the contents of the SafeAccess database.

1. SAFEACC ADD MDISK JOHN 291 JOH291 3 3380 HALVOL 30 MR SACFP:JOHN.MD291
   This command adds an MDISK record that will cause subsequent access attempts for JOHN 291 to be directed to SACFP:JOHN.MD291. Command information is as follows:
   CMS QUERY DISK
   Item Value
   LABEL JOH291
   CYL 3
   TYPE 3380
   CP QUERY VIRTUAL
   Item Value
   TYPE 3380
   VOLSER HALVOL
   SIZE 30 CYL (would be BLK if TYPE is FBA device)
   CP LOGON
   Device will be created with MR link
   CMS ACCESS
   Access attempts will be redirected to SACFP:JOHN.MD291
   



2. SAFEACC ADD DLINK MARY JOHN 291 1291 RR
   This command adds a DLINK record that causes links to MARY 1291 to resolve to JOHN 291. When MARY logs on, SafeAccess will simulate a link to JOHN 291 RR.